Większość chatbotów potrafi tylko rozmawiać. Zapytaj o cenę w swojej walucie, status zamówienia albo dzisiejszy kurs wymiany, a chatbot zgadnie albo powie, żeby sprawdzić to gdzie indziej. Agent AI, który wykonuje akcje, działa odwrotnie: wywołuje prawdziwe API w środku rozmowy, odczytuje wynik i odpowiada na jego podstawie.
Ten poradnik pokazuje, jak zbudować takiego agenta od pustego konta, bez kodu. Na końcu będziesz mieć agenta, który odpowiada na pytania na podstawie wiedzy, którą mu podasz, i wywołuje REST API na żywo podczas czatu. Zobaczysz też, jak dzieje się to w Inbox. Akcja, którą tutaj zbudujesz, to główny przepis: jedno opisane żądanie HTTP. Skieruj je na inny URL, a ten sam przepis zapisze leada do arkusza, doda wpis w CRM albo będzie moderować serwer czatu. Każdy poradnik integracji na końcu tego wpisu jest opracowanym przykładem tego przepisu.
Wszystko poniżej zostało zbudowane i przetestowane na prawdziwym agencie. Każda rozmowa i każde wywołanie API na zrzutach ekranu zostały wygenerowane przez realnie działającego agenta. Możesz odtworzyć każde z nich.
Co zbudujesz
Jednego agenta wsparcia dla fikcyjnego narzędzia do planowania projektów o nazwie Meridian. W około dziesięć minut zrobi on dwie rzeczy od początku do końca:
- Odpowie na podstawie wiedzy, którą mu podasz: plany, ceny i funkcje Meridian.
- Wywoła jedno API na żywo w trakcie rozmowy, aby przeliczyć cenę na walutę odwiedzającego, a potem użyje wyniku w odpowiedzi.
Akcja wywołuje Frankfurter, darmowe API kursów walut bez klucza, więc możesz przejść całość, mając tylko konto Quickchat i bez rejestrowania się gdziekolwiek indziej. Liczy się wzorzec, nie waluty: po zbudowaniu tej akcji zbudowałeś kształt każdej integracji.
Czego potrzebujesz:
- Darmowego konta Quickchat AI (zarejestruj się tutaj).
- Bez kodu, bez serwera, bez klucza API.
Czym jest agent AI i czym różni się od chatbota?
Chatbot odpowiada. Agent odpowiada i działa. W Quickchat budujesz agenta z trzech części.
Pierwsze dwie części tworzą chatbota. Trzecia, Actions, tworzy agenta.
- Identity określa, kim jest agent: jego nazwę, rolę i instrukcje. To jest AI Main Prompt.
- Knowledge określa, na podstawie czego odpowiada: twoje dokumenty, strony i fakty.
- Actions & MCPs określa, co może zrobić: wywołać API podczas rozmowy.
Pierwsze dwie części tworzą dobrego chatbota. Trzecia tworzy agenta. Ten wpis poświęca najwięcej miejsca trzeciej części.
Czym naprawdę jest AI Action
AI Action to opisane żądanie HTTP. Wypełniasz żądanie raz (metodę, URL i wartości do wysłania) oraz piszesz opis, kiedy go używać. Podczas rozmowy model decyduje, czy je wywołać, i uzupełnia części, które zostawiłeś otwarte. Quickchat wysyła żądanie, a model odczytuje odpowiedź.
Najprościej zrozumieć, dlaczego jest to niezawodne, dzieląc każdą wartość w żądaniu na dwa rodzaje.
Ustawiasz wartości deterministyczne, a model uzupełnia te wymagające oceny na podstawie czatu. Parametry są jedynymi wartościami, które musi poprawnie dobrać.
- Wartości deterministyczne to te, które ustawiasz: metoda, URL, waluta bazowa. Model nie może ich pomylić, bo nigdy ich nie dotyka.
- Wartości wymagające oceny to te, które model uzupełnia na podstawie rozmowy: o jaką walutę poprosił odwiedzający, którą cenę przeliczyć. To jedyne wartości, które wymagają jakiegokolwiek rozumowania, i jedyne, które dostrajasz.
Wartości wymagające oceny wstawiasz przez menu Add AI Data, które dodaje chip {{...}} do dowolnego pola. To menu oferuje dokładnie trzy rzeczy, które akcja może potrzebować pobrać:
- Parameters, które definiujesz (wartości wymagające oceny, które model uzupełnia, na przykład
{{currency}}). - Conversation metadata, które ustawia kanał (na przykład
{{conversation_channel}}lub{{metadata_visitor_email}}). - System Tokens: sekrety przechowywane i wstrzykiwane przez Quickchat, widoczne jako odznaka, nigdy nieprzekazywane modelowi.
Menu Add AI Data wstawia wartość jako chip: zdefiniowany parametr, wartość odwiedzającego lub rozmowy albo zmienną wbudowaną.
Wartości z metadanych rozmowy są gotowe do użycia bez proszenia o nie. Kilka, które warto znać:
| Variable | Co zawiera |
|---|---|
{{conversation_channel}} | Kanał, na którym odbywa się czat (widget, telegram, whatsapp i tak dalej) |
{{conversation_url}} | Link do tej konkretnej rozmowy w twoim Inbox |
{{language}}, {{country}} | Język i kraj odwiedzającego jako dwuliterowe kody |
{{metadata_visitor_email}} | Email odwiedzającego po tym, jak go udostępni |
{{scenario_id}}, {{conversation_id}} | Identyfikatory tego agenta i tej rozmowy |
Do tej akcji potrzebujesz tylko pierwszego rodzaju, parametrów. Pozostałe będą ważne, gdy podłączysz prawdziwą usługę. Poradniki HubSpot i Discord na końcu używają wszystkich trzech.
Krok 1: Utwórz agenta i dodaj mu wiedzę
Zarejestruj się i otwórz nowego agenta. Na stronie Identity ustaw AI Agent Name na Meridian i wklej poniższy tekst do AI Main Prompt. To zawsze dostępne pole promptu, które ma każdy plan. Nie potrzebujesz osobnej listy AI Guidelines.
Instrukcje agenta trafiają do zawsze dostępnego AI Main Prompt, a nie do osobnej listy AI Guidelines.
Jesteś asystentem wsparcia dla Meridian, narzędzia do planowania projektów dla zespołów produktowych. Odpowiadasz na pytania odwiedzających stronę Meridian o plany, ceny, funkcje i rozpoczęcie pracy.
Odpowiadaj na podstawie swojej wiedzy. Każda cena w twojej wiedzy jest podana w dolarach amerykańskich (USD).
Gdy odwiedzający pyta, ile kosztuje plan lub cena w innej walucie, albo wspomina swój kraj lub lokalną walutę, wywołaj akcję "Convert price to currency" z kwotą w dolarach amerykańskich i 3-literowym kodem waluty docelowej, a następnie podaj zarówno cenę w USD, jak i przeliczoną kwotę według dzisiejszego kursu.
Jeśli nie znasz odpowiedzi, powiedz to uczciwie i zaproponuj przekazanie sprawy zespołowi. Nigdy nie zgaduj.Dwie linie są tu celowe. Ta o dolarach amerykańskich mówi modelowi, co oznaczają ceny w wiedzy, więc wie, co przekazać do akcji. Ostatnia linia, powiedz, gdy nie wiesz, powoduje uczciwą odmowę zamiast zgadywania. Przetestujemy obie później.
Teraz dodaj wiedzę, na podstawie której agent ma odpowiadać. Na stronie Knowledge Base dodaj kilka krótkich artykułów z faktami o Meridian. Demo opiera się głównie na cenach:
Meridian ma trzy plany, rozliczane za użytkownika miesięcznie w dolarach amerykańskich (USD):
- Starter: 19 USD za użytkownika miesięcznie. Nielimitowane projekty, widoki osi czasu i tablicy, do 3 integracji.
- Pro: 49 USD za użytkownika miesięcznie. Dodaje planowanie sprintów, zależności zadań, pola niestandardowe i nielimitowane integracje.
- Business: 99 USD za użytkownika miesięcznie. Dodaje roadmapy portfela, zaawansowane uprawnienia, SSO i priorytetowe wsparcie.
Rozliczenie roczne kosztuje o 17% mniej niż miesięczne. Każdy plan zaczyna się od 14-dniowego darmowego okresu próbnego, bez wymaganej karty kredytowej.
Fakty użyte w demo, dodane jako krótkie artykuły i oznaczone jako Ready. Agent odpowiada na pytania o ceny na ich podstawie.
To wystarczy, aby agent odpowiadał na pytania o ceny. Celowo pomiń jedną rzecz, certyfikację bezpieczeństwa, aby mieć prawdziwe pytanie, na które agent nie powinien umieć odpowiedzieć.
Krok 2: Główny przepis na AI Action: wywołaj dowolne REST API
To część wielokrotnego użytku. Otwórz Actions & MCPs, a pod Custom Actions kliknij Add Action, następnie API Action.
Pod Custom Actions lista Add Action pokazuje najpierw API Action: opisane żądanie HTTP do dowolnego REST API.
Każda API Action używa tego samego formularza, w tej samej kolejności. Naucz się go raz tutaj, a każdy późniejszy przepis będzie tymi samymi polami z innymi wartościami. Ma dwie połowy: co zebrać od odwiedzającego oraz jakie żądanie wysłać. (Istnieje też ścieżka generowana: opisz API zwykłym językiem i pozwól Quickchat zbudować akcję za ciebie, wraz z cytowaniami dokumentacji. Ten poradnik jest ręczną wersją tej samej akcji i lepszym miejscem, żeby zrozumieć, co robi każde pole).
Wartości do zebrania
Górna część formularza: API Action Name i dwa wymagane parametry uzupełniane przez model, currency i amount.
API Action Name. Krótka nazwa, której model używa do odwołania się do akcji.
Convert price to currencyWhat to ask the user first. Wartości wymagające oceny, po jednym wierszu. Każdej nadaj Format, Name i Description, który mówi modelowi, jak ją uzupełnić, oraz oznacz ją jako Required, aby model nigdy nie wywołał akcji bez niej.
| Format | Name | Description | Required |
|---|---|---|---|
| Text | currency | 3-literowy kod ISO waluty, na którą należy przeliczyć, na przykład EUR, GBP lub JPY. Wywnioskuj go z waluty lub kraju, o których wspomina odwiedzający. | yes |
| Decimal Number | amount | Kwota w dolarach amerykańskich do przeliczenia, pobrana z planu lub ceny, o którą pytał odwiedzający. | yes |
“What to ask the user first” to etykieta produktu, ale agent rzadko zatrzymuje się, aby zapytać. Gdy odwiedzający pisze “ile kosztuje Business w euro”, model ma już obie wartości (amount z twojej wiedzy, currency z “euro”) i wypełnia je od razu.
Żądanie do wysłania
Żądanie: GET do Frankfurter, z base ustawionym na stałe na USD oraz chipami currency i amount dodanymi w Query Params.
API request method and endpoint URL. GET do endpointu najnowszych kursów Frankfurter:
GET
https://api.frankfurter.dev/v1/latestQuery Params. Tu spotykają się wartości deterministyczne i wymagające oceny. Dodaj trzy wiersze na karcie Query Params. Wpisz USD jako base, a dla dwóch pozostałych kliknij Add AI Data i wybierz zdefiniowane parametry, co wstawi chipy {{currency}} i {{amount}}.
| Key | Value |
|---|---|
base | USD |
symbols | {{currency}} |
amount | {{amount}} |
Headers i Body: brak. To GET, w którym wszystko jest w query stringu.
API Action Description. Najważniejsze pojedyncze pole. To właśnie je model czyta, aby zdecydować, czy wywołać akcję, więc powiąż je z jasnym sygnałem zamiast opisywać mechanizm.
Przelicz kwotę w dolarach amerykańskich na inną walutę według dzisiejszego kursu wymiany. Wywołaj to zawsze, gdy odwiedzający pyta, ile kosztuje cena lub plan w walucie innej niż dolary amerykańskie, albo podaje swój kraj lub lokalną walutę. Przekaż kwotę w dolarach amerykańskich i 3-literowy kod ISO waluty, na którą należy przeliczyć.Zapisz ją i włącz akcję. To cały przepis: nazwa, wartości do zebrania, żądanie i opis.
Gotowa akcja, włączona. Karta pokazuje liczbę wywołań i wskaźnik powodzenia na pierwszy rzut oka.
Nic tutaj nie jest specyficzne dla walut. Zamień URL i query na własne API, a otrzymasz inną akcję.
Skieruj ją na własne API
Akcja Frankfurter jest odczytem: GET z publicznymi danymi. Twoje własne API zwykle używa tego samego formularza z kilkoma dodatkowymi polami.
- Aby zapisywać, nie tylko odczytywać, ustaw metodę na
POST,PATCHlubDELETEi umieść dane na karcie Body jako JSON. Te same chipy{{...}}działają wewnątrz body, więc{ "email": "{{email}}" }wysyła to, co zebrał model. - Dla API, które wymaga klucza, dodaj wiersz na karcie Headers (na przykład
Authorization) i wstaw klucz przez Add AI Data, wybierając System Token. Quickchat przechowuje sekret i wstrzykuje go w momencie wywołania, więc jest widoczny jako odznaka i nigdy nie trafia do modelu ani do promptu. - Wszystko inne jest identyczne: nazwa, parametry do zebrania i opis decydujący, kiedy akcja się uruchamia.
Poradnik HubSpot buduje w ten sposób cztery akcje POST ze wstrzykniętym tokenem OAuth, a poradnik Discord buduje siedem akcji wobec Discord API z tokenem bota w nagłówku. Oba używają tego samego formularza, który właśnie wypełniłeś, tylko z innym URL i body.
Krok 3: Przetestuj i obserwuj wywołanie
Oto cała pętla w jednym obrazie: odwiedzający pyta, model uzupełnia wartości wymagające oceny, Quickchat dodaje stałe wartości i wykonuje żądanie, a odpowiedź zawiera wynik.
Jedno wywołanie od początku do końca: model uzupełnia wartości wymagające oceny, a Quickchat dodaje stałe wartości i wykonuje żądanie.
Porozmawiaj ze swoim agentem w AI Preview (na górze lewego menu) albo w aktywnym widgecie, a następnie otwórz rozmowę w Inbox. Najpierw zadaj zwykłe pytanie o cenę, potem zapytaj o nią w innej walucie:
Visitor: Ile kosztuje plan Business? Meridian: Plan Business kosztuje 99 USD za użytkownika miesięcznie.
Visitor: Ile to jest w euro? Meridian: Plan Business kosztuje 99 USD za użytkownika miesięcznie, czyli około 86,81 EUR za użytkownika miesięcznie według dzisiejszego kursu.
Pierwsza odpowiedź pochodzi z wiedzy. Druga to uruchomienie akcji. Nie musisz wierzyć samej odpowiedzi: rozmowa pokazuje znacznik 1 action called, a po rozwinięciu widać samo wywołanie.
Agent odpowiada 99 USD z wiedzy, a potem przelicza na euro. Karta 1 action called potwierdza, że wywołanie się uruchomiło i zwróciło 200.
Karta jest uczciwym środkiem między wiadomością a odpowiedzią. Pokazuje, że akcja zwróciła 200, dokładne wartości wysłane przez model (amount: 99, currency: EUR) oraz odpowiedź, którą odesłał Frankfurter. Gdy budujesz własną akcję, ta karta i log wywołań dla akcji (łączna liczba wywołań, wskaźnik powodzenia, każde żądanie i odpowiedź) to miejsca, w których potwierdzasz, że agent wywołał właściwą akcję z właściwymi wartościami, a nie tylko że odpowiedź brzmiała poprawnie.
Ta sama akcja obsługuje dowolną walutę. Zapytaj o plan Starter w jenach japońskich, a agent wywoła Frankfurter z amount: 19 i currency: JPY, po czym odpowie, że $19 to około ¥3,087 według dzisiejszego kursu. Ten sam przepis, inna wartość uzupełniona przez model.
Ta sama akcja, inna waluta: $19 staje się ¥3,087. Zmieniła się tylko wartość uzupełniona przez model.
Log dla akcji jest dostępny jednym kliknięciem. Otwórz View logs na akcji, aby zobaczyć każde wykonane przez nią wywołanie: sumę, wskaźnik powodzenia oraz dla każdego wywołania dokładne żądanie i otrzymaną odpowiedź.
Każde wywołanie wykonane przez akcję, z dokładnym żądaniem, odpowiedzią i statusem. Obie konwersje zwróciły 200.
Krok 4: Zadbaj o niezawodność
Powyższa akcja działa za pierwszym razem dzięki czterem decyzjom. Każda z nich jest dźwignią, której będziesz używać w każdej integracji.
Oznacz parametry jako wymagane. Zarówno currency, jak i amount są wymagane, więc model nie może wywołać akcji z połową żądania. Parametry opcjonalne są dla wartości naprawdę opcjonalnych.
Niech opis decyduje, kiedy akcja się uruchamia. Model czyta description, nie nazwę, aby wybrać akcję. Niejasny opis (“przelicza waluty”) uruchamia się nieprzewidywalnie. Opis powiązany z sygnałem (“wywołaj to zawsze, gdy odwiedzający pyta, ile kosztuje cena w walucie innej niż dolary amerykańskie”) uruchamia się wtedy, gdy powinien. Gdy akcja wywołuje się w złym momencie albo wcale, prawie zawsze naprawia się to opisem.
Niech API wykonuje obliczenia, nie model. Pierwsza próba akcji walutowej często pobiera kurs wymiany i zostawia mnożenie modelowi. Modele językowe nie są niezawodnymi kalkulatorami, a błędna suma w pytaniu o cenę jest gorsza niż brak sumy. Frankfurter przyjmuje parametr amount i zwraca już przeliczoną wartość, więc model musi tylko odczytać 86.81, nigdy jej obliczać. Gdy twoje API może zwrócić gotową wartość, wybierz to zamiast proszenia modelu o jej wyliczenie.
Potwierdź, że mówi “nie”. Niezawodność nie polega tylko na uruchamianiu akcji. Polega też na tym, żeby agent nie zmyślał. Zapytaj agenta o coś, czego nie ma w jego wiedzy, czyli pominiętą certyfikację bezpieczeństwa:
Uczciwe “nie”: bez informacji o SOC 2 w wiedzy agent odmawia zamiast zgadywać.
Visitor: Czy Meridian ma certyfikat SOC 2 Type II? Meridian: Nie mam w mojej dokumentacji żadnych informacji o tym, czy Meridian ma certyfikat SOC 2 Type II, więc nie mogę tego potwierdzić. Jeśli potrzebujesz jednoznacznej odpowiedzi do przeglądu bezpieczeństwa lub procesu zakupowego, zalecam bezpośredni kontakt z zespołem pod adresem support@meridian.example.
Ta odmowa to ostatnia linia promptu wykonująca swoją pracę. Agent, który wywołuje prawdziwe API, musi rozumieć granice swojej wiedzy, więc testuj “nie” równie celowo jak “tak”.
Te cztery dźwignie zapewniają niezawodność jednej akcji odczytu. Akcje, które zapisują, zwrot, refundację, rekord, wymagają więcej: powinny uruchamiać się tylko wtedy, gdy zaszło właściwe zdarzenie, i czysto przekazywać wartość do następnej akcji. To osobny poradnik: zadbaj o niezawodność akcji swojego agenta omawia blokowanie akcji na warunkach po stronie serwera, których czat nie może obejść, oraz przekazywanie przechwyconej wartości między akcjami.
Uruchomienie produkcyjne
Akcja należy do agenta, nie do jednego kanału, więc działa wszędzie tam, gdzie agent jest wdrożony. Włącz web widget, a ta sama konwersja walut zadziała dla odwiedzającego na twojej stronie. Podłącz Telegram, WhatsApp, Messenger, Slack lub Discord, a tam też zadziała bez zmian. Nie trzeba nic powtarzać dla poszczególnych kanałów. Wdrożony agent przenosi swoje akcje ze sobą.
Co dalej: prawdziwe integracje
Zbudowałeś główny przepis. Każdy poniższy poradnik to ten sam kształt akcji skierowany na prawdziwą usługę, więc każdy zaczyna od czegoś, co już rozumiesz, i dodaje tylko to, co jest specyficzne dla danej integracji.
- Zapisuj leady i raporty do Google Sheets: agent dodaje wiersz, gdy rozmowa wygeneruje leada lub informację zwrotną.
- Twórz kontakty, deale i tickety w HubSpot: projekt CRM tylko do zapisu, który wypełnia rekord krok po kroku i nigdy nie odczytuje danych żadnej osoby.
- Moderuj serwer Discord: timeout, kick i ban jako AI Actions, z destrukcyjnymi akcjami zablokowanymi dla administratorów przez bramkę po stronie serwera.
- Uruchom bota ticketów wsparcia na Discord: trzy połączone akcje, które otwierają prywatny wątek, dodają członka i powiadamiają rolę wsparcia.
- Zarządzaj grupą Telegram: ogłaszaj, przypinaj i moderuj zwykłym językiem przez Telegram Bot API.
- Zamień agenta w serwer MCP: udostępnij go jako narzędzie, które mogą wywoływać ChatGPT, Claude i Cursor.
- Uruchamiaj agenta i zarządzaj nim z ChatGPT: steruj zbudowanym agentem z poziomu klienta AI przez MCP.
Pełna dokumentacja pól znajduje się w dokumentacji AI Actions.
Często zadawane pytania
Jak zbudować agenta AI za darmo?
Utwórz darmowe konto Quickchat AI, daj agentowi krótki główny prompt i trochę wiedzy, na podstawie której ma odpowiadać, a następnie dodaj jedną AI Action, czyli opisane żądanie HTTP, aby mógł wywoływać API podczas rozmowy. Budowanie agenta, wczytywanie wiedzy oraz tworzenie i włączanie akcji są darmowe, a cały poradnik działa na darmowym planie.
Czy muszę kodować, żeby zbudować agenta AI?
Nie. Opisujesz agenta zwykłym językiem i wypełniasz formularz akcji: nazwę, wartości do zebrania od odwiedzającego, metodę i URL żądania oraz opis, kiedy ją wywołać. Quickchat wysyła żądanie i przekazuje odpowiedź z powrotem agentowi. Nie piszesz ani nie hostujesz żadnego kodu.
Ile czasu zajmuje zbudowanie agenta AI?
Około dziesięciu minut dla agenta z tego poradnika: kilka minut na napisanie promptu i dodanie faktów jako wiedzy oraz kilka kolejnych na wypełnienie jednego formularza AI Action. Nie trzeba nic instalować ani pisać kodu.
Jaka jest różnica między agentem AI a chatbotem?
Chatbot odpowiada na pytania. Agent AI także wykonuje akcje: może wywołać API podczas rozmowy, aby coś sprawdzić lub wprowadzić zmianę, a następnie użyć wyniku w odpowiedzi. W Quickchat budujesz agenta z trzech części: Identity (kim jest), Knowledge (na podstawie czego odpowiada) i Actions (co może zrobić).
Czy agent AI może używać aktualnych danych w czasie rzeczywistym?
Tak. Za każdym razem, gdy agent wywołuje AI Action, wykonuje nowe żądanie, więc zawsze używa aktualnych danych. Agent w tym poradniku pobiera dzisiejszy kurs wymiany przy każdej konwersji. Skieruj akcję na własne API, a będzie odczytywać twoje bieżące dane w ten sam sposób.
Czy agent AI może wywołać moje własne API?
Tak. AI Action w tym poradniku to ogólne żądanie HTTP. Skieruj je na własne REST API zamiast publicznego API użytego tutaj, ustaw metodę, URL, nagłówki i body oraz opisz, kiedy agent powinien je wywołać. Ten sam przepis działa dla dowolnego REST API, w tym prywatnych API za tokenem autoryzacyjnym.
Czy jeden agent AI może mieć więcej niż jedną akcję?
Tak. Agent może mieć wiele AI Actions i wybiera właściwą dla każdej wiadomości na podstawie opisów, które napiszesz. Ten poradnik buduje jedną akcję, aby zachować koncentrację. Poradniki integracji dodają kilka akcji do tego samego agenta.
Czy ChatGPT, Claude lub Gemini mogą zbudować agenta, który wykonuje akcje?
Możesz zbudować agenta w Quickchat i wybrać model, który go obsługuje. Podczas rozmowy model decyduje, kiedy wywołać twoją akcję, i uzupełnia wartości z czatu, więc agent sam coś sprawdza lub wprowadza zmianę. Możesz też udostępnić gotowego agenta ChatGPT, Claude i Cursor jako serwer MCP.
Co agent może faktycznie zrobić po zbudowaniu?
Wszystko, co może zrobić REST API. Ten poradnik używa sprawdzania kursu waluty na żywo, ale ten sam kształt akcji zapisuje leada do Google Sheets, tworzy kontakt w HubSpot, moderuje serwer Discord lub zarządza grupą Telegram. Każdy z tych przykładów to opracowany przykład głównego przepisu z tego wpisu.
Skąd agent wie, kiedy wywołać akcję?
Opis akcji jest tym, co model czyta, aby podjąć decyzję. Powiąż go z jasnym sygnałem, na przykład “wywołaj to, gdy odwiedzający pyta o cenę w walucie innej niż dolary amerykańskie”, i oznacz potrzebne wartości jako wymagane. Parametry są jedynymi wartościami, które model musi uzupełnić. Wszystko inne w żądaniu jest stałe.
Czy pozwolenie agentowi AI na wywoływanie API jest bezpieczne?
Zachowujesz kontrolę nad żądaniem. Ustalasz metodę, URL i wszelkie sekrety (wstrzykiwane po stronie Quickchat, nigdy niepokazywane modelowi), a model uzupełnia tylko parametry, które zdefiniujesz. Dla akcji zapisujących dane możesz uzależnić wywołanie od warunków po stronie serwera, których czat nie może obejść. Poradniki HubSpot i Discord omawiają pełne wzorce bezpieczeństwa.
Czy zbudowanie i przetestowanie jest darmowe?
Tak. Tworzenie agenta, dodawanie wiedzy oraz budowanie i włączanie AI Actions są darmowe, a cały poradnik działa na darmowym planie. Gdy będziesz gotowy uruchomić agenta dla większej liczby odwiedzających, płatne plany dodają wyższe limity i bardziej zaawansowane modele.