Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Beépített eszközök: webes keresés, X és gyűjtemények

14. lecke 16 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. A Voice Agent natív eszközei
  2. web_search: keresés a weben
  3. x_search: keresés az X-en (Twitter)
  4. file_search: keresés RAG-gyűjteményekben
  5. Több eszköz kombinálása
  6. Főbb megállapítások

A Voice Agent natív eszközei

Az egyéni függvényhívások és az MCP-kiszolgálók mellett a Voice Agent API számos beépített eszközt biztosít, amelyeket az ügynök a beszélgetés során önállóan használhat. Ezekhez az eszközökhöz nincs szükséged saját végrehajtási logikára: a xAI szerverei teljes mértékben kezelik őket.

web_search: keresés a weben

Ez az eszköz lehetővé teszi az ügynök számára, hogy valós időben keressen információkat a weben a beszélgetés közben:

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

Amikor a felhasználó tényekre irányuló kérdést tesz fel („Milyen az időjárás Párizsban?“, „Ki nyerte tegnap este a meccset?“), az ügynök automatikusan webes keresést végez, és az eredményeket felhasználva állítja össze a szóbeli válaszát.

A beépített eszközökhöz nem tartozik külön esemény, amelyet a kliens felé küldenének: az ügynök belsőleg használja fel az eredményeket, és beépíti őket a hangválaszába.

x_search: keresés az X-en (Twitter)

Ez az eszköz lehetővé teszi az ügynök számára, hogy bejegyzéseket keressen az X platformon:

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

Az allowed_x_handles paraméter opcionális. Ha megadod, a keresés csak az adott fiókok bejegyzéseire korlátozódik. Enélkül az ügynök az egész X-en keres.

Az x_search felhasználási esetei

  • Versenytársfigyelés: „Mit posztolt a [versenytárs] ezen a héten?“
  • Ügyfélszolgálat: „Van-e friss panasz a termékünkről az X-en?“
  • Hírek: „Mi a legfrissebb hír a [témával] kapcsolatban?“
  • Trendek: „Miről beszélnek most az emberek a [iparágban]?“

file_search: keresés RAG-gyűjteményekben

A file_search eszköz lehetővé teszi a hangügynök számára, hogy vektorizált dokumentumok (RAG) gyűjteményeit kérdezze le. Ez az ideális eszköz azoknak az ügynököknek, amelyeknek hozzáférésre van szükségük egy belső tudásbázishoz:

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

Paraméterek

  • vector_store_ids: a lekérdezni kívánt vektorgyűjtemények azonosítói. Többet is felsorolhatsz különböző tudásforrások kombinálásához.
  • max_num_results: a visszaadandó találatok maximális száma (alapértelmezés szerint 10).

Felhasználási forgatókönyvek

  • Hangalapú GYIK: az ügynök a dokumentációd alapján válaszol az ügyfelek kérdéseire.
  • Műszaki támogatás: kézikönyvek és hibaelhárítási útmutatók keresése.
  • Oktatás: az ügynök hozzáfér a tananyaghoz, hogy válaszoljon a tanulók kérdéseire.
  • Jogi segítség: szerződések és jogi dokumentumok keresése.

Több eszköz kombinálása

Egyszerre több eszközt is engedélyezhetsz. Az ügynök a beszélgetés kontextusa alapján választja ki a legrelevánsabbat:

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

Ebben a példában az ügynök képes:

  • Általános kérdések esetén a weben keresni
  • Trendek és vélemények után kutatni az X-en
  • Műszaki kérdések esetén beleásni magát a belső dokumentációba
  • Jegyet létrehozni függvényhívással
  • Hozzáférni a CRM-hez az MCP-n keresztül

Főbb megállapítások

  • Ötféle eszköz áll rendelkezésre: web_search, x_search, file_search, function és mcp
  • A beépített eszközök (web_search, x_search, file_search) a szerveren futnak, kódírás nélkül a részedről
  • A file_search vektorgyűjteményeket kérdez le RAG céljából
  • Az x_search korlátozható konkrét fiókokra az allowed_x_handles paraméterrel
  • Minden eszköztípus kombinálható ugyanabban a munkamenetben