Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Sisäiset työkalut: verkkohaku, X ja kokoelmat

Oppitunti 14 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Voice Agentin natiivit työkalut
  2. web_search: verkkohaku
  3. x_search: haku X:stä (Twitter)
  4. file_search: RAG-kokoelmien haku
  5. Useiden työkalujen yhdistäminen
  6. Keskeiset asiat

Voice Agentin natiivit työkalut

Mukautettujen funktiokutsujen ja MCP-palvelimien lisäksi Voice Agent API tarjoaa useita sisäisiä työkaluja, joita agentti voi käyttää itsenäisesti keskustelun aikana. Nämä työkalut eivät vaadi toteutuslogiikkaa puoleltasi: xAI:n palvelimet hoitavat kaiken.

web_search: verkkohaku

Tämä työkalu antaa agentille mahdollisuuden hakea tietoa verkosta reaaliajassa keskustelun aikana:

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

Kun käyttäjä esittää faktuaalisen kysymyksen (“Mikä sää on Pariisissa?”, “Kuka voitti eilisen pelin?”), agentti suorittaa verkkohaun automaattisesti ja käyttää tuloksia muodostaakseen puhevastauksensa.

Sisäisistä työkaluista ei lähetetä asiakkaalle erityistä tapahtumaa: agentti käyttää tuloksia sisäisesti ja sisällyttää ne äänivasteeseensa.

x_search: haku X:stä (Twitter)

Tämä työkalu antaa agentille mahdollisuuden hakea viestejä X-alustalta:

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

Parametri allowed_x_handles on valinnainen. Kun se on määritetty, haku rajoittuu näiden tiettyjen tilien viesteihin. Ilman sitä agentti hakee koko X:stä.

x_search:n käyttötapaukset

  • Kilpailijaseuranta: “Mitä [kilpailija] julkaisi tällä viikolla?”
  • Asiakastuki: “Onko X:ssä viime aikoina valitettu tuotteestamme?”
  • Uutiset: “Mitä uutta [aiheesta] kuuluu?”
  • Trendit: “Mistä ihmiset puhuvat juuri nyt [toimialalla]?“

file_search: RAG-kokoelmien haku

Työkalu file_search antaa puheagentille mahdollisuuden kysellä vektoroitujen dokumenttien kokoelmista (RAG). Se on ihanteellinen työkalu agenteille, jotka tarvitsevat pääsyn sisäiseen tietopankkiin:

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

Parametrit

  • vector_store_ids: kyseltävien vektorikokoelmien tunnisteet. Voit luetella useita yhdistääksesi eri tietolähteitä.
  • max_num_results: palautettavien tulosten enimmäismäärä (oletusarvo 10).

Käyttöskenaariot

  • Äänen FAQ: agentti vastaa asiakkaiden kysymyksiin dokumentaatioosi perustuen.
  • Tekninen tuki: käsikirjojen ja vianmääritysoppaiden haku.
  • Koulutus: agentilla on pääsy kurssisisältöön oppilaiden kysymyksiin vastaamiseksi.
  • Lakiapu: sopimusten ja juridisten asiakirjojen haku.

Useiden työkalujen yhdistäminen

Voit ottaa käyttöön useita työkaluja samanaikaisesti. Agentti valitsee keskustelun kontekstin perusteella sopivimman työkalun:

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

Tässä esimerkissä agentti voi:

  • Hakea verkosta yleisiä kysymyksiä varten
  • Tarkistaa X:stä trendejä ja mielipiteitä
  • Kaivaa sisäisestä dokumentaatiosta teknisiä kysymyksiä varten
  • Luoda tukipyynnön funktiokutsun kautta
  • Käyttää CRM-järjestelmää MCP:n kautta

Keskeiset asiat

  • Käytettävissä on viidentyyppisiä työkaluja: web_search, x_search, file_search, function ja mcp
  • Sisäiset työkalut (web_search, x_search, file_search) suoritetaan palvelimella ilman koodausta puoleltasi
  • file_search kyselyt kohdistuvat RAG:n vektorikokoelmiin
  • x_search voidaan rajoittaa tiettyihin tileihin parametrilla allowed_x_handles
  • Kaikki työkalutyypit voidaan yhdistää samaan istuntoon