Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Vstavané nástroje: vyhľadávanie na webe, X a kolekcie

Lekcia 14 z 16 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Natívne nástroje hlasového agenta
  2. web_search: vyhľadávanie na webe
  3. x_search: vyhľadávanie na X (Twitter)
  4. file_search: vyhľadávanie v kolekciách RAG
  5. Kombinácia viacerých nástrojov
  6. Kľúčové poznatky

Natívne nástroje hlasového agenta

Okrem vlastného volania funkcií a serverov MCP ponúka Voice Agent API niekoľko vstavaných nástrojov, ktoré môže agent počas konverzácie používať samostatne. Tieto nástroje nevyžadujú žiadnu vykonávaciu logiku na tvojej strane: všetko úplne vybavujú servery xAI.

web_search: vyhľadávanie na webe

Tento nástroj umožňuje agentovi vyhľadávať informácie na webe v reálnom čase priamo počas konverzácie:

{
  "type": "session.update",
  "session": {
    "tools": [
      {"type": "web_search"}
    ]
  }
}

Keď sa používateľ opýta na faktickú otázku („Aké je počasie v Paríži?“, „Kto vyhral včera večer zápas?“), agent automaticky spustí vyhľadávanie na webe a použije výsledky na zostavenie svojej hovorenej odpovede.

Pre vstavané nástroje sa klientovi neodosiela žiadna špecifická udalosť: agent využíva výsledky interne a zapracúva ich do svojej zvukovej odpovede.

x_search: vyhľadávanie na X (Twitter)

Tento nástroj umožňuje agentovi vyhľadávať príspevky na platforme X:

{
  "type": "session.update",
  "session": {
    "tools": [
      {
        "type": "x_search",
        "allowed_x_handles": ["xai", "gaborcselle"]
      }
    ]
  }
}

Parameter allowed_x_handles je voliteľný. Ak je nastavený, vyhľadávanie sa obmedzí na príspevky z týchto konkrétnych účtov. Bez neho agent vyhľadáva v celom obsahu platformy X.

  • Monitorovanie konkurencie: „Čo tento týždeň zverejnila [konkurencia]?“
  • Zákaznícka podpora: „Vyskytli sa v poslednom čase na X nejaké sťažnosti na náš produkt?“
  • Spravodajstvo: „Aké sú najnovšie informácie o [téma]?“
  • Trendy: „O čom ľudia práve teraz hovoria v odvetví [odvetvie]?“

file_search: vyhľadávanie v kolekciách RAG

Nástroj file_search umožňuje hlasovému agentovi dopytovať kolekcie vektorizovaných dokumentov (RAG). Je ideálny pre agentov, ktorí potrebujú prístup k internej znalostnej báze:

{
  "type": "session.update",
  "session": {
    "tools": [
      {
        "type": "file_search",
        "vector_store_ids": ["vs_abc123", "vs_def456"],
        "max_num_results": 10
      }
    ]
  }
}

Parametre

  • vector_store_ids: ID vektorových kolekcií, ktoré sa majú dopytovať. Môžeš uviesť viacero ID a skombinovať tak rôzne zdroje znalostí.
  • max_num_results: Maximálny počet vrátených výsledkov (predvolené je 10).

Scenáre použitia

  • Hlasové FAQ: Agent odpovedá na otázky zákazníkov na základe tvojej dokumentácie.
  • Technická podpora: Vyhľadávanie v manuáloch a sprievodcoch riešením problémov.
  • Vzdelávanie: Agent má prístup k obsahu kurzov, aby mohol odpovedať na otázky účastníkov.
  • Právna asistencia: Vyhľadávanie v zmluvách a právnych dokumentoch.

Kombinácia viacerých nástrojov

Môžeš povoliť viacero nástrojov naraz. Agent si na základe kontextu konverzácie vyberie ten najrelevantnejší:

{
  "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"
      }
    ]
  }
}

V tomto príklade môže agent:

  • Vyhľadávať na webe všeobecné odpovede
  • Kontrolovať platformu X kvôli trendom a názorom
  • Hľadať v internej dokumentácii technické odpovede
  • Vytvoriť tiket prostredníctvom volania funkcie
  • Pristupovať do CRM cez MCP

Kľúčové poznatky

  • K dispozícii je päť typov nástrojov: web_search, x_search, file_search, function a mcp
  • Vstavané nástroje (web_search, x_search, file_search) bežia na serveri bez potreby tvoho kódu
  • file_search dopytuje vektorové kolekcie pre RAG
  • x_search môžeš obmedziť na konkrétne účty pomocou allowed_x_handles
  • V rámci jednej relácie môžeš kombinovať všetky typy nástrojov