Wiring Lab

W Wiring Lab łączysz personę z silnikiem. To połączenie nazywamy linkiem: — spina dokładnie jedną personę z jednym silnikiem, żeby silnik mówił głosem tej persony. Każdy link dostaje własny api_slug, czyli unikalny identyfikator tego konkretnego połączenia, dzięki czemu platforma zawsze wie, do której pary persona–silnik należy dane żądanie.

Żeby spiąć link:

Otwórz Wiring Lab i wybierz personę, którą chcesz uruchomić.
Przeciągnij silnik z biblioteki na płótno, żeby podpiąć go do tej persony.
Kliknij Zapisz (przycisk Zatwierdź połączenia), aby utrwalić link. Dopóki nie zatwierdzisz, połączenie nie jest zapisane.

Na jednym koncie możesz spiąć kilka linków persona–silnik. Każdy jest osobnym połączeniem z własnym api_slug.

Klucze API

Klucz API to sposób, w jaki zewnętrzny bot albo integracja uwierzytelnia się we FluidTalk. Są dwie drogi, żeby go utworzyć:

Utwórz: wygeneruj zwykły klucz obejmujący całe konto , niepowiązany jeszcze z żadną personą ani silnikiem.
Wygeneruj z przypisaniem: w jednym kroku utwórz klucz od razu przypisany do konkretnej persony i silnika . To droga zalecana , bo klucz z gotowym przypisaniem od razu może obsługiwać prawdziwy ruch.

Kluczami zarządzasz z poziomu Wiring Lab:

Podepnij / przypisz klucz: powiąż istniejący klucz obejmujący całe konto z personą i silnikiem (i ewentualnie zmień mu nazwę). Klucz bez przypisania nie obsłuży prawdziwych wywołań.
Lista: zobacz wszystkie klucze na koncie.
Unieważnij: usuń klucz, żeby nie dało się go już używać.

Uwaga

Sekret klucza API pokazujemy tylko raz, w momencie tworzenia. Skopiuj go wtedy i schowaj w bezpiecznym miejscu. Jeśli go zgubisz, nie zobaczysz go ponownie — po prostu unieważnij ten klucz i zrób nowy.

Uwaga

Zanim klucz obsłuży prawdziwy ruch, musi być przypisany do persony (i silnika). Klucz bez przypisania, obejmujący całe konto, jest odrzucany przy prawdziwych wywołaniach. Najpierw wygeneruj klucz z przypisaniem albo podepnij istniejący.

Lista kontrolna przed startem

Gdy wszystkie cztery punkty są spełnione, jesteś na produkcji:

Persona gotowa: tożsamość i zdjęcia ustawione.
Silnik podpięty: silnik spięty z tą personą i zatwierdzony w Wiring Lab.
Klucz API z przypisaniem: wygenerowany (albo podpięty) dokładnie do tej persony i tego silnika.
Skieruj bota na handshake: Twoja integracja wysyła każdą przychodzącą wiadomość na endpoint handshake, przekazując klucz w nagłówku X-API-Key . FluidTalk odpowiada kolejną wiadomością i tym, co należy zrobić.

Dokładne endpointy, pola żądań i odpowiedzi znajdziesz w dokumentacji API dla deweloperów.

Wskazówka

Nie musisz wchodzić na produkcję, żeby to wypróbować. Najpierw przepuść całą rozmowę przez wbudowany symulator (ten sam silnik, bez klucza i bez prawdziwego ruchu), a spinaj dopiero wtedy, gdy zachowuje się tak, jak chcesz.

Uwaga

Obsługa prawdziwych rozmów wymaga aktywnego płatnego planu. Konto darmowe albo wygasłe zostaje odrzucone przy handshake, więc Twój bot przestaje obsługiwać ruch w chwili zakończenia planu. Zobacz Płatności i plany.

Powiązane poradniki

Kreator silników: zaprojektuj rozmowę, zanim ją spniesz.
Testowanie w symulatorze: przejdź silnik od początku do końca bez klucza.
Dokumentacja API dla deweloperów: dokładne wywołania handshake i nagłówki.
Płatności i plany: co płatny plan odblokowuje przy obsłudze prawdziwego ruchu.