Servera un klienta rīku apvienošana
Šajā lapā
Divas rīku kategorijas vienā platformā
Grok API nošķir divus fundamentāli atšķirīgus rīku veidus, balstoties uz to izpildi. Šīs atšķirības izpratne ir būtiska, lai izstrādātu stabilas arhitektūras.
Iebūvētie rīki (servera pusē)
xAI šos rīkus izpilda automātiski savos serveros. Tev nekas nav jāpārvalda — nav lokālas izpildes, nav rezultātu pārsūtīšanas. Modelis tos izsauc un saņem rezultātus tieši.
| Rīks | Identifikators | Apraksts |
|---|---|---|
| Web Search | web_search | Meklēšana tīmeklī reāllaikā |
| X Search | x_search | Meklēšana vietnē X/Twitter |
| Code Interpreter | code_interpreter | Python koda izpilde smilškastē |
| Collections Search | collections_search | Meklēšana augšupielādētajos dokumentos |
| Remote MCP | mcp | Savienojums ar ārējiem MCP serveriem |
Pielāgotas funkcijas (klienta pusē)
Tās ir tavas pašas definētās funkcijas, izmantojot funkciju izsaukumus (function calling). Modelis atgriež tool_call, tavs kods izpilda funkciju, un tu nosūti rezultātu atpakaļ. Tas ir mehānisms, ko apguvi iepriekšējās nodarbībās.
Abu veidu apvienošana vienā pieprasījumā
Grok API spēks slēpjas iespējā apvienot servera un klienta rīkus vienā pieprasījumā:
tools = [
# Servera rīks — xAI izpilda automātiski
{"type": "web_search"},
# Klienta rīks — izpilda tavs kods
{
"type": "function",
"function": {
"name": "save_to_database",
"description": "Saglabā informāciju datubāzē",
"parameters": {
"type": "object",
"properties": {
"key": {"type": "string"},
"value": {"type": "string"}
},
"required": ["key", "value"]
}
}
}
]
Kad modelis saņem šo pieprasījumu, tas var:
- Izmantot
web_search, lai atrastu informāciju (automātiska izpilde servera pusē) - Izsaukt
save_to_database, lai saglabātu rezultātu (atgriež klientam)
Hibrīdā plūsma
Uzvedība atšķiras atkarībā no rīka veida:
- Servera rīks: modelis izsauc rīku, xAI to izpilda, rezultāts tiek automātiski integrēts, un modelis turpina darbu.
- Klienta rīks: modelis atgriež
tool_callklientam, izpilde apstājas un atsākas tikai tad, kad tu nosūti rezultātu atpakaļ.
Kad modelis vienā pieprasījumā izmanto abus veidus, servera rīki tiek izpildīti vispirms (bez tavas iejaukšanās). Pēc tam, ja modelim ir nepieciešams arī klienta rīks, tas atgriež tev tool_call, kurā servera rīku rezultāti jau ir integrēti tā kontekstā.
Reāli piemēri
Meklēšana tīmeklī + biznesa loģika
# Lietotājs jautā: "Atrodi Bitcoin cenu un saglabā to"
# Modelis:
# 1. Izsauc web_search, lai atrastu cenu (servera puse, automātiski)
# 2. Izsauc save_price(symbol="BTC", price=68432) (klienta puse)
Meklēšana vietnē X + paziņojums
# "Paziņo man par tvītiem par mūsu produktu kopš vakardienas"
# Modelis:
# 1. Izsauc x_search, lai atrastu tvītus (servera puse)
# 2. Izsauc send_notification(count=12, summary="...") (klienta puse)
Koda interpretators + glabāšana
# "Aprēķini šo datu vidējo vērtību un saglabā rezultātu"
# Modelis:
# 1. Izsauc code_interpreter aprēķina veikšanai (servera puse)
# 2. Izsauc save_result(key="avg", value="42.5") (klienta puse)
Servera rīku tarifikācija
Iebūvētie rīki tiek tarifēti divos veidos:
- Tokeni: standarta patēriņš (ievade + izvade)
- Izsaukumi: fiksētas izmaksas par katru rīka izsaukumu
Modelis viena pieprasījuma ietvaros var izsaukt vairākus servera rīkus — izmaksas summējas. Ņem to vērā, kad aktivizē web_search: modelis var veikt vairākas meklēšanas, lai precizētu rezultātus.
Galvenās atziņas
- Divi rīku veidi: servera (automātiski) un klienta (funkciju izsaukumi)
- Servera rīki (
web_search,x_search,code_interpreter) tiek izpildīti bez tavas iejaukšanās - Abus veidus vari apvienot vienā pieprasījumā
- Servera rīki tiek izpildīti vispirms, pēc tam modelis var izsaukt tavas funkcijas
- Par katru servera rīka izsaukumu tiek piemērota maksa (tokeni + maksa par izsaukumu)
- Citāti tiek ģenerēti automātiski datiem, kas iegūti no servera rīkiem