Hoppa till innehåll

Vad din AI-agent kan göra under ett samtal: de inbyggda Quickchat AI Actions och anpassade åtgärder som anropar ditt eget API, en MCP-server eller en genväg som Google Sheets.

Definiera vad din AI‑agent kan göra i en konversation: svar med realtids‑API‑data, leaduppsamling och skräddarsydda åtgärder.

Quickchat AI-agenter har två typer av åtgärder.

Quickchat AI Actions är inbyggda, du slår bara på dem och konfigurerar dem:

Anpassade åtgärder når utanför Quickchat AI:

  • API-åtgärder anropar vilken HTTP-endpoint som helst. De beskrivs på den här sidan.
  • MCP-åtgärder ansluter en hel MCP-server på en gång.
  • Google Sheets är en genväg som med ett klick sätter upp en loggningsåtgärd åt dig.

Varje åtgärd kan läsa livedata från samtalet via AI Action Variables, och Jira-exemplet bygger en från början till slut.

Anpassade åtgärder låter din AI anropa externa verktyg under en konversation: söka i interna system, skapa ärenden, utlösa aviseringar eller hämta färska data som inte finns i kunskapsbasen. Du hittar dem i Åtgärder & MCPs under Anpassade åtgärder.

Klicka på + Lägg till åtgärd för att skapa en. Rullgardinsmenyn innehåller:

  • API-åtgärd: anropa vilken REST-endpoint som helst via HTTP. Det mest generella alternativet. Använd det för allt som har en URL och tar emot JSON.
  • MCP: anslut en extern MCP-server med ett klick och låt AI:n använda verktygen som den tillhandahåller. Se MCP-åtgärder.
  • HubSpot-åtgärd: en färdig anslutning till ditt HubSpot CRM. Använd den för att arbeta med kontakter, affärer och ärenden, inklusive att lägga till privata ärendeanteckningar, utan att själv hantera API-token.
  • Discord-åtgärd: installera redigerbara API-åtgärdsmallar för support och moderering. Kräver din egen Discord-app. Se Discord-åtgärder.
  • Google Sheets: läs och skriv i ett kalkylark som du ansluter.
  • Shopify MCP: anslut en Shopify-butik via Shopify Storefront MCP-servern så att AI:n kan söka i din katalog och butikens policyer, läsa produktinformation och bygga en varukorg. Bara en Shopify MCP-åtgärd per scenario. Det omfattar inte orderuppslagning. Se noteringen nedan.

Varje AI-agent kan lagra upp till 15 åtgärder. Både aktiva och inaktiva åtgärder räknas mot denna gräns. Alla planer låter dig aktivera de åtgärder du skapar utan en separat plangräns för aktiva åtgärder. Ta bort en åtgärd som du inte längre behöver för att frigöra en plats; att inaktivera den frigör ingen plats.

Shopify Storefront MCP riktar sig till kunder och tillhandahåller inga orderdata. En AI-agent som bara är ansluten genom den kan därför inte slå upp en kunds order. Orderstatus kommer från en separat API-åtgärd, Check order status, som läser Shopify Admin API och konfigureras automatiskt när du installerar Quickchat-appen från Shopify App Store. Butiker som anslutits genom att klistra in en URL har ingen Admin-åtkomst och därför ingen orderuppslagning. Installera om via App Store om du behöver den.

  1. Välj en åtgärdstyp: API-åtgärd, MCP, HubSpot-åtgärd, Discord-åtgärd, Google Sheets eller Shopify MCP. Konfigurera anslutningen och instruktionerna som AI:n behöver.
  2. Under chatten använder AI:n normalt åtgärdsbeskrivningen och tillgängliga verktygs- eller parameteruppgifter för att avgöra när den ska köras. En API‑åtgärd kan i stället köras automatiskt före det första svaret eller när metadatavillkoren matchar för första gången.
  3. Quickchat kör anropet. För en åtgärd som AI:n väljer, eller en som körs före det första svaret, kan AI:n använda svaret. En metadatautlöst åtgärd körs tyst och resultatet läggs inte till i chatten.
  4. Testa eller anslut åtgärden i dess redigerare innan du använder den i konversationer.

