Akcja niestandardowa

Niestandardowe akcje API pozwalają agentowi na interakcję z usługami zewnętrznymi. Pobieraj dane w czasie rzeczywistym, przesyłaj formularze lub uruchamiaj przepływy pracy w innych narzędziach.

Tworzenie akcji niestandardowej API

1. Przejdź do zakładki Akcje swojego agenta
2. Kliknij Dodaj akcję → Akcja niestandardowa
3. Skonfiguruj wywołanie API:
   • Adres URL punktu końcowego - Punkt końcowy API, który ma zostać wywołany
   • Metoda HTTP - GET, POST, PUT, PATCH lub DELETE
   • Nagłówki - Uwierzytelnianie i typ zawartości
   • Treść żądania - Dane do wysłania (dla POST/PUT/PATCH)
4. Zapisz i przetestuj

Opcje konfiguracji

Adres URL punktu końcowego

Pełny adres URL punktu końcowego API:

https://api.yourservice.com/v1/data

Używaj wyłącznie punktów końcowych HTTPS. Punkty końcowe HTTP są blokowane ze względów bezpieczeństwa.

Metoda HTTP

Nagłówki

Dodaj nagłówki uwierzytelniania i typu zawartości:

Authorization: Bearer {{SECRET:service_api_key}}
Content-Type: application/json

Utwórz nazwany sekret osobno. Agentkit rozwiązuje {{SECRET:name}} tylko na serwerze. Odczyty akcji i dzienniki nigdy nie zawierają zapisanej wartości.

Źródło danych wejściowych

Dla pola tekstowego z jednym adresem e-mail wybierz zweryfikowany e-mail z pytaniem, gdy go brakuje. Agentkit używa zweryfikowanego kontaktu z czatu lub nadawcy wiadomości przychodzącej. Anonimowego gościa pyta o adres. Model nie może zastąpić zweryfikowanego adresu.

Treść żądania

Dla żądań POST/PUT zdefiniuj treść JSON z danymi, które chcesz wysłać.

Kiedy API jest wywoływane

AI decyduje, kiedy wywołać API, na podstawie kontekstu rozmowy i opisu akcji. Możesz sterować tym zachowaniem, podając jasny opis tego, kiedy akcja powinna się uruchamiać.

Obsługa odpowiedzi

Odpowiedź z powodzeniem

Gdy API zwróci odpowiedź pomyślnie (status 2xx):

• Wyświetl odwiedzającemu wiadomość o powodzeniu
• Uwzględnij dane odpowiedzi na czacie
• Wyzwól akcje następcze

Obsługa błędów

Gdy wywołanie API się nie powiedzie:

• Wyświetl przyjazny komunikat o błędzie
• Zaloguj błąd na potrzeby debugowania
• Opcjonalnie ponów żądanie

Przykładowe przypadki użycia

Sprawdzanie statusu zamówienia

Skonfiguruj punkt końcowy GET, aby pobierać dane zamówienia, gdy odwiedzający pytają o status swojego zamówienia.

Przesyłanie do CRM

Skonfiguruj punkt końcowy POST, aby wysyłać dane leadów do systemu CRM.

Pobieranie danych w czasie rzeczywistym

Skonfiguruj punkt końcowy GET, aby pobierać dane w czasie rzeczywistym (np. dostępność lub stan magazynowy) z Twoich systemów.

Zagadnienia bezpieczeństwa

Klucze API

• Przechowuj klucze API jako nazwane sekrety i odwołuj się do nich przez {{SECRET:name}}.
• Używaj kluczy przypisanych do konkretnego środowiska podczas testowania
• Rotuj klucze okresowo

Ograniczanie liczby żądań

• Zewnętrzne API mogą mieć limity liczby żądań
• Odpowiednio skonfiguruj ograniczanie liczby żądań dla swojego agenta
• Monitoruj wykorzystanie API w logach

Prywatność danych

• Wysyłaj tylko niezbędne dane
• W razie potrzeby upewnij się, że usługi zewnętrzne są zgodne z RODO
• Nie loguj wrażliwych danych z odpowiedzi

Limit czasu i ponowne próby

Testowanie akcji API

1. Skonfiguruj akcję z testowym punktem końcowym
2. Przejdź do Playground
3. Uruchom akcję z odpowiednimi danymi wejściowymi
4. Sprawdź odpowiedź na czacie
5. Przejrzyj logi w celu debugowania

Kolejne kroki

• Skonfiguruj webhooki dla niezawodnego dostarczania
• Połącz się z Zapier dla integracji bez kodu
• Zobacz dokumentację API dla przychodzących wywołań API