Aschurtha Struchtúrtha agus Feidhmiú Cóid
Ar an leathanach seo
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 ansinchat.parse(Schema)a ghlaowh, a thugann ar ais an freagra agus an réad típithe; ní raibh an sampla roimhe seo ag glaoch arclient.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 lechat.parse(Schema) - In-chomhcheangailte le
web_searchchun 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