Povolenie vykonávania kódu v API
Na tejto strane
Spúšťanie kódu Python cez Grok API
Funkcia Code Execution umožňuje modelu písať a spúšťať kód Python v reálnom čase v bezpečnom izolovanom prostredí (sandbox). Namiesto toho, aby model len generoval kód, ktorý si musíš spustiť sám, vykoná ho priamo a vráti výsledky. Je to výkonný nástroj na výpočty, analýzu dát a validáciu kódu.
Identifikátory nástrojov podľa SDK
Identifikátor nástroja sa líši v závislosti od použitého SDK:
| SDK | Identifikátor |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
Tento rozdiel v názvosloví je dôležitý. Použi identifikátor, ktorý zodpovedá tvojmu SDK, aby si sa vyhol chybám.
Základná aktivácia
cURL / Priamy 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()]
});
Ako model využíva Code Execution
Keď je povolené Code Execution, proces prebieha nasledovne:
- Model analyzuje požiadavku a zistí, že je potrebný výpočet alebo analýza dát.
- Napíše kód Python prispôsobený danému problému.
- Kód sa spustí v Pythone sandboxe xAI.
- Model dostane výsledky vykonania (štandardný výstup, prípadné chyby).
- Sformuluje odpoveď so zahrnutím týchto výsledkov.
Ak kód vyprodukuje chybu, model ho môže automaticky opraviť a znovu spustiť – čo môže pri jednej požiadavke viesť k viacerým volaniam.
Odporúčanie pre teplotu (Temperature)
Pre matematické výpočty a analýzu dát odporúča xAI používať nízke hodnoty teploty (0,0 až 0,3). Nízka teplota znižuje variabilitu pri generovaní kódu a prináša reprodukovateľnejšie výsledky.
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
)
Kľúčové poznatky
- Code Execution umožňuje vykonávanie kódu Python v reálnom čase v bezpečnom sandboxe.
- Identifikátor sa líši podľa SDK:
code_execution(xAI),code_interpreter(OpenAI). - Model automaticky napíše, vykoná a interpretuje kód.
- Na výpočty používaj model
grok-4.20-0309-reasoninga nízku teplotu. - Cena je 0,005 $ za vykonanie, pričom je možné viacnásobné volanie.