Tools voor VoiceAgent

In dit artikel leert u hoe VoiceAgent Tools realtime acties tijdens live gesprekken mogelijk maken doordat uw VoiceAgent rechtstreeks kan communiceren met externe systemen via API.Door Tools te gebruiken, maakt u van uw VoiceAgent een volwaardige probleemoplosser, wat de automatisering verbetert en zorgt voor snellere, slimmere klantervaringen.

Gebruikersniveau: Admin

Wat zijn Tools?

Met Tools kan uw VoiceAgent tijdens een gesprek specifieke acties uitvoeren door API-verzoeken te sturen naar systemen van derden. U kunt precies configureren wat elke tool doet en wanneer deze moet worden geactiveerd op basis van het gesprek. Bijvoorbeeld:

Een klant vraagt: “Waar is mijn bestelling?” → De VoiceAgent gebruikt een tool om de laatste trackinggegevens op te halen.
Een patiënt zegt: “Kan ik mijn afspraak verzetten naar vrijdag?” → De VoiceAgent roept uw boekings-API aan om beschikbaarheid te controleren en de afspraak te verzetten.

Andere voorbeeldgebruikssituaties:

Gegevens ophalen:
- Details van een supportticket opzoeken
- Realtime prijs- of beschikbaarheidsinformatie raadplegen
Acties uitvoeren:
- Een CRM-contact bijwerken
- Een terugbetaling activeren

Een tool maken

Ga om te beginnen naar Dashboard > VoiceAgents > Toolbeheer en klik vervolgens op de ➕-knop rechtsboven of selecteer Een tool maken om het configuratiescherm te openen waarin u kunt bepalen hoe uw nieuwe tool werkt.

Hieronder ziet u hoe u elk onderdeel configureert:

Referentie toolvelden

Veld	Beschrijving
Toolnaam	Een duidelijke, beschrijvende naam die de VoiceAgent helpt te bepalen wanneer deze tool moet worden gebruikt. Gebruik namen zoals `book_meeting`, `update_contact` of `trigger_refund`. Alleen de volgende tekens zijn toegestaan: `a-z`, `A-Z`, `0-9`, `_`, `-`
Toolbeschrijving	Beschrijf in natuurlijke taal wat de tool doet en wanneer deze moet worden gebruikt. Dit helpt de AI te begrijpen in welke situaties de tool moet worden geactiveerd.
Bericht in afwachting van antwoord	Een kort bericht dat de VoiceAgent afspeelt terwijl deze wacht op het API-antwoord. Dit helpt stiltes tijdens de uitvoering te overbruggen. Voorbeeld: `Let me check that for you. One moment please.`
Methode en eindpunt	De HTTP-methode en het API-eindpunt die de tool zal aanroepen. Bijvoorbeeld: `GET https://api.example.com/orders`
Headers	Definieer de headers die de API vereist. Dit zijn meestal constanten zoals `Authorization`, `Content-Type` of versioneringsheaders.
Pad-parameters	Wordt gebruikt om dynamische waarden in te vullen binnen de eindpunt-URL (bijvoorbeeld `#{{customer_id}}` in `https://api.acme.com/#{{customer_id}}/orders`).
Body-parameters	Alleen beschikbaar voor de methoden `POST`, `PUT` en `PATCH`. Definieer de velden die in de request body moeten worden verzonden.

Parameters begrijpen

Bij het definiëren van een tool helpen parameters de VoiceAgent om de juiste waarden door te geven aan uw API. Er zijn drie hoofdtypen parameters die u kunt gebruiken in zowel pad- als body-definities:

Parametertypen

Type	Beschrijving
Constante	Een vaste waarde die voor elke API-aanroep hetzelfde blijft. Handig wanneer u precies weet welke waarde u elke keer wilt verzenden.
Parameter	Een dynamische waarde die wordt verzonden vanuit uw system prompt. Hier verwijst u naar een variabelenaam die moet overeenkomen met de naam die wordt meegestuurd in uw triggerende API-verzoek.
LLM-prompt	Een instructie in natuurlijke taal aan de AI over hoe een waarde uit het gesprek moet worden gehaald. Het meest geschikt wanneer de invoer afhangt van wat de beller zegt.

Elke parameter heeft ook een Gegevenstype dat bepaalt hoe de waarde wordt opgemaakt in het API-verzoek. Beschikbare typen:

String, Integer, Number, Boolean werken als eenvoudige scalaire waarden.

Lijst verzendt de waarde als een JSON-array (bijvoorbeeld "recipients": ["[email protected]", "[email protected]"]). Wanneer u Lijst selecteert, kiest u ook een elementtype (Lijst van String, Lijst van Integer, enzovoort). Als de agent slechts één waarde haalt, wordt deze automatisch in een array met één element geplaatst in plaats van dat het mislukt.

Object verzendt de waarde als een JSON-object. Objectparameters zijn alleen beschrijvend: de agent krijgt te horen dat de parameter een object is en ziet uw beschrijving, maar kent de specifieke veldnamen niet en kan daardoor de interne structuur niet afdwingen. Dit werkt goed voor eenvoudige pass-through-payloads.

Pad-parameters

