8 min czytania

Jak połączyć agenta z Waszym systemem przez API

To krok, który zwykle odróżnia efektowne demo od wdrożenia, z którego ktoś korzysta. Agent bez dostępu do Waszych danych może być tylko elokwentny.

Ma sens, gdy

Systemy z API i dokumentacją: CRM, magazyn, system zgłoszeń, kalendarz rezerwacji.

Odpuść, gdy

Systemy bez API, do których trzeba klikać przez przeglądarkę. Da się, ale każda zmiana interfejsu psuje automatyzację.

Czego potrzebujesz

HTTP RequestJSON TransformerWebhook TriggerCode Runner

Wszystkie z katalogu skilli, włączasz je w panelu agenta.

Krok po kroku

  1. 1

    Zacznij od jednego odczytu

    Nie projektuj pełnej integracji. Wybierz jedno zapytanie, na przykład sprawdzenie statusu zamówienia po numerze, i doprowadź je do końca. Jedno działające zapytanie uczy więcej o Waszym API niż tydzień planowania.

  2. 2

    Wydziel osobny klucz o wąskim zakresie

    Nie dawaj agentowi klucza administratora, nawet tymczasowo na testy, bo tymczasowe rozwiązania zostają. Utwórz osobny klucz tylko do odczytu i tylko do tych zasobów, które są potrzebne. Przy okazji w logach zobaczycie, co agent faktycznie robi.

  3. 3

    Opisz agentowi format odpowiedzi

    Podaj przykładową odpowiedź JSON z Waszego API i wyjaśnij, co znaczą pola. Agent radzi sobie z nieznanym formatem, ale gorzej niż z opisanym, a różnica widać zwłaszcza przy polach o niejasnych nazwach.

  4. 4

    Ustal zachowanie przy błędzie

    Napisz wprost, że przy nieudanym zapytaniu agent ma zgłosić problem, a nie odpowiedzieć na podstawie ogólnej wiedzy. To najczęstsze źródło odpowiedzi, które brzmią wiarygodnie i są nieprawdziwe.

  5. 5

    Dopiero na końcu rozważ zapis

    Odczyt jest bezpieczny, zapis nie. Zanim pozwolisz agentowi tworzyć albo zmieniać rekordy, ustaw akceptację przez człowieka przynajmniej na pierwsze tygodnie. Zmiana w systemie produkcyjnym to inna kategoria ryzyka niż zła odpowiedź na czacie.

Co psuje się najczęściej

Agent odpytuje API przy każdej wiadomości

Przy rozbudowanej rozmowie potrafi to nieźle obciążyć system. Napisz w promptcie, kiedy zapytanie jest potrzebne, a kiedy wystarczy odpowiedź na podstawie tego, co już pobrał.

Poufne pola trafiają do modelu

API zwraca zwykle więcej, niż potrzeba. Odfiltruj pola wrażliwe przed przekazaniem odpowiedzi agentowi, zamiast liczyć na to, że ich nie użyje.

Agent czytający internet ma też prawo zapisu w systemie

Rozdziel te role na dwa różne zestawy uprawnień. Treść na stronach internetowych bywa spreparowana tak, by wyglądała jak polecenie, więc łączenie tych dwóch zdolności to realne ryzyko, a nie teoria.

Częste pytania

Nasz system nie ma API. Co wtedy?+

Zostaje sterowanie przeglądarką, czyli logowanie i klikanie jak człowiek. Działa, ale jest kruche i każda zmiana wyglądu potrafi to zepsuć. Jeśli jest szansa na API, nawet ograniczone, zawsze warto poczekać na nie.

Czy agent nauczy się naszych danych na stałe?+

Nie. Za każdym razem pobiera aktualne dane z API i pracuje na nich w ramach jednej rozmowy. To akurat zaleta, bo odpowiedzi nie starzeją się razem z modelem.

Inne poradniki

Podstawy tłumaczymy od zera w bezpłatnym kursie.

Przetestuj to na własnym agencie

Uruchomienie zajmuje około minuty, a pierwsza subskrypcja ma 5 dni za darmo.

Zobacz plany