Skriv beskrivningen som en instruktion till AI:n. Tala om när den ska använda åtgärden, vad den returnerar och eventuella begränsningar (till exempel ”anropa bara när användaren anger ett ordernummer”).

Skapa åtgärdsutkast från en beskrivning

Section titled “Skapa åtgärdsutkast från en beskrivning”
  1. I Åtgärder & MCPs väljer du + Lägg till åtgärd > API-åtgärd.
  2. Beskriv arbetsflödet, när Agenten ska agera, vilka API:er som ska användas (eller länka till deras dokumentation) och vilken information varje steg behöver. Klicka på Generera.
  3. Quickchat förbereder upp till fyra utkast till nya API-åtgärder, alla inaktiva. Resultatet kan rekommendera befintliga åtgärder i stället för att skapa dubbletter, eller be om mer information. Att generera utkast kör inte åtgärderna.
  4. Läs Befintliga åtgärder som används, eventuella förutsättningar och Nästa steg. Slutför konfigurationen, ersätt platshållarvärden och granska varje åtgärds request, instruktioner och körvillkor. Testa varje åtgärd innan du aktiverar utkasten eller nödvändiga befintliga åtgärder som är inaktiva.

Den föreslagna ordningen beskriver det avsedda beteendet. Den garanterar inte i vilken ordning AI:n väljer åtgärderna. Använd obligatoriska indata, sparat minne och körvillkor för att uttrycka beroenden. När du har aktiverat åtgärderna testar du hela flödet i en konversation.

  1. Gå till Åtgärder & MCPs.
  2. Klicka på + Lägg till åtgärd under Anpassade åtgärder, välj API-åtgärd och klicka sedan på Skapa manuellt.
  3. Fyll i Detaljer:
    • Namn: tydligt och beskrivande.
    • Beskrivning: när åtgärden ska användas och vad parametrarna ska innehålla.
  4. Under När den ska köras väljer du AI bestämmer, Före första svaret eller När metadata matchar.
  5. Konfigurera Anslutning:
    • API-begäransmetod: HTTP-metod (GET, POST med flera).
    • URL för API-slutpunkt: fullständig API-URL.
    • Headers: lägg till eventuella headers som behövs, till exempel Authorization eller content-type: application/json.
  6. Definiera Parametrar: ge varje parameter ett namn, en plats (query, body eller header) och en beskrivning som talar om för AI:n hur värdet ska sättas samman. Sökvägsvärden är ingen parameterplats. Infoga dem direkt i endpointens URL med {{placeholder}}-mallar.
  7. Test request och verifiera svaret. Klicka sedan på Klar.

Alla värdefält (URL, header, body eller query) accepterar dynamiska platshållare via knappen + Lägg till AI-data. Du kan infoga dina AI-parametrar, inbyggda konversationsvariabler ({{scenario_id}}, {{language}}, {{country}}, …) och konversationsmetadata ({{metadata_*}}). Se AI Action-variabler för hela referensen.

Utöver själva requesten har en API-åtgärd tre valfria inställningar värda att känna till: Spara i minnet, Kör endast när och Svarsfilter.

Förhandsgranska en API Action-förfrågan med en angiven mall och syntetiska exempelvärden. Utelämna headers med inloggningsuppgifter. Förhandsgranskningen fyller i requesten utan att skicka den.

För en åtgärd med AI bestämmer väljer du Inget standardvärde när AI:n måste hämta ett värde från konversationen. En obligatorisk parameter utan standardvärde kan inte skicka ett tomt värde. Ett avsiktligt tomt standardvärde är en annan inställning; befintliga tomma standardvärden förblir tomma. Redigeraren bevarar även numeriska standardvärden 0 och booleska standardvärden false.

För en text- eller talparameter öppnar du Alternativ för standardvärde bredvid standardvärdesfältet och väljer Inget standardvärde eller Tomt värde. Du kan ersätta ett tomt standardvärde med ett värde. För en boolesk parameter väljer du Inget standardvärde i rullgardinsmenyn.

