Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Ota koodin suoritus käyttöön rajapinnassa

Oppitunti 12 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Suorita Python-koodia Grok-rajapinnan kautta
  2. Työkalutunnisteet SDK:n mukaan
  3. Peruskäyttöönotto
  4. Miten malli käyttää koodin suoritusta
  5. Lämpötilasuositus
  6. Keskeiset asiat

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.

🐍
Hiekkalaatikko-Python
NumPy
Pandas, SciPy...
🔒
Eristetty ja turvallinen
$5
/ 1 000 kutsua

Työkalutunnisteet SDK:n mukaan

Työkalun tunniste vaihtelee käyttämäsi SDK:n mukaan:

SDKTunniste
xAI SDKcode_execution
OpenAI Responses APIcode_interpreter
Vercel AI SDKxai.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:

  1. Malli analysoi pyynnön ja toteaa, että laskutoimitus tai data-analyysi on tarpeen.
  2. Se kirjoittaa ongelmaan sopivan Python-koodin.
  3. Koodi suoritetaan xAI:n Python-hiekkalaatikossa.
  4. Malli vastaanottaa suorituksen tulokset (standarditulostus, mahdolliset virheet).
  5. 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-reasoning ja matalaa lämpötilaa laskutoimituksissa.
  • Hinta on 0,005 $ suoritukselta, ja useita kutsuja voi tapahtua yhden pyynnön aikana.