Nativní nástroje: vyhledávání na webu, X a kolekce
Na této stránce
Nativní nástroje hlasového agenta
Kromě vlastního volání funkcí a serverů MCP nabízí Voice Agent API několik vestavěných nástrojů, které může agent během konverzace používat samostatně. Tyto nástroje nevyžadují žádnou prováděcí logiku na tvé straně: vše kompletně zpracovávají servery xAI.
web_search: vyhledávání na webu
Tento nástroj umožňuje agentovi vyhledávat informace na webu v reálném čase přímo během konverzace:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Když se uživatel zeptá na faktickou otázku („Jaké je počasí v Paříži?“, „Kdo vyhrál včerejší zápas?“), agent automaticky spustí vyhledávání na webu a výsledky využije k sestavení své mluvené odpovědi.
Pro vestavěné nástroje se klientovi neodesílá žádná specifická událost: agent výsledky použije interně a zapracuje je do své zvukové odpovědi.
x_search: vyhledávání na platformě X (Twitter)
Tento nástroj umožňuje agentovi vyhledávat příspěvky na platformě X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Parametr allowed_x_handles je volitelný. Pokud je nastaven, vyhledávání se omezí pouze na příspěvky z těchto konkrétních účtů. Bez něj agent prohledává celou platformu X.
Příklady využití x_search
- Monitorování konkurence: „Co tento týden zveřejnila [konkurence]?“
- Zákaznická podpora: „Objevily se na X nějaké nedávné stížnosti na náš produkt?“
- Zpravodajství: „Co je nového v oblasti [téma]?“
- Trendy: „O čem lidé právě teď diskutují v odvětví [odvětví]?“
file_search: vyhledávání v RAG kolekcích
Nástroj file_search umožňuje hlasovému agentovi dotazovat se na kolekce vektorizovaných dokumentů (RAG). Je ideální pro agenty, kteří potřebují přístup k interní znalostní bázi:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parametry
vector_store_ids: ID vektorových kolekcí, na které se má dotazovat. Můžeš uvést několik ID pro kombinaci různých zdrojů znalostí.max_num_results: Maximální počet vrácených výsledků (výchozí hodnota je 10).
Scénáře použití
- Hlasové FAQ: Agent odpovídá na otázky zákazníků na základě tvé dokumentace.
- Technická podpora: Vyhledávání v manuálech a průvodcích řešením problémů.
- Vzdělávání: Agent má přístup k obsahu kurzů, aby mohl odpovídat na otázky studentů.
- Právní asistence: Vyhledávání ve smlouvách a právních dokumentech.
Kombinace více nástrojů
Můžeš povolit několik nástrojů najednou. Agent si na základě kontextu konverzace vybere ten nejrelevantnější:
{
"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 příkladu může agent:
- Vyhledávat na webu obecné informace.
- Kontrolovat platformu X kvůli trendům a názorům.
- Prohledávat interní dokumentaci pro technické dotazy.
- Vytvářet ticket prostřednictvím volání funkce.
- Přistupovat k CRM systému přes MCP.
Klíčové poznatky
- K dispozici je pět typů nástrojů:
web_search,x_search,file_search,functionamcp. - Vestavěné nástroje (
web_search,x_search,file_search) běží na serveru bez nutnosti psát jakýkoli kód na tvé straně. file_searchse dotazuje na vektorové kolekce pro účely RAG.x_searchlze pomocí parametruallowed_x_handlesomezit na konkrétní účty.- V rámci jedné relace můžeš kombinovat všechny typy nástrojů.