Co Agent AI może robić w trakcie rozmowy: wbudowane Quickchat AI Actions oraz akcje niestandardowe wywołujące Twoje własne API, serwer MCP lub skrót taki jak Google Sheets.
Zdefiniuj, co Twój Agent AI może robić podczas rozmowy. Od odpowiadania na pytania przy użyciu danych z API w czasie rzeczywistym, przez zbieranie leadów i danych do analiz rynkowych, po wykonywanie niestandardowych zadań.
Agenci Quickchat AI mają dwa rodzaje akcji.
Quickchat AI Actions są wbudowane, wystarczy je włączyć i skonfigurować:
- Human Handoff przekazuje rozmowę człowiekowi.
- Inteligentne zbieranie danych zbiera leady i inne dane w trakcie czatu.
Akcje niestandardowe sięgają poza Quickchat AI:
- Akcje API wywołują dowolny endpoint HTTP. Opisujemy je na tej stronie.
- Akcje MCP podłączają cały serwer MCP naraz.
- Google Sheets to skrót, który jednym kliknięciem tworzy dla Ciebie akcję zapisującą dane.
Każda akcja może odczytywać dane z trwającej rozmowy przez AI Action Variables, a przykład Jira buduje taką akcję od początku do końca.
Opcjonalne narzędzia konfiguracji
Dział zatytułowany „Opcjonalne narzędzia konfiguracji”-
Sprawdź warunki uruchomienia Akcji. Oceń warunki na podstawie podanych przykładowych metadanych bez uruchamiania Akcji.
-
Sprawdź przykładowe połączenie MCP. Zainicjuj połączenie i wyświetl narzędzia wyłącznie endpointu dokumentacji Cloudflare lub Microsoft Learn. Narzędzie nie loguje się ani nie wykonuje narzędzi MCP.
Akcje niestandardowe
Dział zatytułowany „Akcje niestandardowe”Akcje niestandardowe umożliwiają Twojej AI wywoływanie zewnętrznych narzędzi podczas rozmowy. Używaj ich do przeszukiwania systemów wewnętrznych, tworzenia zgłoszeń, wyzwalania alertów lub pobierania świeżych danych, których nie ma w Bazie Wiedzy. Znajdziesz je w Akcje & MCPs w sekcji Akcje niestandardowe.
Kliknij + Dodaj akcję, aby utworzyć akcję. Menu oferuje:
- Akcja API: wywołaj dowolny endpoint REST przez HTTP. To najbardziej uniwersalna opcja; używaj jej do wszystkiego, co ma adres URL i przyjmuje JSON.
- MCP: połącz zewnętrzny serwer MCP jednym kliknięciem i pozwól AI korzystać z udostępnianych przez niego narzędzi. Zobacz Akcje MCP.
- Akcja HubSpot: gotowe połączenie z Twoim HubSpot CRM. Używaj go do pracy z kontaktami, transakcjami i zgłoszeniami, w tym do dodawania prywatnych notatek do zgłoszeń, bez samodzielnego zarządzania tokenami API.
- Akcja Discord: zainstaluj edytowalne szablony Akcji API do obsługi wsparcia i moderacji. Wymaga własnej aplikacji Discord. Zobacz Akcje Discord.
- Google Sheets: odczytuj i zapisuj dane w połączonym arkuszu.
- Shopify MCP: połącz sklep Shopify przez serwer Shopify Storefront MCP, aby AI mogła przeszukiwać katalog i zasady sklepu, odczytywać szczegóły produktów oraz tworzyć koszyk. W jednym scenariuszu może być tylko jedna akcja Shopify MCP. Nie obejmuje wyszukiwania zamówień. Zobacz uwagę poniżej.
Każdy Agent AI może przechowywać do 15 akcji. Do tego limitu wliczają się zarówno aktywne, jak i nieaktywne akcje. Wszystkie plany pozwalają aktywować utworzone akcje bez dodatkowego limitu aktywnych akcji zależnego od planu. Aby zwolnić miejsce, usuń akcję, której już nie potrzebujesz. Samo wyłączenie akcji nie zwalnia miejsca.
Shopify Storefront MCP jest przeznaczony do obsługi klientów i nie udostępnia danych zamówień, więc Agent AI połączony wyłącznie przez niego nie może wyszukać zamówienia klienta. Status zamówienia pochodzi z osobnej Akcji API Check order status, która odczytuje Shopify Admin API. Jest konfigurowana automatycznie podczas instalacji aplikacji Quickchat z Shopify App Store. Sklepy połączone przez wklejenie adresu URL nie mają dostępu do Admin API, a więc także do wyszukiwania zamówień. Jeśli potrzebujesz tej funkcji, zainstaluj aplikację ponownie przez App Store.
Jak działają niestandardowe akcje
Dział zatytułowany „Jak działają niestandardowe akcje”- Wybierz typ akcji: Akcja API, MCP, Akcja HubSpot, Akcja Discord, Google Sheets lub Shopify MCP. Skonfiguruj połączenie i instrukcje potrzebne AI.
- Podczas czatu AI zwykle na podstawie opisu akcji oraz dostępnych szczegółów narzędzia lub parametrów decyduje, kiedy ją uruchomić. Akcję API można zamiast tego ustawić tak, aby uruchamiała się automatycznie przed pierwszą odpowiedzią lub gdy warunki dotyczące metadanych zostaną spełnione po raz pierwszy.
- Quickchat wykonuje wywołanie. W przypadku Akcji wybranej przez AI lub uruchamianej przed pierwszą odpowiedzią AI może wykorzystać odpowiedź. Akcja wyzwalana przez metadane działa po cichu, a jej wynik nie jest dodawany do czatu.
- Przed użyciem akcji w rozmowach przetestuj ją lub połącz z poziomu jej edytora.
Napisz opis jako instrukcję dla AI. Powiedz, kiedy używać akcji, co zwraca i jakie obowiązują ograniczenia (np. „wywołuj tylko wtedy, gdy użytkownik poda numer zamówienia”).
Przygotuj wersje robocze Akcji na podstawie opisu
Dział zatytułowany „Przygotuj wersje robocze Akcji na podstawie opisu”- W sekcji Akcje & MCPs wybierz + Dodaj akcję > Akcja API.
- Opisz przebieg procesu, kiedy Agent powinien działać, z których API ma korzystać (lub podaj linki do ich dokumentacji) i jakie informacje są potrzebne na każdym etapie. Kliknij Wygeneruj.
- Quickchat przygotowuje do czterech nowych Akcji API w wersji roboczej. Wszystkie są nieaktywne. Może też zasugerować użycie istniejących Akcji, aby uniknąć duplikatów, lub poprosić o więcej szczegółów. Generowanie wersji roboczych nie uruchamia Akcji.
- Sprawdź sekcje Wykorzystane istniejące akcje i Następne kroki oraz wymagania wstępne. Dokończ konfigurację, wstaw właściwe wartości w miejsce placeholderów i sprawdź żądanie, instrukcje oraz warunki uruchamiania każdej Akcji. Przetestuj każdą Akcję, zanim włączysz wersje robocze lub potrzebne istniejące Akcje, które są nieaktywne.
Zaproponowana kolejność opisuje zamierzone działanie. Nie gwarantuje kolejności, w jakiej AI wybierze Akcje. Określ zależności za pomocą wymaganych danych wejściowych, wartości zapisanych w pamięci i warunków uruchamiania. Po włączeniu Akcji przetestuj cały proces w rozmowie.
Utwórz akcję API
Dział zatytułowany „Utwórz akcję API”- Przejdź do Akcje & MCPs.
- Kliknij + Dodaj akcję w sekcji Akcje niestandardowe, wybierz Akcja API, a następnie kliknij Utwórz ręcznie.
- Uzupełnij Details:
- Name: jasna i opisowa nazwa
- Description: kiedy używać i co uwzględnić w parametrach
- W sekcji Kiedy uruchomić wybierz AI decyduje, Przed pierwszą odpowiedzią lub Gdy metadane pasują.
- Skonfiguruj Connection:
- Action Type: metoda HTTP (GET, POST itd.).
- Action endpoint URL: pełny adres URL API
- Headers: dodaj wymagane nagłówki, np.
Authorizationlubcontent-type: application/json
- Zdefiniuj Parameters: nadaj każdemu parametrowi name, location (query, body lub header) i description, która mówi AI, jak złożyć wartość. Wartości ścieżki (path) nie są lokalizacją parametru; wstaw je bezpośrednio w adresie URL endpointu za pomocą szablonów
{{placeholder}}. - Test request i zweryfikuj odpowiedź. Następnie kliknij Done.
Każde pole wartości (URL, nagłówek, body lub query) obsługuje dynamiczne placeholdery dostępne przez przycisk + Dodaj dane AI. Możesz wstawiać parametry AI, wbudowane zmienne konwersacji ({{scenario_id}}, {{language}}, {{country}}, …) oraz metadane konwersacji ({{metadata_*}}). Pełną referencję znajdziesz na stronie Zmienne AI Actions.
Poza samym żądaniem Akcja API ma trzy opcjonalne ustawienia, które warto znać: Zapisz w pamięci, Uruchom tylko gdy i Filtr odpowiedzi.
Podejrzyj żądanie Akcji API na podstawie podanego szablonu i syntetycznych wartości przykładowych. Pomiń nagłówki z danymi uwierzytelniającymi. Podgląd przygotowuje żądanie bez wysyłania go.
Wybierz wartości domyślne parametrów
Dział zatytułowany „Wybierz wartości domyślne parametrów”W Akcji działającej w trybie AI decyduje wybierz Brak wartości domyślnej, jeśli AI ma zebrać wartość z rozmowy. Wymagany parametr bez wartości domyślnej nie może wysłać pustej wartości. Celowo pusta wartość domyślna to osobne ustawienie; istniejące puste wartości domyślne pozostają puste. Edytor zachowuje też domyślną wartość liczbową 0 i wartość logiczną false.
Dla parametru tekstowego lub liczbowego otwórz Opcje wartości domyślnej obok pola wartości domyślnej i wybierz Brak wartości domyślnej lub Pusta wartość. Pustą wartość domyślną możesz zastąpić inną wartością. Dla parametru logicznego wybierz Brak wartości domyślnej z listy rozwijanej.
Wybierz moment uruchomienia Akcji API
Dział zatytułowany „Wybierz moment uruchomienia Akcji API”Użyj Kiedy uruchomić, aby wybrać jeden z trzech trybów:
Sekcja jest domyślnie zwinięta i pokazuje obok nagłówka aktualnie wybrany tryb. Rozwiń ją, aby zmienić tryb.

