Webhooktools

Tools stellen je assistent in staat verbinding te maken met externe gegevens en systemen. Je kunt een set tools definiëren waartoe de assistent toegang heeft. De assistent gebruikt deze waar nodig op basis van het gesprek.

Overzicht

Veel applicaties vereisen dat assistenten externe API’s aanroepen om realtime informatie op te halen. Tools geven je assistent de mogelijkheid om externe functieaanroepen naar apps van derden te doen, zodat je realtime informatie kunt ophalen.

Hier zijn enkele voorbeelden waarin tools nuttig kunnen zijn:

• Gegevens ophalen: stel een assistent in staat om realtime gegevens op te halen uit een database met REST-ondersteuning of een integratie van derden voordat deze de gebruiker antwoordt.
• Acties uitvoeren: laat een assistent geauthenticeerde acties activeren op basis van het gesprek, zoals vergaderingen inplannen of retourzendingen starten.

Toolconfiguratie

ElevenLabs-agents kunnen worden uitgerust met tools om te communiceren met externe API’s. Anders dan bij traditionele requests genereert de assistent query-, body- en pathparameters dynamisch op basis van het gesprek en de parameterbeschrijvingen die je opgeeft.

Alle toolconfiguraties en parameterbeschrijvingen helpen de assistent te bepalen wanneer en hoe deze tools gebruikt moeten worden. Werk de systeemprompt van de assistent bij om het gebruik van tools effectief te orkestreren en de volgorde en logica voor deze aanroepen te specificeren. Dit omvat:

• Welke tool je onder welke voorwaarden gebruikt.
• Welke parameters de tool nodig heeft om goed te functioneren.
• Hoe je de responses verwerkt.

Handleiding

In deze handleiding maken we een weerassistent die realtime weersinformatie voor elke locatie kan geven. De assistent gebruikt geografische kennis om locatienamen om te zetten in coördinaten en nauwkeurige weergegevens op te halen.

You are a helpful conversational agent with access to a weather tool. When users ask about
weather conditions, use the get_weather tool to fetch accurate, real-time data. The tool requires
a latitude and longitude - use your geographic knowledge to convert location names to coordinates
accurately.
Never ask users for coordinates - you must determine these yourself. Always report weather
information conversationally, referring to locations by name only. For weather requests:
1. Extract the location from the user's message
2. Convert the location to coordinates and call get_weather
3. Present the information naturally and helpfully
For non-weather queries, provide friendly assistance within your knowledge boundaries. Always be
concise, accurate, and helpful.
First message: "Hey, how can I help you today?"

Ondersteunde authenticatiemethoden

ElevenLabs Agents ondersteunt meerdere authenticatiemethoden om je tools veilig te verbinden met externe API’s. Authenticatiemethoden worden geconfigureerd in de instellingen van je agent en vervolgens waar nodig gekoppeld aan afzonderlijke tools.

Na configuratie kun je deze authenticatiemethoden aan je tools koppelen en aangepaste headers beheren in de toolconfiguratie:

OAuth2 Client Credentials

Verwerkt automatisch de OAuth2-clientcredentialsflow. Configureer met je client-ID, client secret en token-URL (bijvoorbeeld https://api.example.com/oauth/token). Je kunt optioneel scopes opgeven als kommagescheiden waarden en aanvullende JSON-parameters. Stel dit in door in Workspace Auth Connections in het gedeelte Agent op de instellingenpagina van je agent op Add Auth te klikken.

OAuth2 JWT

Gebruikt JSON Web Token-authenticatie voor de OAuth 2.0 JWT Bearer-flow. Vereist je JWT-ondertekeningssecret, token-URL en algoritme (standaard: HS256). Configureer JWT-claims, waaronder issuer, audience en subject. Stel optioneel key ID, vervaltijd (standaard: 3600 seconden), scopes en extra parameters in. Stel dit in door in Workspace Auth Connections in het gedeelte Agent op de instellingenpagina van je agent op Add Auth te klikken.

Basisauthenticatie

Eenvoudige authenticatie met gebruikersnaam en wachtwoord voor API’s die HTTP Basic Auth ondersteunen. Stel dit in door in Workspace Auth Connections in het gedeelte Agent op de instellingenpagina van je agent op Add Auth te klikken.

Bearer tokens

Tokengebaseerde authenticatie die de waarde van je bearer token toevoegt aan de requestheader. Configureer dit door een header aan de toolconfiguratie toe te voegen, Secret als headertype te selecteren en op Create New Secret te klikken.

Aangepaste headers

Voeg aangepaste authenticatieheaders met een willekeurige naam en waarde toe voor eigen authenticatiemethoden. Configureer dit door een header aan de toolconfiguratie toe te voegen en de naam en waarde op te geven.

Best practices

Geef tools intuïtieve namen met gedetailleerde beschrijvingen

Als je merkt dat de assistent niet de juiste tools aanroept, moet je mogelijk de toolnamen en beschrijvingen bijwerken zodat de assistent duidelijker begrijpt wanneer elke tool moet worden geselecteerd. Gebruik geen afkortingen of acroniemen om tool- en argumentnamen in te korten.

Je kunt ook gedetailleerd beschrijven wanneer een tool moet worden aangeroepen. Bij complexe tools moet je beschrijvingen voor elk argument opnemen, zodat de assistent weet welke informatie hij aan de gebruiker moet vragen om dat argument te verzamelen.

Geef toolparameters intuïtieve namen met gedetailleerde beschrijvingen

Gebruik duidelijke en beschrijvende namen voor toolparameters. Geef indien van toepassing in de beschrijving de verwachte indeling voor een parameter op (bijvoorbeeld YYYY-mm-dd of dd/mm/yy voor een datum).

Overweeg om in de systeemprompt van je assistent aanvullende informatie te geven over hoe en wanneer tools moeten worden aangeroepen

Duidelijke instructies in je systeemprompt kunnen de nauwkeurigheid van toolaanroepen door de assistent aanzienlijk verbeteren. Geef de assistent bijvoorbeeld instructies zoals de volgende:

Use `check_order_status` when the user inquires about the status of their order, such as 'Where is my order?' or 'Has my order shipped yet?'.

Geef context voor complexe scenario’s. Bijvoorbeeld:

Before scheduling a meeting with `schedule_meeting`, check the user's calendar for availability using check_availability to avoid conflicts.

LLM-selectie

Het is belangrijk om te weten dat de keuze van LLM bepalend is voor het succes van functieaanroepen. Sommige LLM’s kunnen moeite hebben met het extraheren van de relevante parameters uit het gesprek.

Geluiden bij toolaanroepen

Je kunt ambient audio configureren die tijdens de uitvoering van een tool wordt afgespeeld om de gebruikerservaring te verbeteren. Lees meer over geluiden bij toolaanroepen.