Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Sisseehitatud tööriistad: veebiotsing, X ja kogumikud

Õppetund 14 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Häälteagendi loomupärased tööriistad
  2. web_search: veebiotsing
  3. x_search: otsing X-is (Twitter)
  4. file_search: RAG-kogumike otsing
  5. Mitme tööriista kombineerimine
  6. Peamised punktid

Häälteagendi loomupärased tööriistad

Lisaks kohandatud funktsioonide kutsumisele ja MCP serveritele pakub Voice Agent API mitmeid sisseehitatud tööriistu, mida agent saab vestluse käigus iseseisvalt kasutada. Need tööriistad ei vaja sinu poolt mingit täitmise loogikat: xAI serverid haldavad kogu protsessi.

web_search: veebiotsing

See tööriist võimaldagendil vestluse ajal reaalajas veebist teavet otsida:

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

Kui kasutaja esitab faktilise küsimuse („Milline on ilm Pariisis?“, „Kes võitis eilse mängu?“), käivitab agent automaatselt veebiotsingu ja kasutab tulemusi oma suulise vastuse koostamiseks.

Sisseehitatud tööriistade jaoks ei saadeta kliendile spetsiifilist sündmust: agent kasutab tulemusi sisemiselt ja lõimib need oma helivastusesse.

x_search: otsing X-is (Twitter)

See tööriist võimaldab agendil otsida postitusi X-i platvormilt:

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

Parameeter allowed_x_handles on valikuline. Kui see on määratud, piirdub otsing ainult nende konkreetsete kontode postitustega. Ilma selleta otsib agent kogu X-i platvormi.

x_search-i kasutusjuhtumid

  • Konkurentsi jälgimine: „Mida [konkurent] sel nädalal postitas?“
  • Klienditugi: „Kas X-is on hiljuti kaebusi meie toote kohta?“
  • Uudised: „Mis on uusimat teavet [teema] kohta?“
  • Trendid: „Millest räägivad inimesed praegu [valdkonnas]?“

file_search: RAG-kogumike otsing

Tööriist file_search võimaldab häälteagendil päringuid teha vektoriseeritud dokumentide kogumikes (RAG). See on ideaalne tööriist agentidele, kes vajavad juurdepääsu sisemisele teadmiste baasile:

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

Parameetrid

  • vector_store_ids: vektorite kogumike ID-d, mida pärida. Erinevate teabeallikate kombineerimiseks saad loetleda mitu ID-d.
  • max_num_results: tagastatavate tulemuste maksimaalne arv (vaikimisi 10).

Kasutusstseenariumid

  • Häälepõhine KKK: agent vastab kliendi küsimustele, tuginedes teie dokumentatsioonile.
  • Tehniline tugi: käsiraamatute ja tõrkeotsingu juhendite otsimine.
  • Koolitus: agendil on juurdepääs kursuse sisule, et vastata õppijate küsimustele.
  • Juriidiline abi: lepingute ja juriidiliste dokumentide otsimine.

Mitme tööriista kombineerimine

Saad korraga lubada mitu tööriista. Agent valib vestluse konteksti põhjal kõige asjakohasema:

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

Selles näites saab agent:

  • Otsida veebist üldisi küsimusi
  • Kontrollida X-i trende ja arvamusi
  • Süveneda tehniliste küsimuste lahendamisel sisemisse dokumentatsiooni
  • Luua pileti funktsiooni kutsumise kaudu
  • Pääseda MCP kaudu ligi CRM-süsteemile

Peamised punktid

  • Saadaval on viit tüüpi tööriistu: web_search, x_search, file_search, function ja mcp
  • Sisseehitatud tööriistad (web_search, x_search, file_search) töötavad serveris ilma sinu poolt kirjutatud koodita
  • file_search teeb päringuid RAG-i vektorite kogumikes
  • x_search saab parameetriga allowed_x_handles piirata konkreetsete kontodega
  • Samas sessioonis saad kombineerida kõiki tööriistatüüpe