- AI decyduje: tryb domyślny. AI odczytuje opis Akcji i decyduje, czy żądanie odwiedzającego wymaga jej uruchomienia. Użyj tego trybu, gdy Akcja powinna uruchamiać się tylko w przypadku określonych pytań lub po zebraniu przez AI informacji od odwiedzającego.
- Przed pierwszą odpowiedzią: Quickchat uruchamia Akcję raz po wysłaniu przez odwiedzającego pierwszej wiadomości, ale zanim AI utworzy pierwszą odpowiedź. Zwykła odpowiedź AI otrzymuje odpowiedź API i wszystkie wartości zapisane przy użyciu Zapisz w pamięci. AI nie może już wybrać tej Akcji jako narzędzia, więc uruchamia się ona tylko w pierwszej turze i nie później w rozmowie. Użyj tego trybu do identyfikacji klienta, pobrania kontekstu konta, sprawdzenia uprawnień albo innej konfiguracji potrzebnej każdej rzeczywistej rozmowie.
- Gdy metadane pasują: Quickchat sprawdza warunki Uruchom, gdy Akcji po każdej turze AI i uruchamia ją, gdy wszystkie warunki zostaną spełnione po raz pierwszy. Wartości zapisane w pamięci przez inną Akcję podczas tej samej tury są dostępne natychmiast. AI nie może wybrać tej Akcji jako narzędzia, a jej odpowiedź nie jest dodawana do czatu. Użyj tego trybu do wewnętrznych powiadomień, aktualizacji CRM lub kolejnych żądań, które powinny być wykonywane automatycznie, gdy dane konwersacji staną się dostępne.
Tryb Przed pierwszą odpowiedzią jest powiązany z pierwszą wiadomością odwiedzającego, a nie z utworzeniem rozmowy. Otwarcie czatu ani odebranie wiadomości powitalnej nie uruchamia Akcji, więc porzucone czaty nie wysyłają żądania. Quickchat zapisuje uruchomienie przed wywołaniem endpointu. Dlatego nie próbuje ponownie w tej samej rozmowie, nawet jeśli żądanie się nie powiedzie lub jego wynik jest niepewny.
Pierwsza odpowiedź czeka na zakończenie żądania, dlatego ten tryb może zwiększyć opóźnienie. Jeśli kilka Akcji korzysta z tego trybu, uruchamiają się kolejno, a czasy ich żądań się sumują. Jeśli brakuje wymaganych metadanych, endpoint jest niedostępny lub żądanie się nie powiedzie, AI nadal odpowie. Otwórz Dziennik żądań Akcji, aby sprawdzić, co się stało.
Ponieważ Akcja uruchamia się, zanim AI może wybrać wartości parametrów, każdy używany przez nią parametr AI musi mieć wartość domyślną. Metadane i wbudowane zmienne można wstawiać bezpośrednio w adresie URL, nagłówkach, parametrach query lub body.
Tryb Gdy metadane pasują wymaga co najmniej jednego warunku Uruchom, gdy oraz wartości domyślnej dla każdego parametru AI. Quickchat zapisuje próbę przed wywołaniem endpointu, więc gdy żądanie zostanie już wysłane, Akcja nie jest ponawiana w tej samej rozmowie, niezależnie od tego, czy się powiodła, nie powiodła, czy jej wynik jest niepewny. Żądanie, którego w ogóle nie udało się zbudować, bo brakuje potrzebnej wartości, nie jest zapisywane i pozostaje możliwe w późniejszej turze. Akcja uruchamia się zaraz po zakończeniu tury przez AI, więc błąd nigdy nie zastępuje odpowiedzi AI. Na kanałach bez streamingu czas żądania wydłuża oczekiwanie na odpowiedź.
Wybranie trybu Gdy metadane pasują odsłania edytor Uruchom, gdy w tej samej sekcji, dzięki czemu wyzwalacz i jego warunki są razem.

