Przejdź do głównej treści
Polski— Wybierz język
Menu

Włącz wykonywanie kodu w API

Lekcja 12 z 16 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Uruchamianie kodu Python przez API Grok
  2. Identyfikatory narzędzi w zależności od SDK
  3. Podstawowa aktywacja
  4. Jak model korzysta z Code Execution
  5. Zalecana temperatura
  6. Kluczowe wnioski

Uruchamianie kodu Python przez API Grok

Funkcja Code Execution pozwala modelowi pisać i uruchamiać kod Python w czasie rzeczywistym w bezpiecznym, izolowanym środowisku (sandbox). Zamiast jedynie generować kod do samodzielnego uruchomienia, model wykonuje go bezpośrednio i zwraca wyniki. To potężne narzędzie do obliczeń, analizy danych i walidacji kodu.

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

Identyfikatory narzędzi w zależności od SDK

Identyfikator narzędzia różni się w zależności od używanego SDK:

SDKIdentyfikator
xAI SDKcode_execution
OpenAI Responses APIcode_interpreter
Vercel AI SDKxai.tools.codeExecution()

Ta różnica w nazewnictwie ma znaczenie. Używaj identyfikatora dopasowanego do Twojego SDK, aby uniknąć błędów.

Podstawowa aktywacja

cURL / Bezpośredni 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 korzysta z Code Execution

Gdy funkcja Code Execution jest włączona, proces przebiega następująco:

  1. Model analizuje żądanie i stwierdza, że konieczne są obliczenia lub analiza danych.
  2. Pisze kod Python dostosowany do problemu.
  3. Kod uruchamia się w piaskownicy Python firmy xAI.
  4. Model otrzymuje wyniki wykonania (standardowe wyjście, ewentualne błędy).
  5. Formułuje odpowiedź, uwzględniając полученные wyniki.

Jeśli kod zwróci błąd, model może automatycznie go poprawić i uruchomić ponownie – co może skutkować wielokrotnymi wywołaniami dla jednego żądania.

Zalecana temperatura

Do obliczeń matematycznych i analizy danych xAI zaleca stosowanie niskich wartości temperatury (od 0,0 do 0,3). Niska temperatura zmniejsza zmienność generowanego kodu i zapewnia bardziej powtarzalne wyniki.

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
)

Kluczowe wnioski

  • Code Execution umożliwia wykonywanie kodu Python w czasie rzeczywistym w bezpiecznej piaskownicy.
  • Identyfikator zależy od SDK: code_execution (xAI), code_interpreter (OpenAI).
  • Model automatycznie pisze, wykonuje i interpretuje kod.
  • Do obliczeń używaj modelu grok-4.20-0309-reasoning i niskiej temperatury.
  • Koszt wynosi 0,005 USD za wykonanie, przy czym możliwe są wielokrotne wywołania.