Strumenti integrati: ricerca web, X e collezioni
In questa pagina
Gli strumenti nativi del Voice Agent
Oltre alla chiamata di funzioni personalizzate e ai server MCP, l’API Voice Agent offre diversi strumenti integrati che l’agente può utilizzare autonomamente durante la conversazione. Questi strumenti non richiedono alcuna logica di esecuzione da parte tua: i server di xAI se ne occupano interamente.
web_search: ricerca sul web
Questo strumento permette all’agente di cercare informazioni sul web in tempo reale durante la conversazione:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Quando l’utente pone una domanda fattuale («Qual è il meteo a Parigi?», «Chi ha vinto la partita ieri sera?»), l’agente esegue automaticamente una ricerca web e utilizza i risultati per formulare la sua risposta vocale.
Nessun evento specifico viene inviato al client per gli strumenti integrati: l’agente usa i risultati internamente e li integra nella sua risposta audio.
x_search: ricerca su X (Twitter)
Questo strumento permette all’agente di cercare post sulla piattaforma X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Il parametro allowed_x_handles è opzionale. Quando è impostato, la ricerca si limita ai post provenienti da quegli account specifici. Senza di esso, l’agente cerca su tutto X.
Casi d’uso di x_search
- Monitoraggio della concorrenza: «Cosa ha pubblicato [concorrente] questa settimana?»
- Assistenza clienti: «Ci sono recenti reclami sul nostro prodotto su X?»
- Notizie: «Quali sono le ultime novità su [argomento]?»
- Tendenze: «Di cosa stanno parlando le persone in questo momento nel settore [settore]?»
file_search: ricerca nelle collezioni RAG
Lo strumento file_search permette all’agente vocale di interrogare collezioni di documenti vettorializzati (RAG). È lo strumento ideale per gli agenti che necessitano di accedere a una base di conoscenza interna:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parametri
vector_store_ids: gli ID delle collezioni vettoriali da interrogare. Puoi elencarne diversi per combinare diverse fonti di conoscenza.max_num_results: il numero massimo di risultati da restituire (10 per impostazione predefinita).
Scenari di utilizzo
- FAQ vocale: l’agente risponde alle domande dei clienti basandosi sulla tua documentazione.
- Supporto tecnico: ricerca di manuali e guide alla risoluzione dei problemi.
- Formazione: l’agente ha accesso ai contenuti del corso per rispondere alle domande degli studenti.
- Assistenza legale: ricerca di contratti e documenti legali.
Combinare più strumenti
Puoi abilitare più strumenti contemporaneamente. L’agente seleziona quello più rilevante in base al contesto della conversazione:
{
"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 questo esempio, l’agente può:
- Cercare sul web per domande generali
- Controllare X per tendenze e opinioni
- Esplorare la documentazione interna per domande tecniche
- Creare un ticket tramite chiamata di funzione
- Accedere al CRM tramite MCP
Punti chiave
- Sono disponibili cinque tipi di strumenti:
web_search,x_search,file_search,functionemcp - Gli strumenti integrati (
web_search,x_search,file_search) vengono eseguiti sul server senza che tu debba scrivere codice file_searchinterroga le collezioni vettoriali per il RAGx_searchpuò essere limitato ad account specifici conallowed_x_handles- Puoi combinare ogni tipo di strumento nella stessa sessione