Indbyggede værktøjer: websøgning, X og samlinger
På denne side
Voice Agentens indbyggede værktøjer
Ud over tilpassede funktionskald og MCP-servere tilbyder Voice Agent API flere indbyggede værktøjer, som agenten kan bruge selvstændigt under samtalen. Disse værktøjer kræver ingen eksekveringslogik på din side: xAI’s servere håndterer dem fuldstændigt.
web_search: søg på nettet
Dette værktøj lader agenten slå oplysninger op på nettet i realtid under samtalen:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Når brugeren stiller et faktuelt spørgsmål („Hvordan er vejret i Paris?”, „Hvem vandt kampen i går?”), udfører agenten automatisk en websøgning og bruger resultaterne til at sammensætte sit talte svar.
Der sendes ingen specifik begivenhed til klienten for indbyggede værktøjer: agenten bruger resultaterne internt og fletter dem ind i sit lydsvar.
x_search: søg på X (Twitter)
Dette værktøj lader agenten søge i indlæg på X-platformen:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Parameteren allowed_x_handles er valgfri. Når den er angivet, begrænses søgningen til indlæg fra disse specifikke konti. Uden den søger agenten på hele X.
Anvendelsestilfælde for x_search
- Konkurrentovervågning: „Hvad har [konkurrent] postet i denne uge?”
- Kundesupport: „Er der nogen nyere klager over vores produkt på X?”
- Nyheder: „Hvad er det seneste om [emne]?”
- Trends: „Hvad taler folk om lige nu inden for [branche]?“
file_search: søg i RAG-samlinger
Værktøjet file_search lader voice-agenten forespørge samlinger af vektoriserede dokumenter (RAG). Det er det ideelle værktøj til agenter, der har brug for adgang til en intern vidensbase:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parametre
vector_store_ids: ID’erne på de vektorsamlinger, der skal forespørges. Du kan liste flere for at kombinere forskellige videnskilder.max_num_results: Det maksimale antal resultater, der skal returneres (10 som standard).
Brugsscenarier
- Voice-FAQ: Agenten besvarer kundespørgsmål baseret på din dokumentation.
- Teknisk support: Søgning i manualer og fejlfindingsguider.
- Træning: Agenten har adgang til kursusindhold for at besvare lærernes spørgsmål.
- Juridisk bistand: Søgning i kontrakter og juridiske dokumenter.
Kombinér flere værktøjer
Du kan aktivere flere værktøjer på én gang. Agenten vælger det mest relevante baseret på samtalekonteksten:
{
"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"
}
]
}
}
I dette eksempel kan agenten:
- Søge på nettet for generelle spørgsmål
- Tjekke X for trends og meninger
- Dykke ned i intern dokumentation for tekniske spørgsmål
- Oprette en sag gennem funktionskald
- Få adgang til CRM’en via MCP
Vigtige pointer
- Der er fem typer værktøjer tilgængelige:
web_search,x_search,file_search,functionogmcp - Indbyggede værktøjer (
web_search,x_search,file_search) kører på serveren uden kode fra din side file_searchforespørger vektorsamlinger til RAGx_searchkan begrænses til specifikke konti medallowed_x_handles- Du kan kombinere alle typer værktøjer i den samme session