Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Aschurtha Struchtúrtha agus Feidhmiú Cóid

Ceacht 9 as 12 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Cód a Fheidhmiú agus Torthaí a Struchtúrú
  2. Gné do Grok 4 agus Leaganacha Níos Déanaí
  3. Cás Úsáide Tipiciúil: Ríomhaireachtaí Cruinne
  4. Sampla: Anailís Staitistiúil
  5. Cuardach Gréasáin agus Feidhmiú Cóid a Chomhcheangal
  6. Teorainneacha Feidhmithe Cóid
  7. Príomhphointí

Nuashonraithe an 2 Samhain, 2026. Bunaithe ar dhoiciméadú xAI: leis an xai-sdk, cumascann aschurtha struchtúrtha le huirlisí trí an comhrá a chruthú (client.chat.create(..., tools=[code_execution()])), agus ansin chat.parse(Schema) a ghlaowh, a thugann ar ais an freagra agus an réad típithe; ní raibh an sampla roimhe seo ag glaoch ar client.chat.parse(...) le hargóintí Chat Completions, modh nach bhfuil ann in aon SDK. Foinse: Aschurtha Struchtúrtha · Feidhmiú Cóid.

Cód a Fheidhmiú agus Torthaí a Struchtúrú

Trí aschurtha struchtúrtha a chomhcheangal le feidhmiú cóid, ligeann tú don mhúnla torthaí a ríomh agus iad a chur ar ais i bhformáid struchtúrtha. Scríobhann an múnla cód, feidhmíonn sé é i dtimpeallacht ghainimh (sandboxed), agus déanann sé formáidiú ar an aschur de réir do scéime.

Gné do Grok 4 agus Leaganacha Níos Déanaí

Cosúil le cuardach gréasáin, tá an comhcheangal seo curtha in áirithe do mhúnlaí Grok 4 agus níos déanaí—rud a chiallaíonn go bhfuil an líne táirgeachta reatha ar fad comhoiriúnach (Grok 4.5, Grok 4.3, leaganacha grok-4.20). Níor thacaigh múnlaí níos luaithe le huirlisí a chomhcheangal le haschurtha struchtúrtha.

Cás Úsáide Tipiciúil: Ríomhaireachtaí Cruinne

Is é cruinneas ríomhaireachta an príomhbhuntáiste a bhaineann le feidhmiú cóid le haschurtha struchtúrtha. Déanann LLManna botúin uimhríochta go minic. Trí chód a fheidhmiú, bíonn na torthaí beacht go matamaiticiúil.

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

client = Client()  # léitear an eochair ó 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("""Seo díolacháin na ráithe:
- Táirge A: 150 aonad ag €45, costas in aghaidh an aonaid €28
- Táirge B: 320 aonad ag €22, costas in aghaidh an aonaid €15
- Táirge C: 85 aonad ag €120, costas in aghaidh an aonaid €78

Ríomh an anailís airgeadais iomlán."""))

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}")

Scríobhfaidh an múnla script Python chun na ríomhaireachtaí a dhéanamh, feidhmeoidh sé í, agus ansin cuirfidh sé na torthaí i bhformáid scéime FinancialAnalysis.

Sampla: Anailís Staitistiúil

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("""Ríomh na staitisticí cur síoseacha don sonraí seo:
[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}")

Cuardach Gréasáin agus Feidhmiú Cóid a Chomhcheangal

Is féidir leat an dá uirlis a chumasú ag an am céanna:

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("Déan anailís ar stoc Apple thar na 30 lá seo caite"))

response, parsed = chat.parse(MarketAnalysis)

Faighidh an múnla sonraí le déanaí ón ngréasán, agus ansin úsáidfidh sé feidhmiú cóid chun athruithe agus meáin a ríomh.

Teorainneacha Feidhmithe Cóid

  • Tá an timpeallacht feidhmithe leithlisithe agus sealadach
  • Tá pacáistí coitianta Python suiteáilte cheana féin (NumPy, Pandas, Matplotlib, SciPy)
  • Tá an t-am feidhmithe agus an chuimhne teoranta
  • Níl rochtain líonra ag an gcód a fheidhmítear
  • Ní mhaireann comhaid a chruthaítear idir glaonna

Príomhphointí

  • Éilíonn feidhmiú cóid móide aschurtha struchtúrtha Grok 4 ar a laghad—tá an líne táirgeachta reatha ar fad comhoiriúnach
  • Scríobhann agus feidhmíonn an múnla cód chun ríomhaireachtaí cruinne a dhéanamh
  • Cumasaigh an uirlis le code_execution() san xAI SDK, nó {"type": "code_interpreter"} san API Freagraí, ansin faigh an réad típithe le chat.parse(Schema)
  • In-chomhcheangailte le web_search chun cuardach a dhéanamh agus ansin ríomh
  • Ideálach d’anailís airgeadais, staitistiúil agus mhatamaiticiúil
  • Tá torthaí ríofa beacht, seachas meastacháin LLM