Använd När den ska köras för att välja ett av tre lägen:

Avsnittet är hopfällt som standard och visar det aktiva läget bredvid rubriken. Fäll ut det för att byta läge.

Det expanderade avsnittet ”När den ska köras” med de tre lägena: AI bestämmer, Före första svaret och När metadata matchar

  • AI bestämmer: standardläget. AI:n läser åtgärdsbeskrivningen och avgör om besökarens request kräver åtgärden. Använd detta när åtgärden bara ska köras för vissa frågor eller efter att AI:n har samlat in information från besökaren.
  • Före första svaret: Quickchat kör åtgärden en gång efter att besökaren skickar sitt första meddelande och innan AI:n skriver sitt första svar. AI:ns vanliga svar får resultatet och alla värden som sparats med Spara i minnet. AI:n kan inte längre välja den här åtgärden som ett verktyg, så den körs bara i första turen och inte igen senare i konversationen. Använd detta för kundidentifiering, kontokontext, behörighetskontroller eller andra förberedelser som varje verklig konversation behöver.
  • När metadata matchar: Quickchat kontrollerar åtgärdens villkor under Kör när efter varje AI-tur och kör den första gången alla villkor matchar. Värden som en annan åtgärd sparar i minnet under samma tur blir tillgängliga direkt. AI:n kan inte välja den här åtgärden som ett verktyg och svaret läggs inte till i chatten. Använd läget för interna aviseringar, CRM-uppdateringar eller uppföljningsanrop som ska ske automatiskt när konversationsdata blir tillgängliga.

Före första svaret är kopplat till besökarens första meddelande, inte till att konversationen skapas. Att öppna en chatt eller ta emot ett välkomstmeddelande kör inte åtgärden, så övergivna chattar utlöser ingen request. Quickchat registrerar körningen innan endpointen anropas. Den körs därför inte igen i samma konversation, även om requesten misslyckas eller resultatet är osäkert.

Det första svaret väntar på requesten, så det här läget kan öka svarstiden. Om flera åtgärder använder läget körs de efter varandra och deras requesttider läggs ihop. Om nödvändig metadata saknas, endpointen inte är tillgänglig eller en request misslyckas svarar AI:n ändå. Öppna Begäranslogg på åtgärden för att se vad som hände.

Eftersom åtgärden körs innan AI:n kan välja parametervärden måste varje AI-parameter som används ha ett standardvärde. Metadata och inbyggda variabler kan infogas direkt i URL:en, headers, query eller body.

När metadata matchar kräver minst ett villkor under Kör när och ett standardvärde för varje AI-parameter. Quickchat registrerar försöket innan endpointen anropas, så när en request väl har skickats försöks åtgärden inte igen i samma konversation, oavsett om den lyckades, misslyckades eller fick ett osäkert resultat. En request som inte ens kunde byggas, för att ett värde den behöver saknas, registreras inte och är fortfarande möjlig i en senare tur. Åtgärden körs direkt efter att AI:n har avslutat sin tur, så ett fel ersätter aldrig AI:ns svar. På kanaler som inte strömmar svaret läggs requestens tid till besökarens väntetid.

När du väljer När metadata matchar visas redigeraren Kör när i samma avsnitt, så att utlösaren och dess villkor hålls ihop.

Avsnittet ”När den ska köras” inställt på ”När metadata matchar”, med två villkor under ”Kör när”: escalation_flag is true och order_id exists

För kanaler som kan tillhandahålla antingen en e-postadress eller ett telefonnummer skapar du en uppslagsåtgärd för varje identifierare. Ställ in båda som Före första svaret och lägg sedan till ett motsvarande villkor under Kör endast när, till exempel visitor_email exists eller visitor_phone_number exists. Quickchat skickar bara ett uppslagsanrop när motsvarande metadata finns.

Webhooks vid samtalets slut och transkript

Section titled “Webhooks vid samtalets slut och transkript”

