Ota koodin suoritus käyttöön rajapinnassa
Tällä sivulla
Suorita Python-koodia Grok-rajapinnan kautta
Koodin suoritus mahdollistaa sen, että malli kirjoittaa ja ajaa Python-koodia reaaliajassa turvatussa hiekkalaatikko-ympäristössä. Sen sijaan, että malli tuottaisi vain koodia sinun suoritettavaksi, se ajaa koodin suoraan ja palauttaa tulokset. Tämä on tehokas työkalu laskutoimituksiin, data-analyysiin ja koodin validointiin.
Työkalutunnisteet SDK:n mukaan
Työkalun tunniste vaihtelee käyttämäsi SDK:n mukaan:
| SDK | Tunniste |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
Tällä nimierolla on väliä. Käytä SDK:tasi vastaavaa tunnistetta virheiden välttämiseksi.
Peruskäyttöönotto
cURL / Suora 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()]
});
Miten malli käyttää koodin suoritusta
Kun koodin suoritus on käytössä, prosessi etenee seuraavasti:
- Malli analysoi pyynnön ja toteaa, että laskutoimitus tai data-analyysi on tarpeen.
- Se kirjoittaa ongelmaan sopivan Python-koodin.
- Koodi suoritetaan xAI:n Python-hiekkalaatikossa.
- Malli vastaanottaa suorituksen tulokset (standarditulostus, mahdolliset virheet).
- Se muotoilee vastauksensa sisällyttäen siihen saadut tulokset.
Jos koodi tuottaa virheen, malli voi automaattisesti korjata sen ja suorittaa uudelleen – mikä voi johtaa useampaan kutsuun yhden pyynnön aikana.
Lämpötilasuositus
Matemaattisiin laskutoimituksiin ja data-analyysiin xAI suosittelee käyttämään matalia lämpötila-arvoja (0,0–0,3). Matala lämpötila vähentää koodin generoinnin vaihtelua ja tuottaa toistettavampia tuloksia.
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
)
Keskeiset asiat
- Koodin suoritus mahdollistaa reaaliaikaisen Python-suorituksen turvatussa hiekkalaatikossa.
- Tunniste vaihtelee SDK:n mukaan:
code_execution(xAI),code_interpreter(OpenAI). - Malli kirjoittaa, suorittaa ja tulkitsee koodin automaattisesti.
- Käytä mallia
grok-4.20-0309-reasoningja matalaa lämpötilaa laskutoimituksissa. - Hinta on 0,005 $ suoritukselta, ja useita kutsuja voi tapahtua yhden pyynnön aikana.