Beépített eszközök: webes keresés, X és gyűjtemények
Ezen az oldalon
A Voice Agent natív eszközei
Az egyéni függvényhívások és az MCP-kiszolgálók mellett a Voice Agent API számos beépített eszközt biztosít, amelyeket az ügynök a beszélgetés során önállóan használhat. Ezekhez az eszközökhöz nincs szükséged saját végrehajtási logikára: a xAI szerverei teljes mértékben kezelik őket.
web_search: keresés a weben
Ez az eszköz lehetővé teszi az ügynök számára, hogy valós időben keressen információkat a weben a beszélgetés közben:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Amikor a felhasználó tényekre irányuló kérdést tesz fel („Milyen az időjárás Párizsban?“, „Ki nyerte tegnap este a meccset?“), az ügynök automatikusan webes keresést végez, és az eredményeket felhasználva állítja össze a szóbeli válaszát.
A beépített eszközökhöz nem tartozik külön esemény, amelyet a kliens felé küldenének: az ügynök belsőleg használja fel az eredményeket, és beépíti őket a hangválaszába.
x_search: keresés az X-en (Twitter)
Ez az eszköz lehetővé teszi az ügynök számára, hogy bejegyzéseket keressen az X platformon:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Az allowed_x_handles paraméter opcionális. Ha megadod, a keresés csak az adott fiókok bejegyzéseire korlátozódik. Enélkül az ügynök az egész X-en keres.
Az x_search felhasználási esetei
- Versenytársfigyelés: „Mit posztolt a [versenytárs] ezen a héten?“
- Ügyfélszolgálat: „Van-e friss panasz a termékünkről az X-en?“
- Hírek: „Mi a legfrissebb hír a [témával] kapcsolatban?“
- Trendek: „Miről beszélnek most az emberek a [iparágban]?“
file_search: keresés RAG-gyűjteményekben
A file_search eszköz lehetővé teszi a hangügynök számára, hogy vektorizált dokumentumok (RAG) gyűjteményeit kérdezze le. Ez az ideális eszköz azoknak az ügynököknek, amelyeknek hozzáférésre van szükségük egy belső tudásbázishoz:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Paraméterek
vector_store_ids: a lekérdezni kívánt vektorgyűjtemények azonosítói. Többet is felsorolhatsz különböző tudásforrások kombinálásához.max_num_results: a visszaadandó találatok maximális száma (alapértelmezés szerint 10).
Felhasználási forgatókönyvek
- Hangalapú GYIK: az ügynök a dokumentációd alapján válaszol az ügyfelek kérdéseire.
- Műszaki támogatás: kézikönyvek és hibaelhárítási útmutatók keresése.
- Oktatás: az ügynök hozzáfér a tananyaghoz, hogy válaszoljon a tanulók kérdéseire.
- Jogi segítség: szerződések és jogi dokumentumok keresése.
Több eszköz kombinálása
Egyszerre több eszközt is engedélyezhetsz. Az ügynök a beszélgetés kontextusa alapján választja ki a legrelevánsabbat:
{
"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"
}
]
}
}
Ebben a példában az ügynök képes:
- Általános kérdések esetén a weben keresni
- Trendek és vélemények után kutatni az X-en
- Műszaki kérdések esetén beleásni magát a belső dokumentációba
- Jegyet létrehozni függvényhívással
- Hozzáférni a CRM-hez az MCP-n keresztül
Főbb megállapítások
- Ötféle eszköz áll rendelkezésre:
web_search,x_search,file_search,functionésmcp - A beépített eszközök (
web_search,x_search,file_search) a szerveren futnak, kódírás nélkül a részedről - A
file_searchvektorgyűjteményeket kérdez le RAG céljából - Az
x_searchkorlátozható konkrét fiókokra azallowed_x_handlesparaméterrel - Minden eszköztípus kombinálható ugyanabban a munkamenetben