En API-åtgärd kan meddela din webhook under en chatt. I AI bestämmer är en instruktion att anropa den vid avslut en begäran utan garanti för att den utförs. Standardlägena garanterar inget anrop när samtalet slutar, en besökare blir inaktiv eller en webbläsarflik stängs.

För ett exakt transkript behöver du definiera i din integration när samtalet räknas som avslutat. Skicka {{conversation_id}} till din backend och använd en behörig API-token med read_all för att hämta alla sidor av samtalshändelser, med limit och offset. Bygg transkriptet av meddelandehändelserna. Förvara token i din backend.

Det finns ingen inbyggd transkriptvariabel. En parameter med en AI-genererad sammanfattning eller ett transkript garanterar inte en exakt kopia. Se AI-åtgärdsvariabler för vilken kontext du kan skicka.

HubSpot-åtgärd öppnar ett galleri med förifyllda, redigerbara API-åtgärder som använder ditt anslutna HubSpot-konto.

Galleriet ”HubSpot CRM Actions” med ”Add Note to Ticket” under ”Tickets”

Mallen Lägg till anteckning i ärende skapar en privat anteckning i HubSpot-ärendet som är länkat till konversationen. Spara anteckningens innehåll i konversationens minne som hubspot_note_body, lägg sedan till mallen och aktivera den. Den är förkonfigurerad med När metadata matchar och väntar tills både hubspot_note_body och det hubspot_ticket_id som Quickchat tillhandahåller på serversidan finns. Du kan redigera standardvärdet för parametern note_body för att lägga till fast text runt {{metadata_hubspot_note_body}}.

Anteckningen är intern i HubSpot och visas inte för besökaren. Mallen försöker skicka requesten en gång per Quickchat-konversation. Öppna åtgärdens Begäranslogg för att bekräfta leveransen eller undersöka en misslyckad request.

Discord-åtgärder öppnar ett galleri med förifyllda, redigerbara API-åtgärder:

  • Support och ärenden: Öppna supportärende ber dig välja en server och en textkanal. Du kan även välja en supportroll som kan omnämnas, men det är valfritt. Den skapar tre åtgärder som öppnar en privat tråd, lägger till den som begär hjälp och publicerar en sammanfattning med ett valfritt omnämnande av rollen.
  • Moderering: Timeout för medlem, Kicka medlem, Banna medlem, Ta bort bannlysning, Tilldela roll, Ställ in slowmode och Skicka tillkännagivande. Varje mall installeras med ett klick och använder servern, medlemmen, rollen eller kanalen från aktuell Discord-request.

Quickchat skapar HTTP-metod, URL, headers, body, parametrar, beskrivning, svarsinställningar och körvillkor i backend. Korten som skapas är vanliga HTTP Request-åtgärder. Du kan granska och redigera varje fält.

Alla sju modereringsmallar innehåller villkoret author_is_admin is true under Kör endast när. Discord beräknar den aktuella avsändarens Administrator-behörighet, Discord-gatewayen tillhandahåller värdet och Quickchat kontrollerar det innan requesten skickas. Offentlig chatt och API-metadata kan inte ange den här nyckeln. Testa modereringsåtgärderna i Discord med både ett administratörskonto och ett konto som inte är administratör. AI Preview tillhandahåller ingen auktoriserad Discord-avsändare.

Modereringsåtgärderna är redigerbara. Om du tar bort eller försvagar villkoret author_is_admin is true tas den medföljande auktoriseringsgränsen bort. Kicka medlem och Banna medlem ber inte om bekräftelse innan de körs.

Mallarna lägger inte till någon egen automatisering. Agenten kör dem bara när en administratör ber om det i konversationen; det finns ingen räkning av strikes mellan konversationer, ingen kontroll av skärmdumpar eller andra bevis och inga schemalagda eller självinitierade sanktioner.

Boten behöver fortfarande den Discord-behörighet som varje request kräver:

ÅtgärdBotbehörighet eller åtkomst
Timeout för medlemModerate Members
Kicka medlemKick Members
Banna medlem, Ta bort bannlysningBan Members
Tilldela rollManage Roles
Ställ in slowmodeManage Channels
Skicka tillkännagivandeView Channels och Send Messages

