Luba koodi käivitamine API-s
Sellel lehel
Käivita Pythoni kood Grok API kaudu
Koodi käivitamise funktsioon võimaldab mudelil kirjutada ja käivitada Pythoni koodi reaalajas turvalises liivakastis. Selle asemel, et mudel genereeriks koodi, mille sa ise käivitad, viib ta koodi ise täide ja tagastab tulemused. See on võimas tööriist arvutuste, andmeanalüüsi ja koodi valideerimise jaoks.
Tööriista identifikaatorid SDK-de lõikes
Tööriista identifikaator sõltub kasutatavast SDK-st:
| SDK | Identifikaator |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
See nimede erinevus on oluline. Vigade vältimiseks kasuta oma SDK-le vastavat identifikaatorit.
Põhiline aktiveerimine
cURL / Otsene JSON
{
"model": "grok-4.20-0309-reasoning",
"input": "Calculate the sum of the first 1,000 prime numbers",
"tools": [
{"type": "code_interpreter"}
]
}
xAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Calculate the sum of the first 1,000 prime numbers",
tools=[client.tools.code_execution()]
)
print(response.output_text)
OpenAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Calculate the sum of the first 1,000 prime numbers",
tools=[{"type": "code_interpreter"}]
)
Vercel AI SDK (JavaScript)
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "Calculate the sum of the first 1,000 prime numbers",
tools: [xai.tools.codeExecution()]
});
Kuidas mudel koodi käivitamist kasutab
Kui koodi käivitamine on lubatud, toimub protsess järgmiselt:
- Mudel analüüsib päringut ja teeb kindlaks, et vaja on arvutust või andmeanalüüsi.
- Ta kirjutab ülesande jaoks sobiva Pythoni koodi.
- Kood käivitatakse xAI Pythoni liivakastis.
- Mudel saab käivitamise tulemused (standardväljund, võimalikud vead).
- Ta formuleerib vastuse, lisades sellele saadud tulemused.
Kui kood tekitab vea, suudab mudel selle automaatselt parandada ja uuesti käivitada – see võib ühe päringu jaoks tekitada mitu väljakutset.
Temperatuuri soovitus
Matemaatiliste arvutuste ja andmeanalüüsi jaoks soovitab xAI kasutada madalaid temperatuuriväärtusi (0,0 kuni 0,3). Madal temperatuur vähendab koodi genereerimise varieeruvust ja annab reprodutseeritavamaid tulemusi.
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Calculate the Sharpe ratio for this portfolio...",
tools=[client.tools.code_execution()],
temperature=0.1
)
Peamised punktid
- Koodi käivitamine võimaldab Pythoni koodi reaalajas täitmist turvalises liivakastis.
- Identifikaator sõltub SDK-st:
code_execution(xAI),code_interpreter(OpenAI). - Mudel kirjutab, käivitab ja tõlgendab koodi automaatselt.
- Arvutuste jaoks kasuta mudelit
grok-4.20-0309-reasoningja madalat temperatuuri. - Maksumus on 0,005 $ käivituse kohta, kusjuures võimalikud on korduvad väljakutsed.