Sisseehitatud tööriistad: veebiotsing, X ja kogumikud
Sellel lehel
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,functionjamcp - Sisseehitatud tööriistad (
web_search,x_search,file_search) töötavad serveris ilma sinu poolt kirjutatud koodita file_searchteeb päringuid RAG-i vektorite kogumikesx_searchsaab parameetrigaallowed_x_handlespiirata konkreetsete kontodega- Samas sessioonis saad kombineerida kõiki tööriistatüüpe