Integruoti įrankiai: žiniatinklio paieška, X ir kolekcijos
Šiame puslapyje
Balsinio agento vietiniai įrankiai
Be individualių funkcijų kvietimų ir MCP serverių, Balsinio agento API suteikia keletą integruotų įrankių, kuriuos agentas gali savarankiškai naudoti pokalbio metu. Šiems įrankiams nereikia jokios vykdymo logikos tavo pusėje: viskuo rūpinasi xAI serveriai.
web_search: žiniatinklio paieška
Šis įrankis leidžia agentui pokalbio metu realiuoju laiku ieškoti informacijos žiniatinklyje:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Kai vartotojas užduoda faktinį klausimą („Koks oras Paryžiuje?“, „Kas laimėjo vakarykštį žaidimą?“), agentas automatiškai atlieka žiniatinklio paiešką ir naudoja rezultatus suformuluodamas savo žodinį atsakymą.
Integruotiems įrankiams joks konkretus įvykis nesiunčiamas klientui: agentas rezultatus naudoja viduje ir integruoja juos į savo garso atsakymą.
x_search: paieška platformoje X (Twitter)
Šis įrankis leidžia agentui ieškoti įrašų X platformoje:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Parametras allowed_x_handles yra neprivalomas. Kai jis nustatytas, paieška apribojama tik tų konkrečių paskyrų įrašais. Be jo agentas ieško visoje X platformoje.
x_search naudojimo atvejai
- Konkurentų stebėsena: „Ką [konkurentas] paskelbė šią savaitę?“
- Klientų aptarnavimas: „Ar X platformoje yra naujų skundų apie mūsų produktą?“
- Naujienos: „Kokia naujausia informacija apie [temą]?“
- Tendencijos: „Apie ką žmonės dabar kalba [pramonės šakoje]?“
file_search: RAG kolekcijų paieška
Įrankis file_search leidžia balsiniam agentui užklausti vektorizuotų dokumentų kolekcijas (RAG). Tai idealus įrankis agentams, kuriems reikia prieigos prie vidinės žinių bazės:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parametrai
vector_store_ids: užklausiamų vektorių kolekcijų ID. Galite išvardyti kelis, kad sujungtumėte skirtingus žinių šaltiniusmax_num_results: maksimalus grąžinamų rezultatų skaičius (pagal nutylėjimą – 10)
Naudojimo scenarijai
- Balsinis DUK: agentas atsako į klientų klausimus remdamasis jūsų dokumentacija
- Techninė pagalba: vadovų ir trikčių šalinimo gidų paieška
- Mokymai: agentas turi prieigą prie kurso turinio, kad atsakytų į besimokančiųjų klausimus
- Teisinė pagalba: sutarčių ir teisinių dokumentų paieška
Kelių įrankių derinimas
Vienu metu galite įgalinti kelis įrankius. Agentas, atsižvelgdamas į pokalbio kontekstą, pasirenka tinkamiausią:
{
"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"
}
]
}
}
Šiame pavyzdyje agentas gali:
- Ieškoti žiniatinklyje bendrų klausimų
- Tikrinti X platformoje tendencijas ir nuomones
- Gilintis į vidinę dokumentaciją techniniais klausimais
- Sukurti prašymą naudodamas funkcijų kvietimą
- Pasiekti CRM sistemą per MCP
Svarbiausi punktai
- Galimi penkių tipų įrankiai:
web_search,x_search,file_search,functionirmcp - Integruoti įrankiai (
web_search,x_search,file_search) veikia serveryje be jokio tavo kodo file_searchužklausia vektorių kolekcijas RAG tikslaisx_searchgali būti apribotas konkrečiomis paskyromis naudojantallowed_x_handles- Toje pačioje sesijoje galite derinti visų tipų įrankius