Salt la conținutul principal
Română— Alege o limbă
Meniu

Instrumente native: căutare web, X și colecții

Lecția 14 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Instrumentele native ale Voice Agent
  2. web_search: căutare pe web
  3. x_search: căutare pe X (Twitter)
  4. file_search: căutare în colecții RAG
  5. Combinarea mai multor instrumente
  6. Puncte cheie

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.

  • 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 și mcp.
  • Instrumentele integrate (web_search, x_search, file_search) rulează pe server fără a necesita cod din partea dumneavoastră.
  • file_search interoghează colecții vectoriale pentru RAG.
  • x_search poate fi limitat la conturi specifice folosind allowed_x_handles.
  • Puteți combina toate tipurile de instrumente în aceeași sesiune.