Įgalinti kodo vykdymą API
Šiame puslapyje
Python kodo vykdymas per Grok API
Kodo vykdymo funkcija leidžia modeliui rašyti ir vykdyti Python kodą realiuoju laiku saugioje izoliuotoje aplinkoje. Užuot tiesiog sugeneravusi kodą, kurį turėtumėte paleisti patys, modelis jį vykdo tiesiogiai ir grąžina rezultatus. Tai galingas įrankis skaičiavimams, duomenų analizei ir kodo validavimui.
Įrankių identifikatoriai pagal SDK
Įrankio identifikatorius skiriasi priklausomai nuo naudojamo SDK:
| SDK | Identifikatorius |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
Šis pavadinimų skirtumas yra svarbus. Naudokite identifikatorių, atitinkantį jūsų SDK, kad išvengtumėte klaidų.
Pagrindinis aktyvavimas
cURL / Tiesioginis 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()]
});
Kaip modelis naudoja kodo vykdymą
Įgalinus kodo vykdymą, procesas vyksta taip:
- Modelis analizuoja užklausą ir nustato, kad reikia atlikti skaičiavimą arba duomenų analizę.
- Jis parašo problemai tinkamą Python kodą.
- Kodas paleidžiamas xAI Python smėlio dėžėje.
- Modelis gauna vykdymo rezultatus (standartinę išvestį, visas klaidas).
- Jis suformuluoja atsakymą, įtraukdamas gautus rezultatus.
Jei kode atsiranda klaida, modelis gali ją automatiškai ištaisyti ir vykdyti kodą iš naujo – dėl to vienam užklausimui gali tekti keli vykdymo ciklai.
Temperatūros rekomendacija
Matematiniams skaičiavimams ir duomenų analizei xAI rekomenduoja naudoti mažas temperatūros reikšmes (nuo 0,0 iki 0,3). Maža temperatūra sumažina kodo generavimo variaciją ir užtikrina atkartojamus rezultatus.
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
)
Svarbiausi punktai
- Kodo vykdymas leidžia vykdyti Python kodą realiuoju laiku saugioje smėlio dėžėje.
- Identifikatorius priklauso nuo SDK:
code_execution(xAI),code_interpreter(OpenAI). - Modelis automatiškai rašo, vykdo ir interpretuoja kodą.
- Skaičiavimams naudokite
grok-4.20-0309-reasoningir mažą temperatūrą. - Kaina – 0,005 $ už vykdymą; vienam užklausimui gali tekti keli kvietimai.