Ugrađeni alati: web pretraga, X i kolekcije
Na ovoj stranici
Izvorni alati glasovnog agenta
Osim pozivanja prilagođenih funkcija i MCP poslužitelja, API glasovnog agenta nudi nekoliko ugrađenih alata koje agent može samostalno koristiti tijekom razgovora. Ovi alati ne zahtijevaju nikakvu logiku izvršavanja s tvoje strane: poslužitelji tvrtke xAI u potpunosti ih obrađuju.
web_search: pretraga weba
Ovaj alat omogućuje agentu da u stvarnom vremenu tijekom razgovora traži informacije na webu:
{
"type": "session.update",
"session": {
"tools": [
{"type": "web_search"}
]
}
}
Kada korisnik postavi činjenično pitanje („Kakvo je vrijeme u Parizu?“, „Tko je jučer pobijedio u utakmici?“), agent automatski pokreće web pretragu i koristi rezultate za sastavljanje svog usmenog odgovora.
Za ugrađene alate klijentu se ne šalje nikakav specifičan događaj: agent rezultate koristi interno i uključuje ih u svoj zvučni odgovor.
x_search: pretraga platforme X (Twitter)
Ovaj alat omogućuje agentu pretragu objava na platformi X:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "x_search",
"allowed_x_handles": ["xai", "gaborcselle"]
}
]
}
}
Parametar allowed_x_handles je opcionalan. Kada je postavljen, pretraga je ograničena na objave s tih specifičnih računa. Bez njega, agent pretražuje cijeli X.
Slučajevi upotrebe za x_search
- Praćenje konkurencije: „Što je [konkurent] objavio ovaj tjedan?“
- Korisnička podrška: „Postoje li nedavne pritužbe na naš proizvod na X-u?“
- Vijesti: „Što je najnovije o [temi]?“
- Trendovi: „O čemu ljudi trenutno razgovaraju u [industriji]?“
file_search: pretraga RAG kolekcija
Alat file_search omogućuje glasovnom agentu upite nad kolekcijama vektoriziranih dokumenata (RAG). To je idealan alat za agente kojima je potreban pristup internoj bazi 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-jevi vektorskih kolekcija za upit. Možeš navesti nekoliko njih kako bi kombinirao različite izvore znanja.max_num_results: Maksimalni broj rezultata za vraćanje (zadano je 10).
Scenariji upotrebe
- Glasovni FAQ: agent odgovara na pitanja korisnika na temelju tvoje dokumentacije.
- Tehnička podrška: pretraživanje priručnika i vodiča za rješavanje problema.
- Obuka: agent ima pristup sadržaju tečaja kako bi odgovorio na pitanja polaznika.
- Pravna pomoć: pretraživanje ugovora i pravnih dokumenata.
Kombiniranje više alata
Možeš istovremeno omogućiti nekoliko alata. Agent odabire najrelevantniji na temelju konteksta razgovora:
{
"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"
}
]
}
}
U ovom primjeru agent može:
- Pretraživati web za opća pitanja
- Provjeravati X za trendove i mišljenja
- Dubinski analizirati internu dokumentaciju za tehnička pitanja
- Kreirati tiket putem pozivanja funkcije
- Pristupiti CRM-u putem MCP-a
Ključne točke
- Dostupno je pet vrsta alata:
web_search,x_search,file_search,functionimcp - Ugrađeni alati (
web_search,x_search,file_search) izvršavaju se na poslužitelju bez potrebe za tvojim kodom file_searchupućuje upite vektorskim kolekcijama za RAGx_searchmože biti ograničen na specifične račune pomoćuallowed_x_handles- U istoj sesiji možeš kombinirati sve vrste alata