Vgrajena orodja: spletno iskanje, X in zbirke
Na tej strani
Izvirna orodja glasovnega agenta
Poleg klicanja prilagojenih funkcij in strežnikov MCP ponuja API glasovnega agenta več vgrajenih orodij, ki jih agent lahko samostojno uporablja med pogovorom. Za ta orodja ne potrebuješ nobene izvedbene logike na svoji strani: strežniki xAI jih v celoti obdelajo namesto tebe.
web_search: iskanje po spletu
To orodje omogoča agentu, da med pogovorom v realnem času poišče informacije na spletu:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Ko uporabnik zastavi dejansko vprašanje („Kakšno je vreme v Parizu?”, „Kdo je sinoči zmagal na tekmi?”), agent samodejno izvede spletno iskanje in rezultate uporabi za sestavo svojega govornega odgovora.
Za vgrajena orodja se odjemalcu ne pošlje noben poseben dogodek: agent rezultate uporabi interno in jih vključi v svoj zvočni odziv.
x_search: iskanje po platformi X (Twitter)
To orodje omogoča agentu iskanje objav na platformi X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Parameter allowed_x_handles je izbirni. Ko je nastavljen, je iskanje omejeno na objave teh določenih računov. Brez njega agent išče po celotni platformi X.
Primeri uporabe orodja x_search
- Spremljanje konkurence: „Kaj je [konkurent] objavil ta teden?”
- Podpora strankam: „Ali obstajajo kakšne nedavne pritožbe glede našega izdelka na X?”
- Novice: „Kaj je najnovejšega glede [teme]?”
- Trendi: „O čem ljudje trenutno govorijo v [panogi]?“
file_search: iskanje po zbirkah RAG
Orodje file_search omogoča glasovnemu agentu poizvedbe po zbirkah vektoriziranih dokumentov (RAG). To je idealno orodje za agente, ki potrebujejo dostop do interne baze znanja:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "file_search",
"vector_store_ids": ["vs_abc123", "vs_def456"],
"max_num_results": 10
}
]
}
}
Parametri
vector_store_ids: ID-ji vektorskih zbirk za poizvedbo. Našteješ lahko več ID-jev za združevanje različnih virov znanja.max_num_results: največje število vrnjenih rezultatov (privzeto 10).
Scenariji uporabe
- Glasovni FAQ: agent odgovarja na vprašanja strank na podlagi vaše dokumentacije.
- Tehnična podpora: iskanje po priročnikih in vodnikih za odpravljanje težav.
- Usposabljanje: agent ima dostop do vsebine tečaja za odgovarjanje na vprašanja učencev.
- Pravna pomoč: iskanje po pogodbah in pravnih dokumentih.
Združevanje več orodij
Hkrati lahko omogočiš več orodij. Agent glede na kontekst pogovora sam izbere najustreznejše:
{
"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 tem primeru agent lahko:
- Išče po spletu za splošna vprašanja,
- preverja X za trende in mnenja,
- brska po interni dokumentaciji za tehnična vprašanja,
- ustvari tiket prek klica funkcije,
- dostopa do CRM sistema prek MCP.
Ključne ugotovitve
- Na voljo je pet vrst orodij:
web_search,x_search,file_search,functioninmcp. - Vgrajena orodja (
web_search,x_search,file_search) se izvajajo na strežniku brez potrebe po tvoji kodi. file_searchizvaja poizvedbe po vektorskih zbirkah za RAG.x_searchlahko z parametromallowed_x_handlesomejiš na določene račune.- V isti seji lahko združiš vse vrste orodij.