Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Vgrajena orodja: spletno iskanje, X in zbirke

Lekcija 14 od 16 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Izvirna orodja glasovnega agenta
  2. web_search: iskanje po spletu
  3. x_search: iskanje po platformi X (Twitter)
  4. file_search: iskanje po zbirkah RAG
  5. Združevanje več orodij
  6. Ključne ugotovitve

Izvirna orodja glasovnega agenta

Poleg klicanja prilagojenih funkcij in strežnikov MCP ponuja API glasovnega agenta več vgrajenih orodij, ki jih agent lahko samostojno uporablja med pogovorom. Za ta orodja ne potrebuješ nobene izvedbene logike na svoji strani: strežniki xAI jih v celoti obdelajo namesto tebe.

web_search: iskanje po spletu

To orodje omogoča agentu, da med pogovorom v realnem času poišče informacije na spletu:

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

Ko uporabnik zastavi dejansko vprašanje („Kakšno je vreme v Parizu?”, „Kdo je sinoči zmagal na tekmi?”), agent samodejno izvede spletno iskanje in rezultate uporabi za sestavo svojega govornega odgovora.

Za vgrajena orodja se odjemalcu ne pošlje noben poseben dogodek: agent rezultate uporabi interno in jih vključi v svoj zvočni odziv.

x_search: iskanje po platformi X (Twitter)

To orodje omogoča agentu iskanje objav na platformi X:

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

Parameter allowed_x_handles je izbirni. Ko je nastavljen, je iskanje omejeno na objave teh določenih računov. Brez njega agent išče po celotni platformi X.

  • Spremljanje konkurence: „Kaj je [konkurent] objavil ta teden?”
  • Podpora strankam: „Ali obstajajo kakšne nedavne pritožbe glede našega izdelka na X?”
  • Novice: „Kaj je najnovejšega glede [teme]?”
  • Trendi: „O čem ljudje trenutno govorijo v [panogi]?“

file_search: iskanje po zbirkah RAG

Orodje file_search omogoča glasovnemu agentu poizvedbe po zbirkah vektoriziranih dokumentov (RAG). To je idealno orodje za agente, ki potrebujejo dostop do interne baze znanja:

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

Parametri

  • vector_store_ids: ID-ji vektorskih zbirk za poizvedbo. Našteješ lahko več ID-jev za združevanje različnih virov znanja.
  • max_num_results: največje število vrnjenih rezultatov (privzeto 10).

Scenariji uporabe

  • Glasovni FAQ: agent odgovarja na vprašanja strank na podlagi vaše dokumentacije.
  • Tehnična podpora: iskanje po priročnikih in vodnikih za odpravljanje težav.
  • Usposabljanje: agent ima dostop do vsebine tečaja za odgovarjanje na vprašanja učencev.
  • Pravna pomoč: iskanje po pogodbah in pravnih dokumentih.

Združevanje več orodij

Hkrati lahko omogočiš več orodij. Agent glede na kontekst pogovora sam izbere najustreznejše:

{
  "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 tem primeru agent lahko:

  • Išče po spletu za splošna vprašanja,
  • preverja X za trende in mnenja,
  • brska po interni dokumentaciji za tehnična vprašanja,
  • ustvari tiket prek klica funkcije,
  • dostopa do CRM sistema prek MCP.

Ključne ugotovitve

  • Na voljo je pet vrst orodij: web_search, x_search, file_search, function in mcp.
  • Vgrajena orodja (web_search, x_search, file_search) se izvajajo na strežniku brez potrebe po tvoji kodi.
  • file_search izvaja poizvedbe po vektorskih zbirkah za RAG.
  • x_search lahko z parametrom allowed_x_handles omejiš na določene račune.
  • V isti seji lahko združiš vse vrste orodij.