Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Għodod tas-Server u Sejħa tal-Funzjonijiet

Lezzjoni 10 / 12 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Arricchiment tal-Batches bl-Għodod
  2. Għodod fuq in-Naħa tas-Server
  3. Sejħa tal-Funzjonijiet fuq in-Naħa tal-Klijent
  4. Tagħqid tal-Għodod
  5. Limitazzjonijiet tal-Għodod tal-Batch
  6. Punti Ewlenin

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-sdk uffiċ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