Għodod tas-Server u Sejħa tal-Funzjonijiet
F'din il-paġna
Kors aġġornat fit-2 ta’ Novembru, 2026 ibbażat fuq id-dokumentazzjoni ta’ xAI: l-iskont tal-batch huwa 20% fuq mudelli tat-test eliġibbli (mhux 50%), l-eżempji jsegwu l-API REST u l-
xai-sdkuffiċjali (client.batch.*; l-API tal-Batch ta’ xAI ma tużax il-format ta’ OpenAI, l-SDK ta’ OpenAI ma japplikax), u l-API tar-Risposti għandha preċedenza fuq Chat Completions, li huwa endpoint antikwat f’xAI. Sorsi: Batch API · REST Reference · Batch Pricing.
Arricchiment tal-Batches bl-Għodod
It-talbiet tal-batch mhumiex limitati għal test sempliċi. L-għodod tas-server u s-sejħa tal-funzjonijiet jaħdmu wkoll f’mod asinkronu, b’distinzjoni ewlenija: tal-ewwel jirrunjaw waqt l-ipproċessar minn xAI, filwaqt li t-tieni jerġgħu l-kontroll lilek.
Għodod fuq in-Naħa tas-Server
L-għodod tas-server jirrunjaw waqt l-ipproċessar tal-batch, eżattament bħal f’ħin reali: Grok isejjaħ l-għodda, jirċievi r-riżultat, jintegrah fir-raġunament tiegħu, u l-batch jirritorna t-tweġiba finali. Dawn jaħdmu mal-API tar-Risposti.
Tiftix fuq il-Web
{"custom_id": "news-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What are the latest developments in quantum computing?"}], "tools": [{"type": "web_search"}]}}
Fil-modalità tal-batch, it-tiftix fuq il-web iservi għall-arrikkiment tad-data: verifika ta’ informazzjoni, ġbir ta’ fatti riċenti, u tqabbil ta’ profili ma’ sorsi online.
Tiftix fuq X
L-għodda x_search tistaqsi l-posts fuq X, utli biex issegwi s-sentiment dwar suġġett jew marka:
{"custom_id": "x-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What is the dominant sentiment on X regarding this product launch?"}], "tools": [{"type": "x_search"}]}}
Eżekuzzjoni tal-Kodiċi
Grok jista’ jikteb u jeżegwixxi kodiċi Python f’ambjent iżolat. Fl-API tar-Risposti, l-għodda tissejjaħ code_interpreter (l-SDK ta’ xAI jsejħilha code_execution):
{"custom_id": "calc-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Calculate the 3-point moving average for this data: [12, 15, 18, 14, 22, 19, 25, 28, 30, 27]"}], "tools": [{"type": "code_interpreter"}]}}
L-eżekuzzjoni tal-kodiċi hija rilevanti għal kalkoli eżatti, statistika u trasformazzjonijiet tad-data li l-mudell jimmaniġġja b’mod inqas affidabbli mill-memorja tiegħu.
Servers MCP Remoti
L-għodda mcp tikkonnettja lil Grok ma’ server MCP remot, deskritt fit-talba nnifisha: m’hemmx bżonn ta’ konfigurazzjoni minn qabel tal-kont. server_url u server_label huma meħtieġa; allowed_tools tirrestrinġi l-għodod esposti, u authorization tgħaddi token lis-server. Huma aċċettati biss it-trasporti Streamable HTTP u SSE.
{"custom_id": "mcp-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What does the xai-sdk-python repository do?"}], "tools": [{"type": "mcp", "server_label": "deepwiki", "server_url": "https://mcp.deepwiki.com/mcp"}]}}
Mingħajr allowed_tools, id-definizzjonijiet kollha tal-għodod mis-server jiġu injettati fil-kuntest tal-mudell u fatturati bħala tokens tal-input fuq kull talba tal-batch: fuq 50,000 talba, ir-restrizzjoni tal-lista tħallas malajr.
Sejħa tal-Funzjonijiet fuq in-Naħa tal-Klijent
Is-sejħa tal-funzjonijiet hija għodda fuq in-naħa tal-klijent: Grok jipproduċi sejħa strutturata tal-funzjoni, iżda l-kodiċi tiegħek jeżegwixxiha. Fil-batch, il-mudell jirritorna dawn is-sejħiet fir-riżultati tiegħu, għall-ipproċessar offline.
Definizzjonijiet tal-Funzjonijiet
Fl-API tar-Risposti, iddikjara l-funzjoni b’mod ċatt, b’name, description, u parameters fil-livell ogħla. tool_choice: "required" jifforza lill-mudell isejjaħ mill-inqas għodda waħda, li jixraq għall-estrazzjoni:
{"custom_id": "extract-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Extract the contact: Jean Dupont, 01 23 45 67 89, [email protected]"}], "tools": [{"type": "function", "name": "save_contact", "description": "Saves a contact extracted from text", "parameters": {"type": "object", "properties": {"name": {"type": "string"}, "phone": {"type": "string"}, "email": {"type": "string"}}, "required": ["name"]}}], "tool_choice": "required"}}
Ipproċessar tar-Riżultati
Bl-SDK, aqra s-sejħiet tal-funzjonijiet f’tool_calls ta’ kull riżultat ta’ suċċess:
import json
for r in page.succeeded:
for call in r.response.tool_calls:
if call.function.name == "save_contact":
contact = json.loads(call.function.arguments)
save_to_database(r.batch_request_id, contact)
Is-sejħa tal-funzjonijiet tal-batch hija ideali għall-estrazzjoni strutturata: tiddefinixxi l-iskema tad-data, Grok jaqra d-dokumenti u jipproduċi s-sejħiet, imbagħad tipproċessahom bl-ingrossa.
Tagħqid tal-Għodod
Tista’ tgħaqqad għodod multipli tas-server f’talba waħda:
{"custom_id": "multi-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Find the Bitcoin closing price for the last seven days and calculate its change"}], "tools": [{"type": "web_search"}, {"type": "code_interpreter"}]}}
Grok juża l-għodod fl-ordni li jqis rilevanti: hawnhekk, tiftix fuq il-web biex tikseb id-data, imbagħad eżekuzzjoni tal-kodiċi għall-kalkolu.
Limitazzjonijiet tal-Għodod tal-Batch
- L-għodod tas-server jestendu l-ħin tal-ipproċessar ta’ kull talba, u għalhekk tal-batch
- It-talbiet bit-tiftix jiddependu fuq dak li jippubblikaw is-sorsi waqt l-ipproċessar, mhux waqt is-sottomissjoni
- Is-sejħa tal-funzjonijiet tagħmel dawra waħda biss għal kull talba: biex tkompli, issottometti talba ġdida tal-batch li fiha l-konversazzjoni u r-riżultati tal-funzjoni tiegħek
- Id-definizzjonijiet tal-għodod MCP mhux iffiltrati jneffħu kull talba
Punti Ewlenin
- L-għodod tas-server (web, X, kodiċi, MCP) jirrunjaw minn xAI waqt l-ipproċessar, permezz tal-API tar-Risposti
- Iddeskrivi server MCP fit-talba (
server_url,server_label), mingħajr konfigurazzjoni minn qabel - Is-sejħa tal-funzjonijiet tirritorna sejħiet strutturati li inti teżegwixxi fuq in-naħa tal-klijent
- Skambju multi-turn jeħtieġ talba ġdida tal-batch għal kull dawra
- Irrestrinġi l-għodod esposti biex tevita li tħallas għad-definizzjonijiet tagħhom fuq kull talba