Een actie maken

Een actie definiëren: waar hij aanroept, wat hij nodig heeft, wat hij teruggeeft, en de omschrijving die bepaalt of AI hem goed gebruikt.

Een actie definiëren: waar hij aanroept, wat hij nodig heeft, wat hij teruggeeft, en de omschrijving die bepaalt of AI hem goed gebruikt.

Een actie maken

1. Open het Beheercentrum, dan Apps en integraties > Acties > Aangepaste acties, en klik op Create custom action.
2. Noem hem naar wat hij doet en schrijf de omschrijving. Zie hieronder, want dat is het veld dat het zwaarst telt.
3. Definieer de invoer. Elk invoerveld wordt een plaatsaanduiding die je in de URL, de inhoud, de queryparameters of de headers kunt zetten, en geef het het juiste gegevenstype: integer, decimal, string of boolean.
4. Bouw de API-aanroep: het eindpunt, de methode, de authenticatie, en waar die plaatsaanduidingen terechtkomen.
5. Definieer de uitvoer: welke delen van het antwoord Zendesk moet teruggeven, en als wat.
6. Test hem via het optiemenu met Test, vul per invoerveld een waarde in en klik op Make API call.

Die drie delen, invoer, API-aanroep en uitvoer, zijn de hele vorm van een actie. Kun je ze benoemen voor de handeling die je voor ogen hebt, dan kun je hem bouwen; kun je dat niet, dan zit het probleem in de handeling en niet in het gereedschap.

De omschrijving is geen documentatie

Het belangrijkste veld, en het veld dat er het minst belangrijk uitziet. Als een AI-agent bepaalt welke actie hij aanroept, bepaalt hij dat op basis van de omschrijving.

Een vage omschrijving levert een agent op die de verkeerde actie aanroept of helemaal geen. Wees specifiek over wat hij doet, wat hij nodig heeft en wanneer hij geldt: "Zoekt de bezorgstatus van een order op aan de hand van het ordernummer. Gebruiken wanneer een klant vraagt waar zijn bestelling blijft."

Geef invoervelden heldere namen

Om dezelfde reden, en het is meer dan netheid: de naam van het invoerveld is waar de AI iets uit het gesprek aan moet koppelen. Een invoerveld dat ordernummer heet wordt begrepen; een veld dat param1 heet niet, en dan moet iets raden wat erin hoort. Het gegevenstype telt om dezelfde reden, want een ordernummer dat als string wordt getypt en als integer wordt verwacht mislukt op een manier die niemand kan lezen.

Vang het misgaan op

Beslis wat er gebeurt als het andere systeem plat ligt of niets teruggeeft. Een actie zonder gedefinieerd gedrag bij falen laat een AI-agent improviseren waar een klant bij is, en dat is precies waar je geen improvisatie wilt.

Test met echte invoer

Ook de invoer die zou moeten mislukken: een ordernummer dat niet bestaat, een klant zonder orders. Dat zijn de gevallen die voorkomen, en het zijn de gevallen die niemand test.

Zie ook

• Acties testen in de actiesamensteller
• Een actieworkflow bouwen
• Een eigen actie maken