W przypadku kanałów, które mogą udostępniać adres e-mail albo numer telefonu, utwórz osobną Akcję wyszukiwania dla każdego identyfikatora. Dla obu wybierz Przed pierwszą odpowiedzią, a następnie do każdej dodaj pasujący warunek Run only when, taki jak visitor_email exists lub visitor_phone_number exists. Quickchat wysyła tylko to żądanie, dla którego są dostępne metadane.
Webhooki po zakończeniu rozmowy i transkrypcje
Dział zatytułowany „Webhooki po zakończeniu rozmowy i transkrypcje”Akcja API może powiadomić Twój webhook podczas czatu. W trybie AI decyduje instrukcja wywołania jej przy kończeniu rozmowy nie gwarantuje wykonania. Standardowe tryby nie gwarantują wywołania po zakończeniu rozmowy, po okresie bezczynności odwiedzającego ani po zamknięciu karty przeglądarki.
Aby uzyskać dokładną transkrypcję, zdefiniuj w integracji warunek zakończenia rozmowy. Przekaż {{conversation_id}} do swojego backendu i użyj uprawnionego tokenu API z zakresem read_all, aby pobrać wszystkie strony zdarzeń rozmowy, korzystając z limit i offset. Zbuduj transkrypcję ze zdarzeń wiadomości. Przechowuj token w backendzie.
Nie ma wbudowanej zmiennej z transkrypcją. Parametr zawierający podsumowanie lub transkrypcję wygenerowaną przez AI nie gwarantuje dokładnej kopii. Dostępny kontekst opisują zmienne Akcji AI.
Akcje HubSpot
Dział zatytułowany „Akcje HubSpot”HubSpot Action otwiera galerię wstępnie wypełnionych, edytowalnych Akcji API, które korzystają z połączonego konta HubSpot.

