Ingebouwde tools: webzoekopdrachten, X en collecties
Op deze pagina
De native tools van de Voice Agent
Naast het aanroepen van aangepaste functies en MCP-servers, biedt de Voice Agent API verschillende ingebouwde tools die de agent tijdens het gesprek zelfstandig kan gebruiken. Voor deze tools hoeft u geen uitvoeringslogica te implementeren: de servers van xAI regelen dit volledig.
web_search: zoeken op het web
Met deze tool kan de agent tijdens het gesprek in realtime informatie op het web opzoeken:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Wanneer de gebruiker een feitelijke vraag stelt (“Hoe is het weer in Parijs?”, “Wie heeft gisteravond de wedstrijd gewonnen?”), voert de agent automatisch een webzoekopdracht uit en gebruikt hij de resultaten om zijn gesproken antwoord samen te stellen.
Er wordt geen specifieke gebeurtenis naar de client verzonden voor ingebouwde tools: de agent gebruikt de resultaten intern en verwerkt ze in zijn audio-antwoord.
x_search: zoeken op X (Twitter)
Met deze tool kan de agent berichten op het X-platform doorzoeken:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
De parameter allowed_x_handles is optioneel. Als u deze instelt, wordt de zoekopdracht beperkt tot berichten van die specifieke accounts. Zonder deze parameter doorzoekt de agent heel X.
Toepassingsgebieden van x_search
- Concurrentiemonitoring: “Wat heeft [concurrent] deze week gepost?”
- Klantenservice: “Zijn er recente klachten over ons product op X?”
- Nieuws: “Wat is het laatste nieuws over [onderwerp]?”
- Trends: “Waar praten mensen op dit moment over in [branche]?“
file_search: RAG-collecties doorzoeken
Met de tool file_search kan de voice-agent collecties van gevectoriseerde documenten (RAG) bevragen. Dit is de ideale tool voor agents die toegang nodig hebben tot een interne kennisbank:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parameters
vector_store_ids: de ID’s van de vectorcollecties die u wilt bevragen. U kunt er meerdere opgeven om verschillende kennisbronnen te combineren.max_num_results: het maximum aantal terug te geven resultaten (standaard 10).
Gebruiksscenario’s
- Voice-FAQ: de agent beantwoordt klantvragen op basis van uw documentatie.
- Technische ondersteuning: het doorzoeken van handleidingen en probleemoplossingsgidsen.
- Training: de agent heeft toegang tot cursusinhoud om vragen van leerlingen te beantwoorden.
- Juridische bijstand: het doorzoeken van contracten en juridische documenten.
Meerdere tools combineren
U kunt meerdere tools tegelijk activeren. De agent kiest op basis van de context van het gesprek de meest relevante tool:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"},
{"type": "x_search"},
{
"type": "file_search",
"vector_store_ids": ["vs_documentation"]
},
{
"type": "function",
"name": "create_ticket",
"description": "Creates a support ticket",
"parameters": {
"type": "object",
"properties": {
"subject": {"type": "string"},
"priority": {"type": "string", "enum": ["low", "medium", "high"]}
},
"required": ["subject"]
}
},
{
"type": "mcp",
"server_url": "https://mcp.exemple.com/sse",
"server_label": "CRM"
}
]
}
}
In dit voorbeeld kan de agent:
- Zoeken op het web voor algemene vragen
- X controleren op trends en meningen
- Interne documentatie doorzoeken voor technische vragen
- Een ticket aanmaken via functiereferentie (function calling)
- Via MCP toegang krijgen tot het CRM
Belangrijkste punten
- Er zijn vijf soorten tools beschikbaar:
web_search,x_search,file_search,functionenmcp. - Ingebouwde tools (
web_search,x_search,file_search) draaien op de server zonder dat u code hoeft te schrijven. file_searchbevraagt vectorcollecties voor RAG.x_searchkan metallowed_x_handlesworden beperkt tot specifieke accounts.- U kunt elk type tool combineren binnen dezelfde sessie.