Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Strumenti integrati: ricerca web, X e collezioni

Lezione 14 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Gli strumenti nativi del Voice Agent
  2. web_search: ricerca sul web
  3. x_search: ricerca su X (Twitter)
  4. file_search: ricerca nelle collezioni RAG
  5. Combinare più strumenti
  6. Punti chiave

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.

  • 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, function e mcp
  • Gli strumenti integrati (web_search, x_search, file_search) vengono eseguiti sul server senza che tu debba scrivere codice
  • file_search interroga le collezioni vettoriali per il RAG
  • x_search può essere limitato ad account specifici con allowed_x_handles
  • Puoi combinare ogni tipo di strumento nella stessa sessione