Niech AI w supporcie coś załatwia: akcje przez webhooki
Autor: Termi2 min czytania
Wiele pytań do supportu wymaga, żeby ktoś coś zrobił: sprawdził zamówienie, uruchomił backup, wysłał klucz jeszcze raz. AI, które umie tylko odpowiadać, przekazuje je człowiekowi. Akcje pozwalają FiveBotowi wywołać w tym celu twój własny adres HTTPS, na czacie Hollo na stronie i w ticketach na Discordzie, i odpisać tym, co odesłał twój serwer.
Przykład z FiveDocka
FiveDock, narzędzie do backupów i hostingu serwerów FiveM, ma FiveBota jako czat na swojej stronie. Zalogowany użytkownik pisze „zrób backup mojego serwera”. AI wie już, jakie serwery ma ten użytkownik, bo FiveDock przekazuje je przy otwarciu czatu, a jeśli jest ich kilka, pyta, o który chodzi. Potem pokazuje kartę z nazwą serwera i przyciskiem Wykonaj. Jedno kliknięcie, adres FiveDocka uruchamia backup, a czat odpisuje, że trwa.
Tak samo działa „czy mój serwer jest online?” albo „przywróć ekwipunek Kowalskiego z wczoraj”.
Jak zdefiniować akcję
W Ustawieniach, AI, Akcje dodasz ich do 10. Każda ma:
- nazwę i zdanie, kiedy jej używać;
- adres HTTPS, który FiveBot wywołuje;
- do pięciu pól z typem, na przykład nazwę serwera albo liczbę godzin, które AI uzupełnia z rozmowy;
- Uruchamiaj bez pytania, dla bezpiecznych odczytów, takich jak sprawdzenie statusu;
- przełącznik włącz/wyłącz.
Wyślij test wysyła przykładowe wywołanie i pokazuje kod odpowiedzi i czas. Strona pokazuje też ostatnie 10 wywołań.
Kto może uruchomić akcję
Akcje działają tylko dla osób, które FiveBot potrafi rozpoznać: odwiedzającego, którego twoja strona podpisała przy otwarciu czatu, albo osoby, która założyła ticket na Discordzie. Anonimowi odwiedzający i e-mail dostają odpowiedzi z bazy wiedzy i nic więcej.
AI sprawdza pola z typami, które ustawisz. Jeśli brakuje wartości, zadaje jedno krótkie pytanie i podaje możliwe odpowiedzi. Jeśli akcja nie działa bez pytania, klient dostaje kartę na czacie albo przyciski na Discordzie, z opcjami Wykonaj i Anuluj.
Co dostaje twój serwer
Żądanie POST z akcją, jej polami, użytkownikiem i ticketem, podpisane sekretem twojego workspace’u:
FiveBot-Signature: t=<unix time>,v1=<HMAC-SHA256 of t.body>
Na stronie ustawień jest fragment kodu w Node, który sprawdza podpis. FiveBot najpierw rozwiązuje adres i odrzuca sieci prywatne i lokalne, nie idzie za przekierowaniami, czeka najwyżej 10 sekund i czyta do 16 KB odpowiedzi. Odpowiedź traktuje jako dane, więc tekst w niej nie da AI nowych poleceń.
Koszt
Każde wywołanie kosztuje jeden kredyt AI ponad samą odpowiedź i widać je jako Akcje w historii kredytów. Każde wywołanie trafia do logu z wynikiem.
Najczęstsze pytania
Jakiego planu potrzebuję?
Pro albo Network. Ceny są na fivebot.ai/pricing.
Czy klient może oszukać AI, żeby zadziałało za kogoś innego?
FiveBot bierze użytkownika z podpisu, który utworzyła twoja strona, albo z konta Discord, które założyło ticket, a twój serwer dostaje tę tożsamość przy każdym wywołaniu. Dane, które wyglądają na próbę wydania AI poleceń, są odrzucane.
Jak moja strona podpisuje odwiedzającego?
Twój backend podpisuje odwiedzającego sekretem tożsamości Hollo i przekazuje wynik do FiveBot.identify. Więcej o Hollo.
Czym to się różni od akcji asystenta?
Akcje asystenta są dla ciebie i twojej administracji i odpalają zdarzenia albo komendy na serwerze FiveM. Akcje przez webhooki są dla twoich klientów i wywołują dowolny adres HTTPS, który utrzymujesz. Akcje asystenta.