Povolení spouštění kódu v API
Na této stránce
Spouštění kódu Pythonu přes Grok API
Funkce Code Execution umožňuje modelu psát a spouštět kód Pythonu v reálném čase v zabezpečeném izolovaném prostředí (sandbox). Místo toho, aby model pouze generoval kód, který musíš spustit sám, provede ho přímo a vrátí výsledky. Je to výkonný nástroj pro výpočty, analýzu dat a validaci kódu.
Identifikátory nástrojů podle SDK
Identifikátor nástroje se liší v závislosti na použitém SDK:
| SDK | Identifikátor |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
Tento rozdíl v pojmenování je důležitý. Použij identifikátor odpovídající tvému SDK, abys předešel chybám.
Základní aktivace
cURL / Přímý 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()]
});
Jak model využívá Code Execution
Když je povoleno Code Execution, proces probíhá následovně:
- Model analyzuje požadavek a určí, že je potřeba provést výpočet nebo analýzu dat.
- Napíše kód Pythonu přizpůsobený danému problému.
- Kód se spustí v Python sandboxu xAI.
- Model obdrží výsledky spuštění (standardní výstup, případné chyby).
- Formuluje svou odpověď s využitím těchto výsledků.
Pokud kód vygeneruje chybu, model jej může automaticky opravit a znovu spustit – což může u jediného požadavku vést k více voláním.
Doporučení pro teplotu (Temperature)
Pro matematické výpočty a analýzu dat doporučuje xAI používat nízké hodnoty teploty (0,0 až 0,3). Nízká teplota snižuje variabilitu při generování kódu a přináší reprodukovatelnější 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
)
Klíčové poznatky
- Code Execution umožňuje spouštění Pythonu v reálném čase v zabezpečeném sandboxu.
- Identifikátor se liší podle SDK:
code_execution(xAI),code_interpreter(OpenAI). - Model automaticky napíše, spustí a interpretuje kód.
- Pro výpočty použij model
grok-4.20-0309-reasoninga nízkou teplotu. - Cena činí 0,005 $ za spuštění, přičemž je možných více volání.