Acties in je eigen systemen starten tijdens een gesprek

Met de skill Externe actie kan je AI-agent tijdens een lopend gesprek API-aanroepen in realtime uitvoeren.

Dat is handig als je agent direct informatie moet ophalen of versturen, bijvoorbeeld een bestelstatus controleren, een boeking verifiëren of een prijs berekenen terwijl de beller nog aan de lijn is.

Door je externe systemen via een API te koppelen, heeft de agent toegang tot actuele gegevens en antwoordt hij direct, zodat het gesprek levendig en correct blijft.

Externe actie is dezelfde skill als de modus "tijdens het gesprek" van API Aanroepen. De volledige referentie, inclusief Results en Path, vind je in API Aanroepen — tijdens het gesprek.

Wanneer je hem gebruikt

Gebruik deze skill als je agent:

• gegevens in realtime moet ophalen of bijwerken terwijl hij met de beller praat.
• een actie moet uitvoeren op basis van wat de klant zegt (bijvoorbeeld de zendingsstatus controleren of een lidmaatschap verifiëren).
• live informatie uit je systeem moet geven, zoals prijzen, beschikbaarheid of accountgegevens.

Zo werkt het

De skill voert tijdens het gesprek een API-verzoek uit, gestart door de logica die je in het Hoofddoel van de agent vastlegt.

Je kunt instellen:

• API-methode: GET of POST.
• Parameters: informatie die de API nodig heeft (zoals een bestelnummer of e-mail).
• Headers: authenticatie of eigen headers (bijvoorbeeld Authorization: Bearer token).
• Results: welke waarden uit het API-antwoord de AI moet lezen en gebruiken.

De agent roept dan je API aan, verwerkt het resultaat en gebruikt het op een natuurlijke manier in zijn antwoord aan de beller.

Instellen

1. Ga naar Agent → Vaardigheden → Externe actie.
2. Vul de volgende velden in:
   • Actienaam: een duidelijke naam (bijvoorbeeld check_order_status).
   • Beschrijving: wat de actie doet (bijvoorbeeld "Zendinginformatie ophalen").
   • API-endpoint: de URL van de API.
   • Methode: GET of POST.
   • Parameters (optioneel): de invoerwaarden die je API nodig heeft (bijvoorbeeld order_number, email).
   • Results (optioneel): de verwachte sleutels in het antwoord (bijvoorbeeld status, estimated_delivery_date).
   • Header (optioneel): benodigde headers, zoals autorisatietokens.
3. Zet Vaardigheid inschakelen aan.
4. Klik op Creëren.

Voorbeeldinstructie

Omdat de externe actie tijdens het gesprek draait, moet je in het Hoofddoel duidelijk vastleggen wanneer de AI hem start. Bijvoorbeeld:

Wil de beller de leverstatus van zijn bestelling weten, gebruik dan de externe actie check_order_status met de parameter order_number die de beller noemt. Vertel hem daarna de huidige status en de verwachte leverdatum.

Zo weet de agent precies wanneer hij de API aanroept en hoe hij het resultaat gebruikt.

Voorbeeld: zending volgen

Scenario: een klant belt en vraagt: "Waar is mijn pakket?"

Configuratie:

• Actienaam: check_order_status
• API-endpoint: https://api.shippingcompany.com/tracking
• Methode: GET
• Parameter: order_number (Tekst)
• Results: status, estimated_delivery_date

Voorbeeldinstructie:

Vraagt de beller naar zijn leverstatus, roep dan de externe actie check_order_status aan. Beantwoord de vraag duidelijk met de resultaatvelden {{status}} en {{estimated_delivery_date}}.

Voorbeeldgesprek:

Beller: "Kun je me vertellen waar mijn pakket is?"

AI-agent: "Natuurlijk, kun je me je bestelnummer geven?"

(De agent roept de API in realtime aan.)

AI-agent: "Je pakket is onderweg en wordt naar verwachting op 24 oktober bezorgd."

Andere voorbeelden

• Lidmaatschap controleren: "Noemt de beller zijn lidnummer, gebruik dan check_membership_status om te controleren of zijn account actief is."
• Prijs opvragen: "Vraagt de beller om een offerte, start dan de actie get_price_estimate met de productnaam en het aantal."

De skill Externe actie geeft je AI-agent live toegang tot je systemen: hij kan informatie ophalen, gegevens controleren of acties in realtime uitvoeren terwijl het gesprek natuurlijk blijft.