Een eigen actie maken

Aangepaste acties staan in Admin Center en niet bij de AI-agent, en één definitie bedient auto assist, AI-agents en action flows.

Een AI-agent koppelen aan een van je systemen. Twee dingen staan niet waar mensen ze zoeken: aangepaste acties staan in Admin Center in plaats van bij de AI-agent, en één definitie bedient auto assist, AI-agents en action flows tegelijk.

Er een maken

1. Klik in Admin Center op Apps en integraties en kies Actions en Custom actions.
2. Klik op Create custom action en geef een Name en een Description.
3. Voeg elke Input toe met een Name, een Description en een Type: String, Integer, Decimal, Boolean, Date, Datetime of Array.
4. Stel de Request method en de Endpoint URL in. Alleen https:// is toegestaan, en het eindpunt moet antwoorden met JSON én de header content-type: application/json. Een eindpunt dat er in een browser prima uitziet maar iets anders terugstuurt, faalt hier zonder te zeggen waarom.
5. Kies onder Authentication een bestaande API-verbinding.
6. Voeg zo nodig Query parameters, Headers en een Body toe. Gebruik de knop {+} om je inputs in de body te zetten.
7. Definieer elke Output met een Name en een Description, en test daarna, inclusief de storingen.

De limieten, die het ontwerp bepalen

De time-out van tien seconden is degene die de architectuur bepaalt. Een actie die een traag backoffice bevraagt haalt die niet, en het antwoord is een sneller eindpunt en niet een langer gesprek.

Heb je acties van vóór 13 maart 2025, dan moeten die worden bijgewerkt voordat ze in action flows bruikbaar zijn.

Beschrijf hem voor het systeem, niet voor uzelf

De Description is wat het systeem gebruikt om te bepalen wanneer de actie moet worden ingezet. "Zoekt de status en verwachte leverdatum van een bestelling op ordernummer" is bruikbaar. "Order API v2" niet.

Vraag het minimum

Elke input is iets wat de klant moet aanleveren voordat er iets gebeurt. Een actie die drie gegevens nodig heeft, komt vaak niet rond, want mensen haken af bij de tweede vraag.

Geef terug wat het antwoord nodig heeft

Definieer outputs voor de velden die je echt gebruikt, niet het hele record. Honderd outputs mogen; drie maken het antwoord voorspelbaar en houden gegevens uit het gesprek die er niet in hoefden.

Inloggegevens horen in een verbinding

Zendesk is er expliciet over: zet geen inloggegevens in de configuratie van de aangepaste actie, maar gebruik een verbinding, want die zijn gebouwd om dat veilig te bewaren. Beperk het account erachter tot precies wat de actie doet, zodat een fout niet verder kan reiken dan bedoeld.

Storingen zijn het ontwerp

Systeem onbereikbaar, niets gevonden, dubbelzinnige match, geen rechten, en de time-out hierboven. Elk daarvan heeft een vastgelegde uitkomst nodig, en overdragen aan een mens is er een prima. Een actie zonder storingsafhandeling levert gesprekken op die midden in een zin stoppen.

Test hem voordat hij in een gesprek zit

Controleer de aanroep eerst op zichzelf. Een actie debuggen binnen een lopende uitwisseling betekent twee systemen en een taalmodel tussen je en de fout.

Zie ook

• Acties testen
• Acties beheren
• Wat acties zijn en wat een AI-agent ermee kan