Połączenia API
Zmień dowolne API HTTP w funkcję, którą Twój agent może wywołać w trakcie rozmowy: wklej polecenie cURL, a kreator utworzy definicję narzędzia, parametry i uwierzytelnianie.
Połączenia API to niestandardowe funkcje HTTP, które Twoi agenci mogą wywoływać podczas
rozmowy — wyszukiwać zamówienie, tworzyć zgłoszenie, pobierać status konta
z własnego backendu. Punkt końcowy definiujesz raz w sekcji
Połączenia → API (/dashboard/api-connections); agenci z przypiętym
połączeniem mogą następnie wywoływać je zawsze, gdy wymaga tego rozmowa.
Możesz utworzyć połączenie na dwa sposoby: wkleić coś, co kreator może przeanalizować, albo skonfigurować je ręcznie.
Szybka ścieżka: wklej i przeanalizuj
- Kliknij Nowe połączenie API
Okno dialogowe otworzy się w kreatorze. Wklej do pola przykładowe polecenie cURL, specyfikację OpenAPI/Swagger, eksport z Postman, interfejs TypeScript lub schemat Zod.
- Kliknij Analizuj
ThunderPhone wywnioskuje całe połączenie na podstawie wklejonych danych — adres URL, metodę, nagłówki oraz schemat parametrów utworzony na podstawie znalezionych parametrów zapytania i treści żądania. Wklejone nagłówki (w tym nagłówki uwierzytelniania) zostaną przeniesione do konfiguracji punktu końcowego.
- Potwierdź wyróżnione pola
Wywnioskowana konfiguracja otworzy się z wyróżnionymi polami, które należy sprawdzić. Dostosuj nazwy, opisy i typy parametrów, aby agent rozumiał, kiedy i jak wywołać funkcję — opis jest tym, co odczytuje model.
- Zweryfikuj i zapisz
Zapisanie najpierw uruchamia rzeczywiste żądanie testowe do Twojego punktu końcowego. Jeśli żądanie się nie powiedzie, połączenie nie zostanie zapisane — popraw adres URL, nagłówki uwierzytelniania lub treść żądania i spróbuj ponownie. Po powodzeniu połączenie zostanie zapisane z oznaczeniem Zweryfikowano.
Jeśli kreator nie znajdzie adresu URL żądania we wklejonych danych, poinformuje Cię o tym —
uwzględnij pełny punkt końcowy http(s) i spróbuj ponownie.
Konfiguracja ręczna
Kliknij Skonfiguruj ręcznie → w kreatorze (lub Chcesz, aby AI to wywnioskowała? Wypróbuj kreator →, aby wrócić). Ręczny kreator ma dwa edytory:
- Wizualny — pola formularza dla nazwy wyświetlanej, nazwy funkcji, adresu
URL, metody (
POST,GET,PUT,PATCH,DELETE), niestandardowych nagłówków oraz schematu parametrów (Dodaj właściwość dla każdego argumentu, który agent może podać). - JSON — ta sama definicja jako surowy JSON, do wklejenia lub bezpośredniego dostrajania specyfikacji narzędzia.
Panel Żądanie testowe (opcjonalny) umożliwia wysłanie skonfigurowanego żądania przed zapisaniem oraz pokazuje status, opóźnienie i podgląd odpowiedzi. Zweryfikuj i zapisz zawsze uruchamia ten test i zapisuje tylko po powodzeniu.
Zarządzaj połączeniami
Każdy wiersz połączenia pokazuje jego status weryfikacji — Zweryfikowano, Nieprzetestowane lub Błąd — nazwę funkcji oraz agentów, którzy go używają. W menu działań wiersza możesz:
- Edytuj — ponownie otworzyć konfigurację.
- Klonuj — zduplikować połączenie jako punkt wyjścia (kopia ma status Nieprzetestowane).
- Historia wersji — wyświetlić wcześniejsze wersje i przywrócić jedną z nich w edytorze.
- Przenieś — skopiować lub przenieść połączenie do innej organizacji, do której należysz. Przeniesienie usuwa je tutaj; agenci, którzy go używali, mogą wymagać ponownej konfiguracji.
- Usuń — trwale; agenci używający połączenia będą wymagać ponownej konfiguracji.
Przypnij je do agenta
Dodaj połączenie do agenta w sekcji połączeń API kreatora (Tworzenie agenta). Lista pokazuje, którzy agenci używają każdego połączenia, dzięki czemu od razu wiesz, na co wpłynie zmiana.