Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Povolení spouštění kódu v API

Lekce 12 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Spouštění kódu Pythonu přes Grok API
  2. Identifikátory nástrojů podle SDK
  3. Základní aktivace
  4. Jak model využívá Code Execution
  5. Doporučení pro teplotu (Temperature)
  6. Klíčové poznatky

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.

🐍
Sandboxed Python
NumPy
Pandas, SciPy...
🔒
Isolated and secure
$5
/ 1,000 calls

Identifikátory nástrojů podle SDK

Identifikátor nástroje se liší v závislosti na použitém SDK:

SDKIdentifikátor
xAI SDKcode_execution
OpenAI Responses APIcode_interpreter
Vercel AI SDKxai.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ě:

  1. Model analyzuje požadavek a určí, že je potřeba provést výpočet nebo analýzu dat.
  2. Napíše kód Pythonu přizpůsobený danému problému.
  3. Kód se spustí v Python sandboxu xAI.
  4. Model obdrží výsledky spuštění (standardní výstup, případné chyby).
  5. 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-reasoning a nízkou teplotu.
  • Cena činí 0,005 $ za spuštění, přičemž je možných více volání.