Instrumente native: căutare web, X și colecții
Pe această pagină
Instrumentele native ale Voice Agent
Pe lângă apelarea de funcții personalizate și serverele MCP, API-ul Voice Agent pune la dispoziție mai multe instrumente integrate pe care agentul le poate utiliza autonom în timpul conversației. Aceste instrumente nu necesită nicio logică de execuție din partea dumneavoastră: serverele xAI se ocupă integral de ele.
web_search: căutare pe web
Acest instrument permite agentului să caute informații pe web în timp real, direct în timpul conversației:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Când utilizatorul pune o întrebare factuală („Cum este vremea la Paris?“, „Cine a câștigat meciul aseară?“), agentul execută automat o căutare pe web și folosește rezultatele pentru a-și construi răspunsul vocal.
Niciun eveniment specific nu este trimis către client pentru instrumentele integrate: agentul utilizează rezultatele intern și le integrează în răspunsul său audio.
x_search: căutare pe X (Twitter)
Acest instrument permite agentului să caute postări pe platforma X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Parametrul allowed_x_handles este opțional. Când este setat, căutarea se limitează la postările provenite de la acele conturi specifice. Fără acesta, agentul caută pe întregul X.
Cazuri de utilizare pentru x_search
- Monitorizarea concurenței: „Ce a postat [concurentul] săptămâna aceasta?“
- Suport pentru clienți: „Există plângeri recente despre produsul nostru pe X?“
- Știri: „Care sunt ultimele noutăți despre [subiect]?“
- Tendințe: „Despre ce discută oamenii chiar acum în [industrie]?“
file_search: căutare în colecții RAG
Instrumentul file_search permite agentului vocal să interogheze colecții de documente vectorizate (RAG). Este instrumentul ideal pentru agenții care necesită acces la o bază de cunoștințe internă:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parametri
vector_store_ids: ID-urile colecțiilor vectoriale de interogat. Puteți lista mai multe pentru a combina diferite surse de cunoștințe.max_num_results: numărul maxim de rezultate de returnat (10 în mod implicit).
Scenarii de utilizare
- FAQ vocal: agentul răspunde la întrebările clienților pe baza documentației dumneavoastră.
- Suport tehnic: căutare în manuale și ghiduri de depanare.
- Formare: agentul are acces la conținutul cursurilor pentru a răspunde la întrebările cursanților.
- Asistență juridică: căutare în contracte și documente legale.
Combinarea mai multor instrumente
Puteți activa mai multe instrumente simultan. Agentul îl selectează pe cel mai relevant în funcție de contextul conversației:
{
"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"
}
]
}
}
În acest exemplu, agentul poate:
- Să caute pe web pentru întrebări generale.
- Să verifice X pentru tendințe și opinii.
- Să aprofundeze documentația internă pentru întrebări tehnice.
- Să creeze un tichet prin apelarea de funcții.
- Să acceseze CRM-ul prin MCP.
Puncte cheie
- Sunt disponibile cinci tipuri de instrumente:
web_search,x_search,file_search,functionșimcp. - Instrumentele integrate (
web_search,x_search,file_search) rulează pe server fără a necesita cod din partea dumneavoastră. file_searchinteroghează colecții vectoriale pentru RAG.x_searchpoate fi limitat la conturi specifice folosindallowed_x_handles.- Puteți combina toate tipurile de instrumente în aceeași sesiune.