Discord tillämpar också rollhierarkin. Placera botens roll över de medlemmar och roller som den ska hantera. Mallen gör ingen ytterligare kontroll av hierarkin eller enskilda behörigheter för administratören som skickar requesten.

Ställ in slowmode och Skicka tillkännagivande tar emot ett kanal-ID som parameter. Utan ett ytterligare fast mål verifierar mallen inte att kanalen tillhör servern där administratören skickade requesten. Om samma bot finns på flera servrar ska du redigera åtgärderna så att de använder ett fast kanal-ID, eller hålla servrarna inom separata tillitsgränser med olika Agenter och inloggningsuppgifter för botar.

Installationen av Support Ticket använder befintliga åtgärdsfunktioner för att skicka data:

  1. open_support_ticket skapar en privat tråd i den valda kanalen, fångar $.id och sparar det i konversationens minne som discord_ticket_thread_id. Den kräver discord_message is true, körs bara på den valda servern och bara så länge minnesnyckeln inte finns.
  2. add_ticket_requester läser {{metadata_discord_ticket_thread_id}} och det Discord-tillhandahållna {{metadata_discord_author_id}}. Den kräver discord_message is true och körs bara på den valda servern efter att tråd-ID:t finns.
  3. post_in_ticket läser samma sparade tråd-ID, publicerar Agentens enradsöversikt över ärendet och omnämner den som begär hjälp. Om du har valt en supportroll omnämns även den. Åtgärden har samma villkor för Discord-meddelande, server och sparad tråd. Fältet allowed_mentions i Discord-requestens body begränsas till den som begär hjälp samt den valda rollen, om en sådan har konfigurerats.

Beskrivningarna och Agentens huvudprompt ska tala om för Agenten att köra åtgärderna i den här ordningen. Det finns inget separat lager för arbetsflödesstatus, låsning, bekräftelse, återförsök, återställning, avstämning eller replay-skydd. Om resultatet är osäkert ska du kontrollera Discord och åtgärdsloggen innan du försöker igen, eftersom Discord redan kan ha slutfört requesten.

discord_ticket_thread_id rensas inte automatiskt. Mallen stöder därför ett ärende per Quickchat-konversation. Starta en ny Discord-konversation eller tråd för ett nytt ärende, eller redigera åtgärderna och lägg till den minneslivscykel du behöver.

För Support Ticket ska boten ha View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads och Manage Threads i den valda ärendekanalen. Låt Meddela en roll (valfritt) vara inställt på Meddela ingen roll om ingen roll ska omnämnas. Om du väljer en roll måste den kunna omnämnas och dess medlemmar behöver åtkomst till de privata trådarna. Om du inte väljer någon roll eller om inga roller som kan omnämnas är tillgängliga öppnas ärenden ändå som vanligt utan att en roll meddelas. Galleriet listar textkanaler och roller som kan omnämnas, men validerar inte alla kanalens behörighetsundantag.

Discord-åtgärder behöver token från din egen Discord-app under Externa appar → Discord → Avancerad konfiguration. Den delade boten med ett klick kan inte ensam tillhandahålla denna token. Se Discord.

Galleriet är en genväg för konfiguration, inte ett extra policylager. Om du redigerar en genererad åtgärd eller skapar en anpassad Discord API-åtgärd ska du granska autentiseringsuppgifter, mål, parametrar, svarsexponering och villkoren under Kör endast när innan du aktiverar den.

Spara ett värde från en åtgärds indata eller API-svar i konversationens minne under en nyckel du väljer. Senare åtgärder kan återanvända det som {{metadata_<key>}}, och det syns i konversationens detaljer (Inkorgen, API:t och exporter).

Ta till detta när en åtgärd producerar något som en senare åtgärd behöver. En uppslagsåtgärd kan spara ett customer_id från sitt svar; en uppföljande åtgärd skickar sedan {{metadata_customer_id}} utan att AI:n behöver kopiera värdet mellan dem.

