Omogoči izvajanje kode v API-ju
Na tej strani
Izvajanje kode Python prek API-ja Grok
Funkcija Code Execution modelu omogoča pisanje in izvajanje kode Python v realnem času znotraj varnega izoliranega okolja (sandbox). Namesto da bi model zgolj ustvaril kodo, ki jo moraš zagnati sam, jo izvrši neposredno in vrne rezultate. To je zmogljivo orodje za izračune, analizo podatkov in validacijo kode.
Identifikatorji orodij po SDK-jih
Identifikator orodja se razlikuje glede na SDK, ki ga uporabljaš:
| SDK | Identifikator |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
Ta razlika v poimenovanju je pomembna. Uporabi identifikator, ki ustreza tvojemu SDK-ju, da se izogneš napakam.
Osnovna aktivacija
cURL / Neposredni 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()]
});
Kako model uporablja Code Execution
Ko je funkcija Code Execution omogočena, postopek poteka takole:
- Model analizira zahtevo in ugotovi, da je potreben izračun ali analiza podatkov.
- Napiše kodo Python, prilagojeno problemu.
- Koda se zažene v Python peskovniku (sandbox) xAI.
- Model prejme rezultate izvajanja (standardni izhod, morebitne napake).
- Oblikuje svoj odgovor z vključitvijo rezultatov.
Če koda povzroči napako, jo model lahko samodejno popravi in ponovno izvrši – kar lahko za eno samo zahtevo sproži več zaporednih klicev.
Priporočilo za temperaturo
Za matematične izračune in analizo podatkov xAI priporoča uporabo nizkih vrednosti temperature (od 0,0 do 0,3). Nizka temperatura zmanjša variabilnost pri generiranju kode in zagotovi bolj ponovljive rezultate.
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
)
Ključne ugotovitve
- Code Execution omogoča izvajanje kode Python v realnem času v varnem izoliranem okolju.
- Identifikator se razlikuje glede na SDK:
code_execution(xAI),code_interpreter(OpenAI). - Model samodejno napiše, izvrši in interpretira kodo.
- Za izračune uporabi model
grok-4.20-0309-reasoningin nizko temperaturo. - Strošek znaša 0,005 $ na izvajanje, pri čemer je možnih več zaporednih klicev.