Iebūvētie rīki: meklēšana tīmeklī, X un kolekcijas
Šajā lapā
Balss aģenta iebūvētie rīki
Papildus pielāgotai funkciju izsaukšanai un MCP serveriem Voice Agent API nodrošina vairākus iebūvētus rīkus, kurus aģents sarunas laikā var izmantot patstāvīgi. Šiem rīkiem nav nepieciešama nekāda izpildes loģika no tavas puses: xAI serveri tos apstrādā pilnībā.
web_search: meklēšana tīmeklī
Šis rīks ļauj aģentam sarunas laikā reāllaikā meklēt informāciju tīmeklī:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Kad lietotājs uzdod faktisku jautājumu („Kāds ir laiks Parīzē?”, „Kurš vakar uzvarēja spēlē?”), aģents automātiski veic tīmekļa meklēšanu un izmanto rezultātus, lai formulētu savu mutisko atbildi.
Iebūvētiem rīkiem uz klientu netiek sūtīts nekāds īpašs notikums: aģents rezultātus izmanto iekšēji un iekļauj tos savā audio atbildē.
x_search: meklēšana platformā X (Twitter)
Šis rīks ļauj aģentam meklēt ierakstus platformā X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Parametrs allowed_x_handles ir neobligāts. Ja tas ir norādīts, meklēšana tiek ierobežota tikai ar šo konkrēto kontu ierakstiem. Bez tā aģents meklē visā platformā X.
x_search lietojuma gadījumi
- Konkurences uzraudzība: „Ko [konkurents] šonedēļ publicēja?”
- Klientu atbalsts: „Vai platformā X ir kādas sūdzības par mūsu produktu?”
- Ziņas: „Kas jaunākais par [tēmu]?”
- Tendences: „Par ko cilvēki šobrīd runā [nozarē]?“
file_search: RAG kolekciju meklēšana
Rīks file_search ļauj balss aģentam veikt vaicājumus vektorizētu dokumentu kolekcijās (RAG). Tas ir ideāls rīks aģentiem, kuriem nepieciešama piekļuve iekšējai zināšanu bāzei:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parametri
vector_store_ids: to vektoru kolekciju ID, kurās veikt vaicājumu. Vari norādīt vairākus ID, lai apvienotu dažādus zināšanu avotus.max_num_results: maksimālais atgriežamo rezultātu skaits (pēc noklusējuma 10).
Lietošanas scenāriji
- Balss FAQ: aģents atbild uz klientu jautājumiem, balstoties uz tavu dokumentāciju.
- Tehniskais atbalsts: rokasgrāmatu un problēmu novēršanas ceļvežu meklēšana.
- Apmācība: aģentam ir piekļuve kursa saturam, lai atbildētu uz mācību dalībnieku jautājumiem.
- Juridiskā palīdzība: līgumu un juridisko dokumentu meklēšana.
Vairāku rīku kombinēšana
Tu vari aktivizēt vairākus rīkus vienlaikus. Aģents, balstoties uz sarunas kontekstu, izvēlas vispiemērotāko:
{
"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"
}
]
}
}
Šajā piemērā aģents var:
- Meklēt tīmeklī vispārīgus jautājumus
- Pārbaudīt platformu X, lai uzzinātu par tendencēm un viedokļiem
- Iedziļināties iekšējā dokumentācijā, lai atbildētu uz tehniskiem jautājumiem
- Izveidot pieteikumu, izmantojot funkciju izsaukšanu
- Piekļūt CRM sistēmai, izmantojot MCP
Galvenās atziņas
- Pieejami piecu veidu rīki:
web_search,x_search,file_search,functionunmcp - Iebūvētie rīki (
web_search,x_search,file_search) darbojas servera pusē, tev nerakstot nekādu kodu file_searchveic vaicājumus vektoru kolekcijās RAG vajadzībāmx_searchvar ierobežot līdz konkrētiem kontiem, izmantojotallowed_x_handles- Vienā sesijā vari kombinēt visu veidu rīkus