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

Outputs Strutturati u Eżekuzzjoni tal-Kodiċi

Lezzjoni 9 / 12 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Eżegwixxi l-Kodiċi u Struttura r-Riżultati
  2. Karatteristika ta’ Grok 4 u Aktar ‘Il Quddiem
  3. Każ ta’ Użu Tipiku: Kalkoli Preċiżi
  4. Eżempju: Analiżi Statistika
  5. Għaqqad it-Tiftix fuq il-Web u l-Eżekuzzjoni tal-Kodiċi
  6. Limiti tal-Eżekuzzjoni tal-Kodiċi
  7. Punti Ewlenin

Aġġornat fit-2 ta’ Novembru, 2026. Ibbażat fuq id-dokumentazzjoni ta’ xAI: mal-xai-sdk, l-outputs strutturati jingħaqdu mal-għodod billi tinħoloq il-konversazzjoni (client.chat.create(..., tools=[code_execution()])), imbagħad tissejjaħ chat.parse(Schema), li tirritorna r-risponsa u l-oġġett ittajpjat; l-eżempju preċedenti sejjaħ client.chat.parse(...) b’argumenti ta’ Chat Completions, metodu li ma jeżisti f’ebda SDK. Sorsi: Structured Outputs · Code Execution.

Eżegwixxi l-Kodiċi u Struttura r-Riżultati

Il-kombinazzjoni ta’ outputs strutturati mal-eżekuzzjoni tal-kodiċi tippermetti lill-mudell jikkalkula r-riżultati u jirritornahom f’format strutturat. Il-mudell jikteb il-kodiċi, jeżegwixxih f’ambjent iżolat (sandboxed), u jifforma l-output skont l-iskema tiegħek.

Karatteristika ta’ Grok 4 u Aktar ‘Il Quddiem

Bħat-tiftix fuq il-web, din il-kombinazzjoni hija riżervata għall-mudelli Grok 4 u aktar ‘il quddiem—jiġifieri l-linja kollha attwali (Grok 4.5, Grok 4.3, varjanti grok-4.20). Mudelli aktar bikrin ma kinux jappoġġjaw il-kombinazzjoni ta’ għodod ma’ outputs strutturati.

Każ ta’ Użu Tipiku: Kalkoli Preċiżi

Il-vantaġġ prinċipali tal-eżekuzzjoni tal-kodiċi b’outputs strutturati hija l-preċiżjoni tal-kalkolu. L-LLMs spiss jagħmlu żbalji aritmetiċi. Billi teżegwixxi l-kodiċi, ir-riżultati huma matematiċament eżatti.

from pydantic import BaseModel
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import code_execution

client = Client()  # key read from XAI_API_KEY

class FinancialAnalysis(BaseModel):
    total_revenue: float
    total_cost: float
    gross_margin: float
    margin_percentage: float
    most_profitable_product: str
    least_profitable_product: str

chat = client.chat.create(
    model="grok-4.20-0309-reasoning",
    tools=[code_execution()],
)
chat.append(user("""Here are the quarterly sales:
- Product A: 150 units at €45, unit cost €28
- Product B: 320 units at €22, unit cost €15
- Product C: 85 units at €120, unit cost €78

Calculate the complete financial analysis."""))

response, parsed = chat.parse(FinancialAnalysis)

print(f"Gross margin: €{parsed.gross_margin}")
print(f"Margin: {parsed.margin_percentage}%")
print(f"Best product: {parsed.most_profitable_product}")

Il-mudell se jikteb skript Python biex iwettaq il-kalkoli, jeżegwixxih, u mbagħad jifforma r-riżultati fl-iskema FinancialAnalysis.

Eżempju: Analiżi Statistika

class DescriptiveStatistics(BaseModel):
    mean: float
    median: float
    std_dev: float
    minimum: float
    maximum: float
    quartile_1: float
    quartile_3: float
    value_count: int

chat = client.chat.create(
    model="grok-4.20-0309-reasoning",
    tools=[code_execution()],
)
chat.append(user("""Calculate the descriptive statistics for this data:
[23, 45, 12, 67, 34, 89, 56, 78, 41, 33, 61, 25,
 72, 48, 55, 39, 64, 71, 28, 50]"""))

response, parsed = chat.parse(DescriptiveStatistics)

print(f"Mean: {parsed.mean}")
print(f"Std dev: {parsed.std_dev}")

Għaqqad it-Tiftix fuq il-Web u l-Eżekuzzjoni tal-Kodiċi

Tista’ tattiv iż-żewġ għodod fl-istess ħin:

class MarketAnalysis(BaseModel):
    company: str
    current_price: float
    change_30d: float
    avg_volume: float
    trend: str
    recommendation: str

from xai_sdk.tools import web_search

chat = client.chat.create(
    model="grok-4.20-0309-reasoning",
    tools=[web_search(), code_execution()],
)
chat.append(user("Analyze Apple stock over the last 30 days"))

response, parsed = chat.parse(MarketAnalysis)

Il-mudell se jiġbed dejta reċenti mill-web, imbagħad juża l-eżekuzzjoni tal-kodiċi biex jikkalkula l-bidliet u l-medji.

Limiti tal-Eżekuzzjoni tal-Kodiċi

  • L-ambjent ta’ eżekuzzjoni huwa iżolat u effimeru
  • Pakketti Python komuni huma diġà installati (NumPy, Pandas, Matplotlib, SciPy)
  • Il-ħin ta’ eżekuzzjoni u l-memorja huma limitati
  • L-ebda aċċess għan-network mill-kodiċi eżegwit
  • Il-fajls maħluqa ma jibqgħux bejn sejħiet differenti

Punti Ewlenin

  • L-eżekuzzjoni tal-kodiċi flimkien ma’ outputs strutturati teħtieġ mill-inqas Grok 4—il-linja kollha attwali hija kompatibbli
  • Il-mudell jikteb u jeżegwixxi l-kodiċi għal kalkoli preċiżi
  • Attiva l-għodda b’code_execution() fl-xAI SDK, jew {"type": "code_interpreter"} fir-Responses API, imbagħad ikseb l-oġġett ittajpjat b’chat.parse(Schema)
  • Tista’ tingħaqad ma’ web_search biex tfittex u mbagħad tikkalkula
  • Ideali għal analiżi finanzjarja, statistika u matematika
  • Ir-riżultati kkalkulati huma eżatti, kuntrarjament għall-istimi tal-LLM