Kódfuttatás engedélyezése az API-ban
Ezen az oldalon
Python kód futtatása a Grok API-n keresztül
A Kódfuttatás (Code Execution) lehetővé teszi, hogy a modell valós időben írjon és futtasson Python kódot egy biztonságos, homokozó (sandbox) környezetben. Ahelyett, hogy csupán generálna neked egy kódot, amit saját magadnak kellene lefuttatnod, a modell közvetlenül végrehajtja azt, és visszaadja az eredményeket. Ez egy hatalmas eszköz számításokhoz, adatelemzéshez és kódvalidáláshoz.
Eszközazonosítók SDK-nként
Az eszközazonosító az általad használt SDK-tól függően változik:
| SDK | Azonosító |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
Ez a névbeli különbség számít. A hibák elkerülése érdekében mindig azt az azonosítót használd, amelyik az adott SDK-dhoz illik.
Alapvető aktiválás
cURL / Közvetlen 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()]
});
Hogyan használja a modell a Kódfuttatást
Ha a Kódfuttatás engedélyezve van, a folyamat a következőképpen zajlik:
- A modell elemzi a kérést, és megállapítja, hogy számításra vagy adatelemzésre van szükség.
- Megírja a problémához illő Python kódot.
- A kód lefut az xAI Python homokozójában (sandbox).
- A modell megkapja a végrehajtás eredményeit (szabványos kimenet, esetleges hibák).
- Az eredményeket beépítve fogalmazza meg a válaszát.
Ha a kód hibát eredményez, a modell automatikusan kijavíthatja és újra lefuttathatja azt – ami egyetlen kérés esetén több hívást is generálhat.
Hőmérséklet-ajánlás
Matematikai számításokhoz és adatelemzéshez az xAI alacsony hőmérsékleti értékek (0,0–0,3) használatát javasolja. Az alacsony hőmérséklet csökkenti a kódgenerálás változékonyságát, és reprodukálhatóbb eredményeket biztosít.
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
)
Főbb megállapítások
- A Kódfuttatás lehetővé teszi a valós idejű Python-végrehajtást egy biztonságos homokozóban.
- Az azonosító SDK-nként változik:
code_execution(xAI),code_interpreter(OpenAI). - A modell automatikusan megírja, lefuttatja és értelmezi a kódot.
- Számításokhoz használd a
grok-4.20-0309-reasoningmodellt és egy alacsony hőmérsékletet. - A költség végrehajtásonként 0,005 USD, és egyetlen kérés több hívást is eredményezhet.