Öppna Spara i minnet i API-åtgärdens editor och lägg till en rad:

  1. Välj en Källa. API-svar läser API:ts JSON-svar och är standard för nya rader. Åtgärdens indata läser värdena för åtgärdens deklarerade indataparametrar.
  2. Under Värde att spara väljer du parametern i rullgardinsmenyn för Åtgärdens indata. För API-svar anger du ett JSONPath-uttryck, till exempel $.customer_id.
  3. Välj en Minnesnyckel. Vanliga engelska namn på indatafält för namn, telefon och e-post ger förslag på motsvarande besökarnyckel. Du kan behålla förslaget eller ange en egen nyckel.

Använd Åtgärdens indata med dessa mappningar för att spara kontaktuppgifter i Inkorgen:

Action-parameterMinnesnyckel
Name eller Full namevisitor_name
Phone number eller Phonevisitor_phone_number
Email eller Email addressvisitor_email

Indataparametern måste vara deklarerad i åtgärden. Att spara den med en minnesregel för Åtgärdens indata räknas som att använda parametern, så värdet kan samlas in för minnet utan att skickas i HTTP-requesten. Dessa besökarnycklar fyller i tidigare osatta kontaktfält i Inkorgen och konversationsmetadata med samma validering som Smart datainsamling. Befintliga kontaktuppgifter och fält som uttryckligen har rensats av en operatör bevaras. Regler för API-svar kan inte skriva till dessa besökarnycklar. Använd en anpassad nyckel som customer_id för värden från CRM-svar.

Indata sparas när åtgärden har klarat kontrollerna av obligatoriska indata och körvillkor, före HTTP-requesten. Giltiga kontaktuppgifter finns därför kvar om API:t returnerar ett fel eller om tidsgränsen överskrids. Verifiera dem genom att köra åtgärden i en ny konversation i Förhandsvisning och öppna den konversationen i Inkorgen. Editorns isolerade API-test har ingen konversation där minnet kan sparas.

Minnesnycklar delas med agentens Remote MCP-verktyg. Om ett MCP-verktyg redan sparar till samma nyckel rapporterar fältet Minnesnyckel konflikten när du sparar, så välj en annan nyckel. Remote MCP-verktyg fortsätter att spara värden från sina resultat.

Använd snake_case-nycklar (bokstäver, siffror, understreck). En nyckel som customer_id kan refereras som {{metadata_customer_id}}; nycklar med mellanslag eller annan interpunktion kan inte användas i platshållare. Se Konversationsmetadata för hur metadatavariabler fungerar.

Begränsa en åtgärd så att den körs endast när villkoren för konversationsmetadata är uppfyllda. Villkoren kontrolleras alltid på vår sida, utanför modellen. Med AI bestämmer eller Före första svaret kontrollerar Quickchat dem omedelbart innan requesten skickas. Med När metadata matchar utlöser villkoren själva requesten efter en AI-tur, utan att vänta på att AI:n ska välja åtgärden.

Detta är rätt verktyg för privilegierade eller oåterkalleliga åtgärder (banna en medlem, utfärda en återbetalning, radera en post). En rad i din prompt som säger ”bara administratörer kan göra detta” är en hjälpsam instruktion, men det är ingen säkerhetsgräns: en målmedveten användare kan argumentera med modellen eller försöka med en prompt-injektion. Ett körvillkor är deterministiskt och lever utanför prompten, så det håller oavsett vad konversationen säger.

  • Körvillkoret är gränsen. Det utvärderas på serversidan och är inte en del av prompten modellen läser. Det är detta som faktiskt hindrar åtgärden från att köras.
  • Promptregeln är användarupplevelsen. Behåll en rad i prompten också, så att AI:n avböjer artigt och förklarar varför i stället för att tystna.

Lägg till villkor i sektionen Kör endast när i åtgärdens editor. För en åtgärd med När metadata matchar heter sektionen Kör när. Klicka på Lägg till villkor, välj en metadatanyckel (till exempel telegram_sender_is_admin) och välj hur den ska jämföras:

