Inbyggda verktyg: webbsökning, X och samlingar
På denna sida
Voice Agent: inbyggda verktyg
Förutom anpassade funktionsanrop och MCP-servrar erbjuder Voice Agent API flera inbyggda verktyg som agenten kan använda självständigt under konversationen. Dessa verktyg kräver ingen körningslogik från din sida: xAI:s servrar hanterar dem helt.
web_search: sök på webben
Detta verktyg låter agenten söka efter information på webben i realtid under konversationen:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
När användaren ställer en faktabaserad fråga (“Vad är vädret i Paris?”, “Vem vann matchen igår kväll?”) utför agenten automatiskt en webbsökning och använder resultaten för att formulera sitt talade svar.
Ingen specifik händelse skickas till klienten för inbyggda verktyg: agenten använder resultaten internt och väver in dem i sitt ljudsvar.
x_search: sök på X (Twitter)
Detta verktyg låter agenten söka efter inlägg på plattformen X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Parametern allowed_x_handles är valfri. När den anges begränsas sökningen till inlägg från dessa specifika konton. Utan den söker agenten igenom hela X.
Användningsområden för x_search
- Konkurrensbevakning: “Vad har [konkurrent] publicerat denna vecka?”
- Kundsupport: “Finns det några senaste klagomål om vår produkt på X?”
- Nyheter: “Vad är det senaste inom [ämne]?”
- Trender: “Vad pratar folk om just nu inom [bransch]?“
file_search: sök i RAG-samlingar
Verktyget file_search låter röstagenten fråga samlingar av vektoriserade dokument (RAG). Det är det idealiska verktyget för agenter som behöver tillgång till en intern kunskapsbas:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parametrar
vector_store_ids: ID:n för de vektorsamlingar som ska frågas. Du kan lista flera för att kombinera olika kunskapskällor.max_num_results: maximalt antal resultat som ska returneras (standardvärdet är 10).
Användningsscenarier
- Röstbaserad FAQ: agenten svarar på kundfrågor baserat på din dokumentation.
- Teknisk support: sökning i manualer och felsökningsguider.
- Utbildning: agenten har tillgång till kursinnehåll för att svara på lärandes frågor.
- Juridisk assistans: sökning i avtal och juridiska dokument.
Kombinera flera verktyg
Du kan aktivera flera verktyg samtidigt. Agenten väljer det mest relevanta baserat på konversationens kontext:
{
"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 detta exempel kan agenten:
- Söka på webben efter allmänna frågor
- Kontrollera X efter trender och åsikter
- Gräva i intern dokumentation för tekniska frågor
- Skapa ett ärende genom funktionsanrop
- Komma åt CRM-systemet via MCP
Viktiga punkter
- Fem typer av verktyg är tillgängliga:
web_search,x_search,file_search,functionochmcp - Inbyggda verktyg (
web_search,x_search,file_search) körs på servern utan att du behöver skriva någon kod file_searchfrågar vektorsamlingar för RAGx_searchkan begränsas till specifika konton medallowed_x_handles- Du kan kombinera alla typer av verktyg i samma session