Sisäiset työkalut: verkkohaku, X ja kokoelmat
Tällä sivulla
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,functionjamcp - Sisäiset työkalut (
web_search,x_search,file_search) suoritetaan palvelimella ilman koodausta puoleltasi file_searchkyselyt kohdistuvat RAG:n vektorikokoelmiinx_searchvoidaan rajoittaa tiettyihin tileihin parametrillaallowed_x_handles- Kaikki työkalutyypit voidaan yhdistää samaan istuntoon