VillkorUppfylls när metadatavärdet…
är santär sant (truthy)
är falsktär falskt (falsy)
finnsfinns på konversationen
finns intesaknas
är lika medmatchar ett värde du anger
är inte lika medskiljer sig från ett värde du anger
är ett avmatchar exakt något av värdena i listan, inklusive stora och små bokstäver och blanktecken
innehåller textär text som innehåller den angivna bokstavliga texten, med hänsyn till stora och små bokstäver

Åtgärden körs bara när alla villkor är uppfyllda. Editorn visar OCH mellan raderna. När ett villkor blockerar en åtgärd som AI:n har valt kan AI:n förklara att åtgärden inte är tillgänglig. En åtgärd med När metadata matchar förblir tyst tills villkoren uppfylls.

Använd är ett av för alternativ för samma nyckel och ange varje alternativ som en separat värdebricka. Till exempel kan modelName is one of [K-65XR95M2, K-75XR95M2, K-85XR95M2] kombineras med country equals UK. Båda raderna måste vara uppfyllda. Du kan lägga till upp till 50 alternativ med upp till 500 tecken vardera. Kommatecken är bokstavliga delar av ett värde. Separata är lika med-rader med olika värden för samma nyckel kan inte alla vara uppfyllda.

innehåller text söker efter en bokstavlig delsträng, inte ett jokertecken eller ett reguljärt uttryck. XR95M2 matchar även varianter av modellnamnen utöver de tre som anges ovan. Inget av de nya villkoren matchar saknade nycklar, null, listor eller objekt. innehåller text matchar inte heller tal eller booleska värden. Tom jämförelsetext är inte tillåten. De befintliga villkoren är falskt, är inte lika med och finns inte kan matcha saknade nycklar.

Sektionen Kör endast när med ett villkor: telegram_sender_is_admin is true

När ett villkor inte uppfylls skickas ingen request och AI:n talar om för användaren att den inte kan göra det. Nedan blockeras samma ban-request för en icke-administratör och tillåts för en administratör, utan att något ändrats förutom vem som frågar:

En icke-administratörs ban-försök blockerat av körvillkoret: ingen request skickas och resultatet är ett nekande

Samma ban-request från en administratör: körvillkoret uppfylls och åtgärden returnerar 200

Sätt endast villkor på metadata som Quickchat sätter (såsom en kanal-verifierad telegram_sender_is_admin-flagga), inte på värden som besökaren kan påverka. Se Konversationsmetadata för var varje nyckel kommer ifrån.

Som standard ser AI:n hela API‑svaret. Lägg till JSONPath-uttryck i sektionen Svarsfilter för att begränsa AI:n till specifika delar av det.

Två vanliga skäl att filtrera:

  • Dölj känsliga fält. Håll kunders e-postadresser, betalningsuppgifter eller interna id:n utanför modellens kontext när endpointen returnerar mer än AI:n behöver.
  • Krymp prompten. Pratglada API:er kan returnera stora payloads; att filtrera till de få fält som spelar roll håller svaret litet och AI:n fokuserad.

Lägg till ett eller flera JSONPath-uttryck. Filtret behåller de valda fälten i de objekt och arrayer som innehåller dem, i stället för att platta ut dem till en lista med värden. Fält utanför de valda sökvägarna utelämnas. Använd till exempel dessa två rader:

  • $.customer.name
  • $.orders[*].id

Med detta API-svar:

{
"customer": {"name": "Ada", "email": "ada@example.com"},
"orders": [{"id": 101, "total": 25}, {"id": 102, "total": 40}]
}

AI:n får följande filtrerade svar, där customer fortfarande är ett objekt och orders fortfarande är en array med objekt:

{
"customer": {"name": "Ada"},
"orders": [{"id": 101}, {"id": 102}]
}

Använd panelen Test Response för att se exakt vad AI:n får efter filtrering innan du förlitar dig på det. Se Testa din Action.

Ett JSONPath som inte matchar något lämnar AI:n med ett tomt svar. Börja utan filter, bekräfta att anropet fungerar och skärp det sedan.

Sektionen Svarsfilter i API‑åtgärdens editor