Szablon Dodaj notatkę do zgłoszenia tworzy prywatną notatkę w zgłoszeniu HubSpot powiązanym z konwersacją. Zapisz treść notatki w pamięci konwersacji jako hubspot_note_body, a następnie dodaj szablon i go aktywuj. Jest wstępnie skonfigurowany w trybie Gdy metadane pasują i czeka, aż dostępne będą zarówno hubspot_note_body, jak i dostarczony przez serwer Quickchat klucz hubspot_ticket_id. Możesz zmienić domyślną wartość parametru note_body, aby dodać stały tekst wokół {{metadata_hubspot_note_body}}.
Notatka jest widoczna tylko wewnętrznie w HubSpot i nie jest pokazywana odwiedzającemu. Szablon podejmuje jedną próbę wysłania żądania na każdą konwersację w Quickchat. Otwórz Dziennik żądań Akcji, aby potwierdzić dostarczenie notatki lub zbadać nieudane żądanie.
Akcje Discord
Dział zatytułowany „Akcje Discord”Akcje Discord otwierają galerię wstępnie wypełnionych, edytowalnych Akcji API:
- Support i zgłoszenia: Otwórz zgłoszenie supportowe wymaga wybrania serwera i kanału tekstowego. Opcjonalnie możesz wybrać rolę supportu, którą można wspomnieć. Tworzy trzy Akcje, które otwierają prywatny wątek, dodają bieżącego zgłaszającego i publikują podsumowanie z opcjonalną wzmianką o roli.
- Moderacja: Nadaj timeout członkowi, Wyrzuć członka, Zbanuj członka, Zdejmij bana, Przypisz rolę, Ustaw slowmode i Wyślij ogłoszenie. Każdy szablon instaluje się jednym kliknięciem i korzysta z serwera, członka, roli lub kanału z bieżącego żądania Discord.
Quickchat tworzy na backendzie metodę HTTP, adres URL, nagłówki, body, parametry, opis, ustawienia odpowiedzi i warunki uruchamiania. Powstałe karty są zwykłymi Akcjami typu HTTP Request. Możesz sprawdzić i edytować każde pole.
Wszystkie siedem szablonów moderacji zawiera warunek author_is_admin is true w sekcji Uruchom tylko gdy. Discord ustala, czy bieżący autor ma uprawnienie Administrator, gateway Discord przekazuje tę wartość, a Quickchat sprawdza ją przed wysłaniem żądania. Publiczny czat ani metadane API nie mogą ustawić tego klucza. Testuj Akcje moderacji na Discordzie zarówno z konta administratora, jak i konta bez uprawnień administratora. AI Preview nie udostępnia autoryzowanego nadawcy Discord.
Akcje moderacji można edytować. Usunięcie lub osłabienie warunku author_is_admin is true usuwa dostarczoną granicę autoryzacji. Wyrzuć członka i Zbanuj członka nie proszą o potwierdzenie przed wykonaniem.
Szablony nie dodają żadnej własnej automatyzacji. Agent uruchamia je tylko wtedy, gdy administrator poprosi o to w rozmowie; nie ma liczenia strike’ów między rozmowami, weryfikacji zrzutów ekranu ani innych dowodów, ani zaplanowanych czy samodzielnie inicjowanych sankcji.
Sam bot nadal potrzebuje uprawnienia Discord wymaganego przez każde żądanie:
| Akcja | Uprawnienie lub dostęp bota |
|---|---|
| Nadaj timeout członkowi | Moderate Members |
| Wyrzuć członka | Kick Members |
| Zbanuj członka, Zdejmij bana | Ban Members |
| Przypisz rolę | Manage Roles |
| Ustaw slowmode | Manage Channels |
| Wyślij ogłoszenie | View Channels i Send Messages |
Discord wymusza także hierarchię ról. Umieść rolę bota ponad członkami i rolami, którymi ma zarządzać. Szablon nie wykonuje dodatkowej kontroli hierarchii ani poszczególnych uprawnień administratora wysyłającego żądanie.
Ustaw slowmode i Wyślij ogłoszenie przyjmują parametr ID kanału. Bez dodatkowego stałego celu szablon nie sprawdza, czy kanał należy do serwera, z którego administrator wysłał żądanie. Jeśli ten sam bot należy do wielu serwerów, edytuj te Akcje tak, aby używały stałego ID kanału, albo utwórz dla serwerów osobne granice zaufania z oddzielnymi Agentami i danymi logowania botów.
Instalacja Support Ticket korzysta z istniejących funkcji Akcji do przekazywania danych:
open_support_tickettworzy prywatny wątek na wybranym kanale, przechwytuje$.idi zapisuje je w pamięci rozmowy jakodiscord_ticket_thread_id. Wymaga warunkudiscord_message is true, uruchamia się tylko na wybranym serwerze i tylko wtedy, gdy ten klucz pamięci nie istnieje.add_ticket_requesterodczytuje{{metadata_discord_ticket_thread_id}}oraz dostarczone przez Discord{{metadata_discord_author_id}}. Wymaga warunkudiscord_message is truei uruchamia się tylko na wybranym serwerze po zapisaniu ID wątku.post_in_ticketodczytuje to samo zapisane ID wątku, publikuje jednowierszowe podsumowanie sprawy przygotowane przez Agenta oraz wspomina zgłaszającego. Jeśli wybierzesz rolę supportu, wspomina również tę rolę. Ma te same warunki dotyczące wiadomości Discord, serwera i zapisanego wątku. Poleallowed_mentionsw body żądania Discord jest ograniczone do zgłaszającego oraz, jeśli wybrano rolę, do tej roli.
Opisy oraz główny prompt Agenta powinny nakazywać uruchamianie tych Akcji w podanej kolejności. Nie ma osobnej warstwy stanu workflow, blokady, potwierdzenia, ponawiania, odzyskiwania, uzgadniania ani ochrony przed ponownym odtworzeniem żądania. Jeśli wynik jest niepewny, przed ponowieniem sprawdź Discord i log Akcji, ponieważ Discord mógł już wykonać żądanie.
discord_ticket_thread_id nie jest automatycznie usuwany. Dlatego szablon obsługuje jedno zgłoszenie na rozmowę w Quickchat. Aby utworzyć kolejne zgłoszenie, rozpocznij nową rozmowę lub wątek na Discordzie albo edytuj Akcje i dodaj potrzebny cykl życia pamięci.
Dla Support Ticket przyznaj botowi View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads i Manage Threads na wybranym kanale zgłoszeń. Jeśli żadna rola nie ma być wspomniana, w polu Powiadom rolę (opcjonalnie) pozostaw opcję Nie powiadamiaj roli. Jeśli wybierzesz rolę, musi ona umożliwiać wzmianki, a jej członkowie muszą mieć dostęp do prywatnych wątków. Jeśli nie ma dostępnych ról, które można wspomnieć, zgłoszenia nadal otwierają się normalnie bez powiadamiania roli. Galeria pokazuje kanały tekstowe i role, które można wspomnieć, ale nie sprawdza wszystkich nadpisań uprawnień kanału.
Akcje Discord wymagają tokenu z Twojej własnej aplikacji Discord w sekcji Aplikacje zewnętrzne → Discord → Konfiguracja zaawansowana. Sam wspólny bot dostępny jednym kliknięciem nie może dostarczyć tego tokenu. Zobacz Discord.
Galeria jest skrótem konfiguracji, a nie dodatkową warstwą egzekwowania zasad. Jeśli edytujesz wygenerowaną Akcję lub tworzysz niestandardową Akcję API Discord, przed włączeniem sprawdź jej dane logowania, cele, parametry, udostępnianie odpowiedzi i warunki Uruchom tylko gdy.
Zapisz w pamięci
Dział zatytułowany „Zapisz w pamięci”Zapisz wartość z danych wejściowych Akcji lub odpowiedzi API w pamięci konwersacji pod wybranym przez siebie kluczem. Kolejne Akcje mogą jej ponownie użyć jako {{metadata_<key>}}, a wartość pojawia się w szczegółach konwersacji (w Skrzynce odbiorczej, API oraz eksportach).
Sięgnij po to ustawienie, gdy jedna Akcja produkuje coś, czego potrzebuje kolejna Akcja. Akcja wyszukująca może zapisać customer_id ze swojej odpowiedzi; kolejna Akcja wysyła wtedy {{metadata_customer_id}} bez konieczności przepisywania wartości przez AI.
W edytorze Akcji API otwórz sekcję Zapisz w pamięci i dodaj wiersz:
- Wybierz Źródło. Opcja Odpowiedź API odczytuje odpowiedź JSON z API i jest domyślna dla nowych wierszy. Opcja Dane wejściowe akcji odczytuje wartości zadeklarowanych parametrów wejściowych Akcji.
- W polu Wartość do zapisania wybierz parametr z listy rozwijanej dla źródła Dane wejściowe akcji. Dla źródła Odpowiedź API wpisz Wyrażenie JSONPath, na przykład
$.customer_id. - Wybierz Klucz pamięci. Typowe angielskie nazwy parametrów imienia, telefonu i adresu e-mail podpowiadają odpowiedni klucz odwiedzającego. Możesz zachować podpowiedź lub wpisać własny klucz.
Aby zapisać dane kontaktowe w Skrzynce odbiorczej, wybierz Dane wejściowe akcji i użyj tych mapowań:
| Parametr Action | Klucz pamięci |
|---|---|
Name lub Full name | visitor_name |
Phone number lub Phone | visitor_phone_number |
Email lub Email address | visitor_email |
Parametr wejściowy musi być zadeklarowany w Akcji. Zapisanie jego wartości za pomocą reguły pamięci ze źródłem Dane wejściowe akcji liczy się jako użycie parametru, więc można zbierać tę wartość wyłącznie do pamięci, bez wysyłania jej w żądaniu HTTP. Te klucze odwiedzającego uzupełniają nieustawione pola kontaktowe w Skrzynce odbiorczej oraz metadane konwersacji, stosując taką samą walidację jak Inteligentne zbieranie danych. Istniejące dane kontaktowe oraz pola celowo wyczyszczone przez operatora pozostają bez zmian. Reguły korzystające z odpowiedzi API nie mogą zapisywać tych kluczy odwiedzającego. Dla wartości z odpowiedzi CRM użyj własnego klucza, takiego jak customer_id.
Dane wejściowe są zapisywane po pomyślnym sprawdzeniu wymaganych parametrów i warunków uruchomienia Akcji, przed wysłaniem żądania HTTP. Prawidłowe dane kontaktowe pozostają więc dostępne, jeśli API zwróci błąd lub przekroczy limit czasu. Aby to sprawdzić, uruchom Akcję w nowej konwersacji w Podglądzie, a następnie otwórz tę konwersację w Skrzynce odbiorczej. Odizolowany test API w edytorze nie ma konwersacji, w której mógłby zapisać pamięć.
Klucze pamięci są wspólne z narzędziami Remote MCP Agenta. Jeśli narzędzie MCP zapisuje już pod tym samym kluczem, pole Klucz pamięci zgłosi konflikt przy zapisie, więc wybierz inny klucz. Narzędzia Remote MCP nadal zapisują wartości ze swoich wyników.
Używaj kluczy w formacie snake_case (litery, cyfry, podkreślniki). Klucz taki jak customer_id można referencjonować jako {{metadata_customer_id}}; klucze ze spacjami lub innymi znakami interpunkcyjnymi nie mogą być używane w placeholderach. Zobacz Metadane konwersacji, aby dowiedzieć się, jak działają zmienne metadanych.
Run only when
Dział zatytułowany „Run only when”Ogranicz Akcję tak, aby uruchamiała się tylko wtedy, gdy spełnione są warunki dotyczące metadanych konwersacji. Warunki są zawsze sprawdzane po naszej stronie, poza modelem. W trybie AI decyduje lub Przed pierwszą odpowiedzią Quickchat sprawdza je bezpośrednio przed wysłaniem żądania. W trybie Gdy metadane pasują same warunki wyzwalają żądanie po turze AI, bez czekania, aż AI wybierze Akcję.
To właściwe narzędzie do uprzywilejowanych lub nieodwracalnych Akcji (banowanie członka, wystawianie zwrotu, usuwanie rekordu). Linijka w Twoim promptcie mówiąca „tylko administratorzy mogą to zrobić” jest pomocną instrukcją, ale nie jest granicą bezpieczeństwa: zdeterminowany użytkownik może spierać się z modelem lub spróbować prompt injection. Warunek uruchomienia jest deterministyczny i istnieje poza promptem, więc obowiązuje niezależnie od tego, co mówi rozmowa.
- Warunek uruchomienia jest granicą. Jest sprawdzany po stronie serwera i nie jest częścią promptu, który czyta model. To właśnie to faktycznie powstrzymuje Akcję przed uruchomieniem.
- Reguła w promptcie jest doświadczeniem użytkownika. Zachowaj też linijkę w promptcie, aby AI uprzejmie odmawiało i wyjaśniało dlaczego, zamiast milknąć.
Dodaj warunki w sekcji Uruchom tylko gdy edytora Akcji. W trybie Gdy metadane pasują ta sekcja nosi nazwę Uruchom, gdy. Kliknij Dodaj warunek, wybierz klucz metadanych (na przykład telegram_sender_is_admin) i wybierz sposób porównania:
| Warunek | Spełniony, gdy wartość metadanych… |
|---|---|
| ma wartość prawda | jest prawdziwa (truthy) |
| ma wartość fałsz | jest fałszywa (falsy) |
| istnieje | jest obecna na konwersacji |
| nie istnieje | jest nieobecna |
| równa się | pasuje do wartości, którą podasz |
| nie równa się | różni się od wartości, którą podasz |
| jest jedną z | dokładnie odpowiada dowolnej wartości z listy, z uwzględnieniem wielkości liter i białych znaków |
| zawiera tekst | jest tekstem zawierającym podany dosłowny fragment, z uwzględnieniem wielkości liter |
Akcja uruchamia się tylko wtedy, gdy spełniony jest każdy warunek. Edytor wyświetla łącznik I między wierszami. Gdy warunek blokuje Akcję wybraną przez AI, AI może wyjaśnić, że Akcja jest niedostępna. Akcja w trybie Gdy metadane pasują nie wysyła żadnego komunikatu, dopóki jej warunki nie zostaną spełnione.
Użyj warunku jest jedną z, aby podać alternatywy dla tego samego klucza. Dodaj każdą z nich jako osobną etykietę wartości. Na przykład modelName is one of [K-65XR95M2, K-75XR95M2, K-85XR95M2] można połączyć z country equals UK. Oba wiersze muszą być spełnione. Możesz dodać do 50 alternatyw, każda o długości do 500 znaków. Przecinki są dosłowną częścią wartości. Osobne wiersze równa się z różnymi wartościami tego samego klucza nie mogą być jednocześnie spełnione.
Warunek zawiera tekst sprawdza dosłowny fragment tekstu, a nie symbol wieloznaczny ani wyrażenie regularne. XR95M2 dopasowuje również inne warianty nazw modeli poza trzema wymienionymi powyżej. Żaden z nowych warunków nie dopasowuje brakujących kluczy, null, list ani obiektów. Warunek zawiera tekst nie dopasowuje również liczb ani wartości logicznych. Pusty tekst do porównania jest niedozwolony. Dotychczasowe warunki ma wartość fałsz, nie równa się i nie istnieje mogą dopasowywać brakujące klucze.

Gdy warunek nie zostaje spełniony, nie jest wysyłane żadne żądanie, a AI informuje użytkownika, że nie może tego zrobić. Poniżej to samo żądanie banowania zostaje zablokowane dla osoby niebędącej administratorem i dozwolone dla administratora, przy czym zmienia się tylko to, kto pyta:


Bramkuj tylko na metadanych, które ustawia Quickchat (takich jak zweryfikowana przez kanał flaga telegram_sender_is_admin), a nie na wartościach, na które może wpłynąć odwiedzający. Zobacz Metadane konwersacji, aby sprawdzić, skąd pochodzi każdy klucz.
Response filter
Dział zatytułowany „Response filter”Domyślnie AI widzi pełną odpowiedź API. Dodaj wyrażenia JSONPath w sekcji Response filter, aby ograniczyć AI do konkretnych jej części.
Dwa typowe powody do filtrowania:
- Ukrycie wrażliwych pól. Trzymaj adresy e-mail klientów, dane płatnicze lub wewnętrzne identyfikatory poza kontekstem modelu, gdy endpoint zwraca więcej, niż AI potrzebuje.
- Zmniejszenie promptu. Gadatliwe API mogą zwracać duże ładunki; filtrowanie do kilku istotnych pól utrzymuje odpowiedź małą, a AI skupione.
Dodaj jedno lub więcej wyrażeń JSONPath. Filtr zachowuje wybrane pola wewnątrz zawierających je obiektów i tablic, zamiast spłaszczać je do listy wartości. Pola spoza wybranych ścieżek są pomijane. Na przykład użyj tych dwóch wierszy:
$.customer.name$.orders[*].id
Dla takiej odpowiedzi API:
{ "customer": {"name": "Ada", "email": "ada@example.com"}, "orders": [{"id": 101, "total": 25}, {"id": 102, "total": 40}]}AI otrzyma następującą przefiltrowaną odpowiedź, w której customer pozostaje obiektem, a orders tablicą obiektów:
{ "customer": {"name": "Ada"}, "orders": [{"id": 101}, {"id": 102}]}Użyj panelu Test Response, aby zobaczyć dokładnie, co AI otrzyma po filtrowaniu, zanim na tym polegniesz. Zobacz Testowanie Akcji.
JSONPath, który niczego nie dopasowuje, zostawia AI z pustą odpowiedzią. Zacznij bez filtra, potwierdź, że wywołanie działa, a następnie go zawęź.

Podejrzyj dopasowania JSONPath w podanej odpowiedzi JSON. Podgląd obsługuje ścieżki główne, pól, indeksów tablic i symboli wieloznacznych dla reguł Filtr odpowiedzi oraz Zapisz w pamięci.
Sprawdź stan Akcji i jej logi
Dział zatytułowany „Sprawdź stan Akcji i jej logi”Ostrzeżenie obok pozycji Akcje & MCPs na pasku bocznym oznacza, że Akcja wymaga uwagi. Otwórz tę stronę i najedź kursorem na oznaczenie na karcie Akcji lub ustaw na nim fokus klawiatury, aby poznać przyczynę:
- Z błędami: ostatnie wywołania wielokrotnie kończyły się niepowodzeniem. Oznaczenie pokazuje liczbę niepowodzeń oraz ostatni błąd, jeśli jest dostępny.
- Nie uruchamia się: Akcja była wielokrotnie pomijana i w bieżącym okresie oceny jej stanu nie wykonano żadnego wywołania. Sprawdź podaną przyczynę, na przykład brakujące wartości w rozmowie lub problem z konfiguracją.
- Połączenie wygasło: połączenie MCP utraciło autoryzację i zostało wyłączone. Kliknij Edytuj, połącz je ponownie i włącz.
Ocena stanu uwzględnia rzeczywiste rozmowy z ostatnich siedmiu dni lub od ostatniej edycji Akcji, jeśli nastąpiła później. Jest niezależna od żądań testowych. Po poprawieniu i zapisaniu Akcji sprawdź nowe rozmowy, aby potwierdzić skuteczność poprawki. Samo zniknięcie wcześniejszego ostrzeżenia nie dowodzi, że Akcja działa.
W przypadku statusu Z błędami lub Nie uruchamia się kliknij Zobacz szczegóły, aby otworzyć Dziennik żądań z włączoną opcją Tylko problemy. Przycisk Zobacz logi otwiera dziennik ze wszystkimi wywołaniami. Wyłącz Tylko problemy, aby porównać problematyczne wywołania z udanymi.
Sekcja Pominięte rozmowy zawiera rozmowy, w których Akcja nie mogła się uruchomić, oddzielnie od wykonanych wywołań. Użyj Zobacz rozmowę, aby sprawdzić kontekst, i Pokaż więcej, aby wczytać starsze wpisy. Akcja może działać poprawnie w niektórych rozmowach, a w innych być pomijana, dlatego ta lista może być widoczna nawet bez ostrzeżenia na karcie.
Jeśli przyczyna wskazuje brakujące wartości, takie jak {{metadata_visitor_email}}, przekaż je przez metadane witryny lub kanału albo skonfiguruj wcześniejszą Akcję tak, aby zapisywała je w pamięci. Następnie sprawdź tryb uruchamiania:
- AI decyduje: Akcja jest udostępniana AI tylko w rozmowach, które mają już wymagane wartości.
- Przed pierwszą odpowiedzią: wartości muszą być dostępne, gdy odwiedzający wysyła pierwszą wiadomość.
- Gdy metadane pasują: dodaj warunek istnieje dla każdej wymaganej wartości, aby Akcja na nią czekała.
Zobacz Zmienne AI Actions, aby dowiedzieć się, skąd pochodzą wartości w rozmowie.
Wiadomości e-mail z podsumowaniem aktywności zawierają również sekcję AI Actions need attention, gdy Akcja HTTP lub zdalna Akcja MCP wymaga uwagi. Sekcja zawiera maksymalnie pięć Akcji wraz z przyczyną i linkiem do strony Akcje & MCPs. Jeśli więcej Akcji wymaga uwagi, pokazuje również liczbę pozostałych. Gdy wszystko działa poprawnie, sekcja jest pomijana.
Wiadomość e-mail pokazuje bieżący stan Akcji, którego ocena może uwzględniać okres dłuższy niż zakres dziennego podsumowania aktywności. Po poprawieniu i zapisaniu Akcji API ocena jej stanu uwzględnia dane od momentu tej edycji. Ponowne połączenie lub rozłączenie połączenia MCP, którego dotyczy problem, usuwa ostrzeżenie o jego autoryzacji. Nadal obowiązują dotychczasowe preferencje dotyczące podsumowań e-mail oraz zasady kwalifikowania do ich otrzymywania. Osobna wiadomość e-mail z alertem nie jest wysyłana.
Najlepsze praktyki
Dział zatytułowany „Najlepsze praktyki”- Bądź precyzyjny w opisach. Powiedz AI, kiedy używać akcji i co powinny zawierać parametry.
- Minimalizuj zakresy. Dołączaj tylko niezbędne nagłówki i tokeny. Dla Jira używaj nagłówka Basic z adresu e-mail Atlassian i tokenu API.
- Testuj przed wdrożeniem korzystając z panelu Test request. Potwierdź kody statusu i przykładowe ładunki w narzędziu docelowym.