Integrations
Połączenie konta z zewnętrznymi systemami udostępnionymi przez organizację i korzystanie z nich w czacie.
Na tej stronie
AITEZA może korzystać z narzędzi systemów zewnętrznych za pomocą Model Context Protocol (MCP), np. aby sprawdzić coś w innej aplikacji biznesowej. Na stronie Integracje w sekcji Osobiste w Ustawieniach łączysz swoje konto z integracjami oferowanymi przez Twoją organizację.
Jak działają integracje
- Administratorzy organizacji zatwierdzają serwery MCP dla organizacji (zobacz Integracje organizacji).
- Łączysz się z zatwierdzonymi serwerami, które wymagają Twojego własnego logowania lub klucza. Robisz to na tej stronie.
- W czacie wybierasz dla każdej wiadomości, z których integracji AITEZA może korzystać (zobacz Korzystanie z integracji w czacie).
AITEZA korzysta z integracji tylko wtedy, gdy jest ona włączona dla danej wiadomości.
Strona Integracje
Strona wymienia serwery, które Twoja organizacja udostępniła Tobie: zatwierdzone dla całej organizacji oraz zatwierdzone dla jednej z Twoich grup. Każdy wiersz pokazuje ikonę serwera, jego nazwę i stan:
| Stan | Znaczenie |
|---|---|
| Dostępne dla wszystkich | Serwer nie wymaga własnego połączenia. Możesz go od razu włączyć w czacie. |
| Połączono | Masz połączenie. |
| Wygasło, połącz ponownie | Połączenie już nie działa. Wybierz Połącz ponownie. |
| Nie połączono | Nie masz jeszcze połączenia. Wybierz Połącz. |
Jeśli Twoja organizacja nie zatwierdziła jeszcze żadnego serwera, strona pokazuje „Brak integracji”.
Łączenie
Sposób łączenia zależy od tego, jak serwer Cię loguje. Administratorzy organizacji ustawiają to dla każdego serwera.
Osobiste logowanie: Połącz otwiera stronę logowania lub zgody usługi. Zaloguj się tam swoim kontem i potwierdź. AITEZA wraca następnie na stronę Integracje i pokazuje komunikat „Połączono z nazwa”.
Osobisty klucz: Połącz otwiera okno Połącz nazwa.
Łączenie za pomocą osobistego klucza
- 1
Utwórz w usłudze klucz API lub osobisty token dostępu.
- 2
W AITEZA wybierz Połącz obok serwera.
- 3
Wpisz klucz w polu Klucz lub token dostępu i potwierdź.
AITEZA sprawdza klucz w usłudze i zapisuje go w postaci zaszyfrowanej. Jeśli usługa go nie przyjmie, okno pokazuje „Usługa odrzuciła klucz.” Sprawdź klucz i jego uprawnienia w usłudze i spróbuj ponownie.
Wygasłe połączenia
Połączenie wygasa, gdy usługa przestaje akceptować Twój klucz lub logowanie, np. dlatego, że token został unieważniony lub stracił ważność. Wygasa także wtedy, gdy administrator zmieni ustawienia logowania serwera. Stan pokazuje wtedy Wygasło, połącz ponownie. Wybierz Połącz ponownie i zaloguj się jeszcze raz albo wpisz nowy klucz.
Rozłączanie
Rozłącz usuwa Twoje połączenie po potwierdzeniu. AITEZA nie może wtedy korzystać z tej integracji w Twoim imieniu, dopóki nie połączysz się ponownie.
Warto wiedzieć
- Integracje działają tylko z modelami obsługującymi tryb agenta. Przy innych modelach ikona wtyczki w czacie jest nieaktywna.
- Goście Relay nigdy nie korzystają z integracji.
- Każde wywołanie narzędzia integracji pojawia się w krokach wykonania wiadomości jako „Nazwa serwera: tytuł narzędzia”.
- AITEZA traktuje wyniki integracji jako niezaufane treści zewnętrzne. Z narzędzi, które zmieniają lub usuwają dane, AITEZA korzysta tylko wtedy, gdy wyraźnie o to poprosisz.
Korzystanie z integracji w czacie
Dzięki integracjom AITEZA może korzystać z narzędzi systemów zewnętrznych za pomocą Model Context Protocol (MCP). O tym, jakie integracje są oferowane, decydują administratorzy Twojej organizacji. Połączyć się z nimi możesz w Ustawienia > Integracje.
Włączanie integracji
- 1
Kliknij ikonę wtyczki obok przycisku + w polu wprowadzania czatu.
- 2
Zaznacz integracje, z których AITEZA ma korzystać. Lista pokazuje Twoje połączone integracje, każdą z ikoną jej usługi.
- 3
Wyślij wiadomość.
- Zaznaczone integracje dotyczą następnej wiadomości. Gdy wybrano integracje, ikona wtyczki jest kolorowa; jej podpowiedź pokazuje liczbę, np. „Integracje (2)”.
- Włączaj tylko to, czego potrzebujesz: każda integracja dodaje swoje narzędzia do kontekstu modelu.
- Nowy czat zaczyna się bez włączonej integracji. Istniejący czat przywraca wybór z ostatniej wiadomości.
- Zarządzaj integracjami na dole listy otwiera Ustawienia > Integracje. Jeśli nie połączono jeszcze żadnej integracji, lista pokazuje „Nie połączono jeszcze żadnej integracji.”
- Integracje pokazują ikonę swojej usługi w czacie, w Ustawienia > Integracje i na liście administratora: wbudowaną ikonę dla znanych usług, takich jak Microsoft OneDrive, SharePoint, Google Drive, Slack, GitHub, Linear, Notion czy Atlassian, w przeciwnym razie favicon strony, a w ostateczności symbol wtyczki.
- Jeśli wybrana integracja nie jest połączona lub jest nieosiągalna, AITEZA informuje o tym w odpowiedzi i wskazuje Ustawienia > Integracje.
- Integracje działają tylko z modelami obsługującymi tryb agenta. Przy innych modelach ikona wtyczki jest nieaktywna i pokazuje „Wybrany model nie może korzystać z integracji.”
- Zanim integracja zmieni dane (np. utworzy zgłoszenie lub prześle plik), AITEZA pyta w odpowiedzi: „Serwer chce wykonać „działanie”. Zezwolić?”. Szczegóły pokazują, co zostałoby wysłane. Wybierz Anuluj, Zezwól lub Zawsze zezwalaj; Zawsze zezwalaj pozwala na wszystkie działania tej integracji w tym czacie bez ponownego pytania. Działania, które tylko odczytują dane, są wykonywane bez pytania. Bez odpowiedzi w ciągu 4 minut działanie nie zostanie wykonane.
- Każde wywołanie narzędzia integracji pojawia się w krokach wykonania wiadomości jako „Nazwa serwera: tytuł narzędzia”.
