Serveri ja kliendi tööriistade kombineerimine
Sellel lehel
Kaks tööriistakategooriat samal platvormil
Grok API eristab täitmise põhjal kahte fundamentaalselt erinevat tööriistatüüpi. Selle erinevuse mõistmine on hädavajalik töökindlate arhitektuuride loomisel.
Sisseehitatud tööriistad (serveripoolsed)
xAI täidab need tööriistad automaatselt oma serverites. Sa ei pea midagi haldama – ei kohalikku täitmist ega tulemuste edastamist. Mudel kutsub neid ja saab tulemused otse kätte.
| Tööriist | Identifikaator | Kirjeldus |
|---|---|---|
| Web Search | web_search | Reaalajas veebiotsing |
| X Search | x_search | Otsing X-is/Twitteris |
| Code Interpreter | code_interpreter | Liivakastis Pythoni käivitamine |
| Collections Search | collections_search | Otsing üleslaaditud dokumentidest |
| Remote MCP | mcp | Ühendus väliste MCP-serveritega |
Kohandatud funktsioonid (kliendipoolsed)
Need on sinu enda funktsioonid, mis on defineeritud funktsioonide kutsumise (function calling) kaudu. Mudel tagastab tool_call, sinu kood käivitab funktsiooni ja sa saadad tulemuse tagasi. See on mehhanism, mille õppisid eelmistes tundides.
Mõlema kombineerimine ühes päringus
Grok API võimsus peitub võimaluses kombineerida serveri ja kliendi tööriistu ühes päringus:
tools = [
# Serveri tööriist — xAI täidab automaatselt
{"type": "web_search"},
# Kliendi tööriist — sinu kood täidab
{
"type": "function",
"function": {
"name": "save_to_database",
"description": "Salvesta teave andmebaasi",
"parameters": {
"type": "object",
"properties": {
"key": {"type": "string"},
"value": {"type": "string"}
},
"required": ["key", "value"]
}
}
}
]
Kui mudel saab selle päringu, saab ta:
- Kasutada
web_searchinfo leidmiseks (automaatne serveripoolne täitmine) - Kutsuda
save_to_databasetulemuse salvestamiseks (tagastatakse kliendile)
Hübriidne voog
Käitumine erineb sõltuvalt tööriista tüübist:
- Serveri tööriist: mudel kutsub tööriista, xAI täidab selle, tulemus integreeritakse automaatselt ja mudel jätkab tööd.
- Kliendi tööriist: mudel tagastab
tool_callkliendile, täitmine peatub ja jätkub alles siis, kui saadad tulemuse tagasi.
Kui mudel kasutab mõlemat tüüpi samas päringus, täidetakse serveri tööriistad esimesena (sinu sekkumiseta). Seejärel, kui mudel vajab ka kliendi tööriista, tagastab ta sulle tool_call, olles juba integreerinud serveri tööriistade tulemused oma konteksti.
Reaalsed näited
Veebiotsing + äriloogika
# Kasutaja küsib: "Leia Bitcoini hind ja salvesta see"
# Mudel:
# 1. Kutsub web_search hinna leidmiseks (serveripoolne, automaatne)
# 2. Kutsub save_price(symbol="BTC", price=68432) (kliendipoolne)
X-i otsing + teavitus
# "Teavita mind tweetidest meie toote kohta alates eilsest"
# Mudel:
# 1. Kutsub x_search tweetide leidmiseks (serveripoolne)
# 2. Kutsub send_notification(count=12, summary="...") (kliendipoolne)
Koodi interpretaator + salvestamine
# "Arvuta nende andmete keskmine ja salvesta tulemus"
# Mudel:
# 1. Kutsub code_interpreter arvutuse tegemiseks (serveripoolne)
# 2. Kutsub save_result(key="avg", value="42.5") (kliendipoolne)
Serveri tööriistade arveldus
Sisseehitatud tööriistade eest arvestatakse tasu kahel viisil:
- Tokenid: standardne tarbimine (sisend + väljund)
- Kutsed: fikseeritud kulu iga tööriista kutse kohta
Mudel võib ühe päringu jaoks kutsuda mitut serveri tööriista – kulud liituvad. Pea seda silmas, kui lubad web_search: mudel võib tulemuste täpsustamiseks teha mitu otsingut.
Peamised punktid
- Kaks tööriistatüüpi: server (automaatne) ja kliient (funktsioonide kutsumine)
- Serveri tööriistad (
web_search,x_search,code_interpreter) täidetakse ilma sinu sekkumiseta - Saad mõlemat tüüpi kombineerida ühes päringus
- Serveri tööriistad täidetakse esimesena, seejärel saab mudel kutsuda sinu funktsioone
- Iga serveri tööriista kutse on tasuline (tokenid + kulu kutse kohta)
- Serveri tööriistadest pärit andmete jaoks genereeritakse viited automaatselt