Förhandsgranska JSONPath-träffar i ett angivet JSON-svar. Förhandsgranskningen stöder rot-, fält-, arrayindex- och jokerteckensökvägar för regler under Svarsfilter eller Spara i minnet.

En varning bredvid Åtgärder & MCPs i sidofältet betyder att en åtgärd behöver uppmärksamhet. Öppna sidan och håll muspekaren över eller fokusera statusmärket på åtgärdens kort för att se varför:

  • Misslyckas: de senaste anropen har misslyckats upprepade gånger. Statusmärket visar antalet misslyckanden och det senaste felet när det finns tillgängligt.
  • Körs inte: åtgärden har hoppats över upprepade gånger, utan några utförda anrop under den aktuella perioden för hälsobedömningen. Kontrollera den angivna orsaken, till exempel saknade konversationsvärden eller ett konfigurationsproblem.
  • Behöver återanslutas: en MCP-anslutning förlorade sin auktorisering och stängdes av. Öppna Redigera, återanslut den och slå på den igen.

Hälsobedömningen bygger på riktiga konversationer från de senaste sju dagarna, eller sedan åtgärden senast redigerades om det skedde senare. Testanrop ingår inte. När du har korrigerat och sparat en åtgärd, kontrollera nya konversationer för att bekräfta att korrigeringen fungerar. Att en gammal varning försvinner bevisar inte i sig att åtgärden fungerar.

För Misslyckas eller Körs inte, klicka på Visa detaljer för att öppna Begäranslogg med Endast problem aktiverat. Visa loggar öppnar loggen med alla anrop. Stäng av Endast problem för att jämföra problematiska anrop med lyckade anrop.

Överhoppade konversationer listar konversationer där åtgärden inte kunde köras, separat från anrop som utfördes. Använd Visa konversation för att granska sammanhanget och Visa fler för att läsa in äldre poster. En åtgärd kan köras framgångsrikt i vissa konversationer och hoppas över i andra, så den här listan kan visas även utan ett varningsmärke.

När orsaken anger saknade värden som {{metadata_visitor_email}}, ange dem via metadata från din webbplats eller kanal, eller låt en tidigare åtgärd spara dem i minnet. Kontrollera sedan körläget:

  • AI bestämmer: åtgärden erbjuds till AI:n endast i konversationer som redan har de nödvändiga värdena.
  • Före första svaret: värdena måste finnas när besökaren skickar det första meddelandet.
  • När metadata matchar: lägg till ett finns-villkor för varje nödvändigt värde så att åtgärden väntar på det.

Se Variabler för AI-åtgärder för var konversationsvärden kommer ifrån.

E-postmeddelanden med aktivitetssammanfattningar innehåller också avsnittet AI Actions need attention när en HTTP-åtgärd eller en fjärransluten MCP-åtgärd behöver uppmärksamhet. Där listas upp till fem åtgärder, med en orsak och en länk till Åtgärder & MCPs. Om fler åtgärder behöver uppmärksamhet visas också antalet ytterligare åtgärder. Avsnittet utelämnas när allt fungerar som det ska.

E-postmeddelandet visar den aktuella hälsobedömningen, som kan omfatta en längre period än den dagliga sammanfattningens aktivitetsperiod. När du har åtgärdat och sparat en API-åtgärd utgår hälsobedömningen från den redigeringen. När du återansluter eller kopplar från en berörd MCP-anslutning rensas dess auktoriseringsvarning. Befintliga inställningar för sammanfattningar via e-post och regler för vem som får dem gäller fortfarande, och inget separat varningsmeddelande skickas.

  • Var tydlig i beskrivningar. Tala om för AI:n när åtgärden ska användas och vad varje parameter ska innehålla.
  • Håll behörigheterna minimala. Ta bara med de headers och token som endpointen behöver. För Jira använder du Basic-headern som skapas från din Atlassian-e-postadress och API-token.
  • Testa före driftsättning med panelen Test request. Kontrollera att statuskoder och exempelpayloads ser rätt ut i målverktyget.

Senast uppdaterad: