Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Ugrađeni alati: web pretraga, X i kolekcije

Lekcija 14 od 16 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Izvorni alati glasovnog agenta
  2. web_search: pretraga weba
  3. x_search: pretraga platforme X (Twitter)
  4. file_search: pretraga RAG kolekcija
  5. Kombiniranje više alata
  6. Ključne točke

Izvorni alati glasovnog agenta

Osim pozivanja prilagođenih funkcija i MCP poslužitelja, API glasovnog agenta nudi nekoliko ugrađenih alata koje agent može samostalno koristiti tijekom razgovora. Ovi alati ne zahtijevaju nikakvu logiku izvršavanja s tvoje strane: poslužitelji tvrtke xAI u potpunosti ih obrađuju.

web_search: pretraga weba

Ovaj alat omogućuje agentu da u stvarnom vremenu tijekom razgovora traži informacije na webu:

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

Kada korisnik postavi činjenično pitanje („Kakvo je vrijeme u Parizu?“, „Tko je jučer pobijedio u utakmici?“), agent automatski pokreće web pretragu i koristi rezultate za sastavljanje svog usmenog odgovora.

Za ugrađene alate klijentu se ne šalje nikakav specifičan događaj: agent rezultate koristi interno i uključuje ih u svoj zvučni odgovor.

x_search: pretraga platforme X (Twitter)

Ovaj alat omogućuje agentu pretragu objava na platformi X:

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

Parametar allowed_x_handles je opcionalan. Kada je postavljen, pretraga je ograničena na objave s tih specifičnih računa. Bez njega, agent pretražuje cijeli X.

  • Praćenje konkurencije: „Što je [konkurent] objavio ovaj tjedan?“
  • Korisnička podrška: „Postoje li nedavne pritužbe na naš proizvod na X-u?“
  • Vijesti: „Što je najnovije o [temi]?“
  • Trendovi: „O čemu ljudi trenutno razgovaraju u [industriji]?“

file_search: pretraga RAG kolekcija

Alat file_search omogućuje glasovnom agentu upite nad kolekcijama vektoriziranih dokumenata (RAG). To je idealan alat za agente kojima je potreban pristup internoj bazi 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-jevi vektorskih kolekcija za upit. Možeš navesti nekoliko njih kako bi kombinirao različite izvore znanja.
  • max_num_results: Maksimalni broj rezultata za vraćanje (zadano je 10).

Scenariji upotrebe

  • Glasovni FAQ: agent odgovara na pitanja korisnika na temelju tvoje dokumentacije.
  • Tehnička podrška: pretraživanje priručnika i vodiča za rješavanje problema.
  • Obuka: agent ima pristup sadržaju tečaja kako bi odgovorio na pitanja polaznika.
  • Pravna pomoć: pretraživanje ugovora i pravnih dokumenata.

Kombiniranje više alata

Možeš istovremeno omogućiti nekoliko alata. Agent odabire najrelevantniji na temelju konteksta razgovora:

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

U ovom primjeru agent može:

  • Pretraživati web za opća pitanja
  • Provjeravati X za trendove i mišljenja
  • Dubinski analizirati internu dokumentaciju za tehnička pitanja
  • Kreirati tiket putem pozivanja funkcije
  • Pristupiti CRM-u putem MCP-a

Ključne točke

  • Dostupno je pet vrsta alata: web_search, x_search, file_search, function i mcp
  • Ugrađeni alati (web_search, x_search, file_search) izvršavaju se na poslužitelju bez potrebe za tvojim kodom
  • file_search upućuje upite vektorskim kolekcijama za RAG
  • x_search može biti ograničen na specifične račune pomoću allowed_x_handles
  • U istoj sesiji možeš kombinirati sve vrste alata