Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Nativní nástroje: vyhledávání na webu, X a kolekce

Lekce 14 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Nativní nástroje hlasového agenta
  2. web_search: vyhledávání na webu
  3. x_search: vyhledávání na platformě X (Twitter)
  4. file_search: vyhledávání v RAG kolekcích
  5. Kombinace více nástrojů
  6. Klíčové poznatky

Nativní nástroje hlasového agenta

Kromě vlastního volání funkcí a serverů MCP nabízí Voice Agent API několik vestavěných nástrojů, které může agent během konverzace používat samostatně. Tyto nástroje nevyžadují žádnou prováděcí logiku na tvé straně: vše kompletně zpracovávají servery xAI.

web_search: vyhledávání na webu

Tento nástroj umožňuje agentovi vyhledávat informace na webu v reálném čase přímo během konverzace:

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

Když se uživatel zeptá na faktickou otázku („Jaké je počasí v Paříži?“, „Kdo vyhrál včerejší zápas?“), agent automaticky spustí vyhledávání na webu a výsledky využije k sestavení své mluvené odpovědi.

Pro vestavěné nástroje se klientovi neodesílá žádná specifická událost: agent výsledky použije interně a zapracuje je do své zvukové odpovědi.

x_search: vyhledávání na platformě X (Twitter)

Tento nástroj umožňuje agentovi vyhledávat příspěvky na platformě X:

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

Parametr allowed_x_handles je volitelný. Pokud je nastaven, vyhledávání se omezí pouze na příspěvky z těchto konkrétních účtů. Bez něj agent prohledává celou platformu X.

  • Monitorování konkurence: „Co tento týden zveřejnila [konkurence]?“
  • Zákaznická podpora: „Objevily se na X nějaké nedávné stížnosti na náš produkt?“
  • Zpravodajství: „Co je nového v oblasti [téma]?“
  • Trendy: „O čem lidé právě teď diskutují v odvětví [odvětví]?“

file_search: vyhledávání v RAG kolekcích

Nástroj file_search umožňuje hlasovému agentovi dotazovat se na kolekce vektorizovaných dokumentů (RAG). Je ideální pro agenty, kteří potřebují přístup k interní znalostní bázi:

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

Parametry

  • vector_store_ids: ID vektorových kolekcí, na které se má dotazovat. Můžeš uvést několik ID pro kombinaci různých zdrojů znalostí.
  • max_num_results: Maximální počet vrácených výsledků (výchozí hodnota je 10).

Scénáře použití

  • Hlasové FAQ: Agent odpovídá na otázky zákazníků na základě tvé dokumentace.
  • Technická podpora: Vyhledávání v manuálech a průvodcích řešením problémů.
  • Vzdělávání: Agent má přístup k obsahu kurzů, aby mohl odpovídat na otázky studentů.
  • Právní asistence: Vyhledávání ve smlouvách a právních dokumentech.

Kombinace více nástrojů

Můžeš povolit několik nástrojů najednou. Agent si na základě kontextu konverzace vybere ten nejrelevantnější:

{
  "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 příkladu může agent:

  • Vyhledávat na webu obecné informace.
  • Kontrolovat platformu X kvůli trendům a názorům.
  • Prohledávat interní dokumentaci pro technické dotazy.
  • Vytvářet ticket prostřednictvím volání funkce.
  • Přistupovat k CRM systému přes MCP.

Klíčové poznatky

  • K dispozici je pět typů nástrojů: web_search, x_search, file_search, function a mcp.
  • Vestavěné nástroje (web_search, x_search, file_search) běží na serveru bez nutnosti psát jakýkoli kód na tvé straně.
  • file_search se dotazuje na vektorové kolekce pro účely RAG.
  • x_search lze pomocí parametru allowed_x_handles omezit na konkrétní účty.
  • V rámci jedné relace můžeš kombinovat všechny typy nástrojů.