Stan integracji¶
Strona Integracje w aplikacji System pokazuje w jednym miejscu usługi, z którymi łączy się Navigator365, oraz to, czy każda z nich działa. Skorzystaj z niej po wdrożeniu, po zmianie konfiguracji i wtedy, gdy funkcja zależna od zewnętrznej usługi przestaje działać.
Stronę widzi tylko administrator aplikacji System. Rodzaje administratorów opisują Uprawnienia.
Jak sprawdzić stan integracji¶
- Przejdź do aplikacji System.
- Otwórz jej Konfigurację i wybierz Integracje.
- Poczekaj na zakończenie sprawdzania. System łączy się wtedy z każdą usługą po kolei, więc może to potrwać kilkanaście sekund.
- Po zmianie konfiguracji albo naprawie usługi kliknij Sprawdź ponownie.
Dla każdej integracji lista pokazuje nazwę, status, wersję usługi i szczegóły. Wersja jest widoczna tylko wtedy, gdy usługa ją podaje. Integracje są podzielone na grupy: platforma, wyszukiwanie, AI, usługi zewnętrzne i połączenia REST. W każdej grupie są ułożone alfabetycznie.
Znaczenie statusów¶
| Status | Znaczenie |
|---|---|
| OK | Integracja działa. |
| Wymaga uwagi | Integracja działa tylko częściowo, np. jedno z kilku kont pocztowych nie łączy się z serwerem. |
| Niepełna konfiguracja | Część wymaganych ustawień integracji jest pusta, np. podano adres usługi bez klucza API. Uzupełnij brakujące ustawienia wskazane w szczegółach. |
| Błąd | Integracja jest skonfigurowana, ale nie działa: usługa nie odpowiada albo odrzuca dane logowania. Dotyczy to także ustawień wypełnionych błędną wartością. |
| Nie skonfigurowano | Opcjonalna integracja nie została włączona. Jeśli nie korzystasz z tej funkcji, nie musisz nic robić. |
| Nieznany | Integracja jest skonfigurowana, ale system nie ma jak jej sprawdzić. Dotyczy połączeń REST bez ustawionego HealthPath. |
Kolumna Szczegóły podaje przyczynę statusu innego niż OK. Komunikat jest techniczny i w języku angielskim; często zawiera odpowiedź samej usługi, np. kod HTTP albo błąd serwera pocztowego.
Sprawdzane integracje¶
| Integracja | Co sprawdza system | Gdzie ją skonfigurować |
|---|---|---|
| Połączenie z bazą tylko do odczytu | Połączenie z bazą danych na koncie tylko do odczytu. | Parametr ConnectionStrings__PostgreSQLReadOnly kontenera API. |
| Konta pocztowe | Dla każdego konta: odczytanie zapisanego hasła oraz logowanie do serwera IMAP i SMTP. | Konta pocztowe. |
| OpenSearch | Połączenie z OpenSearch i gotowość indeksu dokumentów. | OpenSearchSettings. |
| OpenSearch – dzielenie tekstu na fragmenty | Próbne podzielenie krótkiego tekstu przez serwis z ChunkingUri. |
OpenSearchSettings. |
| OpenSearch – wyszukiwanie semantyczne | Próbne wygenerowanie wektora dla krótkiego tekstu przez serwis z EmbeddingsUri. W kolumnie wersji widać nazwę modelu, z którego korzysta serwis. |
OpenSearchSettings. |
| Serwis Python | Odpowiedź serwisu wykonującego skrypty akcji Wykonaj Python. | PythonExecution. |
| Usługa aktualizacji aplikacji | Pobranie listy dostępnych wersji, co potwierdza połączenie i klucz API. | StackManagement. |
| DocuSign | Kompletność ustawień, uwierzytelnienie i dostęp do konta DocuSign. | Konfiguracja podpisu DocuSign. |
| Microsoft 365 – token globalny | Pobranie tokenu dostępu na podstawie globalnego tokenu. | Ustawienia logowania, grupa Globalny token. |
| Modele AI | Kompletność konfiguracji modeli. Połączenie z dostawcą modelu nie jest sprawdzane. | Ustawienia AI. |
| Serwis AI – OCR i przechwytywanie danych | Odpowiedź serwisu pod adresem z pola Adres URL do API AI. | Ustawienia AI. |
| Serwis AI – przechwytywanie danych z pomocą AI | Odpowiedź serwisu pod adresem AIDataCaptureUri, używanego przez akcję Przechwyć dane z pomocą AI. |
AISettings. |
| Połączenia REST | Dla każdego połączenia z ustawionym HealthPath: odpowiedź endpointu stanu usługi. |
RestConnections. |
Serwis Python, oba serwisy AI i połączenia REST są sprawdzane przez wywołanie ich endpointu stanu (/health). Usługa jest uznawana za sprawną, jeśli odpowie kodem 2xx w ciągu 5 sekund. Jeśli w odpowiedzi jest pole version, jego wartość trafia do kolumny wersji.
O czym warto pamiętać¶
- Sprawdzenie wykonuje prawdziwe połączenia. System loguje się do każdego konta pocztowego i wysyła krótki tekst do serwisów OpenSearch.
- Każda integracja ma 10 sekund. Po tym czasie dostaje status Błąd z informacją, że sprawdzenie nie zakończyło się w wyznaczonym czasie.
- Nieznaleziony host to także błąd. Komunikat o nieznalezionym hoście oznacza, że usługa nie jest wdrożona albo jej kontener nie działa. Jeśli usługi celowo nie ma, usuń jej adres z konfiguracji: serwis Python i serwisy AI dostaną status Nie skonfigurowano, a usunięte połączenie REST zniknie z listy.
- Lista połączeń REST jest ustalana przy starcie API. Nowe połączenie pojawi się na stronie po ponownym uruchomieniu API.
Strona Integracje a endpoint /health¶
Endpoint /health API służy do sprawdzania gotowości kontenera, np. w definicji healthcheck w Docker Compose. Jest dostępny bez logowania, sprawdza wyłącznie połączenie z główną bazą danych i zwraca Healthy z kodem 200 albo Unhealthy z kodem 503.
Stanu integracji /health nie zawiera. Niedziałająca usługa zewnętrzna nie wpływa więc na gotowość kontenera API; jej stan widać tylko na stronie Integracje.