Włącz wykonywanie kodu w API
Na tej stronie
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.
Identyfikatory narzędzi w zależności od SDK
Identyfikator narzędzia różni się w zależności od używanego SDK:
| SDK | Identyfikator |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.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:
- Model analizuje żądanie i stwierdza, że konieczne są obliczenia lub analiza danych.
- Pisze kod Python dostosowany do problemu.
- Kod uruchamia się w piaskownicy Python firmy xAI.
- Model otrzymuje wyniki wykonania (standardowe wyjście, ewentualne błędy).
- 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-reasoningi niskiej temperatury. - Koszt wynosi 0,005 USD za wykonanie, przy czym możliwe są wielokrotne wywołania.