Dit zijn waarden die rechtstreeks in de URL worden geplaatst. U definieert ze met accolades in de eindpunt-URL, zoals #{{customer_id}}. Zo werkt dit in de praktijk: Voorbeeldeindpunt:
https://api.acme.com/#{{customer_id}}/orders In dit geval wordt customer_id een pad-parameter. Als gedefinieerd als Parameter:

Parameter	Waardebron
`customer_id`	`customer_identifier`-variabele uit de system prompt

Voorbeeld van triggerend verzoek:

{
    "call_number": "++44123123123",
    "voice_agent_id": "6819f0e147851f618cd6aed6",
    "call_properties": {
        "system_prompt": {
            "variables": {
                "customer_identifier": "abc123",
            }
        }
    }
}

Dit resulteert in een aanroep naar:
https://api.acme.com/abc123/orders Om te extraheren via LLM-prompt:
Gebruik een duidelijke instructie zoals:
“Extraheer de klant-ID die de beller noemt, als deze wordt gegeven. Vraag ernaar als de beller dit niet uit zichzelf doet.”

Body-parameters

Voor de methoden POST, PUT en PATCH moet u mogelijk een request body verzenden. Deze werken op dezelfde manier als pad-parameters en kunnen ook constanten, system prompt-variabelen of LLM-prompts gebruiken. Geneste objecten kunnen worden gedefinieerd met puntnotatie. Voorbeelddefinitie:

Parameter	Type	Waarde
`customer_id`	Parameter	`customer_identifier`
`attendee.email`	LLM-prompt	“Extraheer het e-mailadres van de klant uit het gesprek.”
`recipients`	LLM-prompt	”Extraheer alle e-mailadressen die de beller noemt.”

Triggerend verzoek:

{
    "call_number": "++44123123123",
    "voice_agent_id": "6819f0e147851f618cd6aed6",
    "call_properties": {
        "system_prompt": {
            "variables": {
                "customer_identifier": "abc123",
            }
        }
    }
}

Dit verzoek resulteert in de volgende body:

{
  "customer_id": "abc123",
  "attendee": {
    "email": "[email protected]"
  },
  "recipients": ["[email protected]", "[email protected]"]
}

Tools toewijzen aan VoiceAgents

Met Tools kunnen VoiceAgents tijdens een gesprek specifieke acties uitvoeren, zoals het activeren van externe workflows, het verzenden van gegevens naar andere systemen of het beëindigen van het gesprek. Eén VoiceAgent kan meerdere Tools gebruiken en dezelfde Tool kan worden gebruikt door meerdere VoiceAgents. Tools worden geactiveerd als acties binnen een VoiceAgent-scenario. Dit betekent dat de VoiceAgent een Tool alleen gebruikt wanneer de situatie die in het scenario is gedefinieerd zich tijdens het gesprek voordoet. Een tool binnen een scenario gebruiken:

Ga naar het gedeelte Scenario’s & Guardrails van de VoiceAgent-configuratie.
Maak een nieuw Scenario aan of bewerk een bestaand scenario.
Definieer de situatie waarin de Tool moet worden gebruikt.
Selecteer in het veld Actie de optie Tool-aanroep.
Kies in de vervolgkeuzelijst Tools de Tool die u door de VoiceAgent wilt laten gebruiken.
Sla de configuratie op.

Zodra dit is geconfigureerd, gebruikt de VoiceAgent automatisch de geselecteerde Tool wanneer tijdens een gesprek aan de scenariovoorwaarden wordt voldaan.

Tips voor het effectief gebruiken van Tools

Gebruik duidelijke en beschrijvende toolnamen
Geef elke tool een naam die duidelijk weergeeft wat deze doet. Vermijd afkortingen of interne codes.
- Goed: trigger_refund, get_order_status, book_appointment
- Niet zo goed: rfnd_tool_v1, statusQ, app_sched_new
Schrijf een beschrijving in natuurlijke taal
Leg in het veld Toolbeschrijving uit wanneer en waarom de VoiceAgent de tool moet gebruiken. Voeg voor complexe tools een korte beschrijving toe voor elk argument dat de agent moet verzamelen.

Hulp nodig of een vraag? Neem gewoon contact met ons op via ons Supportportal — we staan voor u klaar.

Aan de slag

Nummers & portering

AI

AI Sales Dialer

CloudTalk Phone & Go

Berichten

Dashboard

Integraties

Facturering & abonnement

Technisch nieuws & updates

Oude Dashboard

Wat zijn Tools?

Een tool maken

Referentie toolvelden

Parameters begrijpen

Parametertypen

Pad-parameters

Body-parameters

Tools toewijzen aan VoiceAgents

Tips voor het effectief gebruiken van Tools

​Wat zijn Tools?

​Een tool maken

​Referentie toolvelden

​Parameters begrijpen

​Parametertypen

​Pad-parameters

​Body-parameters

​Tools toewijzen aan VoiceAgents

​Tips voor het effectief gebruiken van Tools

Wat zijn Tools?

Een tool maken

Referentie toolvelden

Parameters begrijpen

Parametertypen

Pad-parameters

Body-parameters

Tools toewijzen aan VoiceAgents

Tips voor het effectief gebruiken van Tools