Vstavané nástroje: vyhľadávanie na webe, X a kolekcie
Na tejto strane
Natívne nástroje hlasového agenta
Okrem vlastného volania funkcií a serverov MCP ponúka Voice Agent API niekoľko vstavaných nástrojov, ktoré môže agent počas konverzácie používať samostatne. Tieto nástroje nevyžadujú žiadnu vykonávaciu logiku na tvojej strane: všetko úplne vybavujú servery xAI.
web_search: vyhľadávanie na webe
Tento nástroj umožňuje agentovi vyhľadávať informácie na webe v reálnom čase priamo počas konverzácie:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Keď sa používateľ opýta na faktickú otázku („Aké je počasie v Paríži?“, „Kto vyhral včera večer zápas?“), agent automaticky spustí vyhľadávanie na webe a použije výsledky na zostavenie svojej hovorenej odpovede.
Pre vstavané nástroje sa klientovi neodosiela žiadna špecifická udalosť: agent využíva výsledky interne a zapracúva ich do svojej zvukovej odpovede.
x_search: vyhľadávanie na X (Twitter)
Tento nástroj umožňuje agentovi vyhľadávať príspevky na platforme X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Parameter allowed_x_handles je voliteľný. Ak je nastavený, vyhľadávanie sa obmedzí na príspevky z týchto konkrétnych účtov. Bez neho agent vyhľadáva v celom obsahu platformy X.
Prípady použitia x_search
- Monitorovanie konkurencie: „Čo tento týždeň zverejnila [konkurencia]?“
- Zákaznícka podpora: „Vyskytli sa v poslednom čase na X nejaké sťažnosti na náš produkt?“
- Spravodajstvo: „Aké sú najnovšie informácie o [téma]?“
- Trendy: „O čom ľudia práve teraz hovoria v odvetví [odvetvie]?“
file_search: vyhľadávanie v kolekciách RAG
Nástroj file_search umožňuje hlasovému agentovi dopytovať kolekcie vektorizovaných dokumentov (RAG). Je ideálny pre agentov, ktorí potrebujú prístup k internej znalostnej báze:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parametre
vector_store_ids: ID vektorových kolekcií, ktoré sa majú dopytovať. Môžeš uviesť viacero ID a skombinovať tak rôzne zdroje znalostí.max_num_results: Maximálny počet vrátených výsledkov (predvolené je 10).
Scenáre použitia
- Hlasové FAQ: Agent odpovedá na otázky zákazníkov na základe tvojej dokumentácie.
- Technická podpora: Vyhľadávanie v manuáloch a sprievodcoch riešením problémov.
- Vzdelávanie: Agent má prístup k obsahu kurzov, aby mohol odpovedať na otázky účastníkov.
- Právna asistencia: Vyhľadávanie v zmluvách a právnych dokumentoch.
Kombinácia viacerých nástrojov
Môžeš povoliť viacero nástrojov naraz. Agent si na základe kontextu konverzácie vyberie ten najrelevantnejší:
{
"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"
}
]
}
}
V tomto príklade môže agent:
- Vyhľadávať na webe všeobecné odpovede
- Kontrolovať platformu X kvôli trendom a názorom
- Hľadať v internej dokumentácii technické odpovede
- Vytvoriť tiket prostredníctvom volania funkcie
- Pristupovať do CRM cez MCP
Kľúčové poznatky
- K dispozícii je päť typov nástrojov:
web_search,x_search,file_search,functionamcp - Vstavané nástroje (
web_search,x_search,file_search) bežia na serveri bez potreby tvoho kódu file_searchdopytuje vektorové kolekcie pre RAGx_searchmôžeš obmedziť na konkrétne účty pomocouallowed_x_handles- V rámci jednej relácie môžeš kombinovať všetky typy nástrojov