Salt la conținutul principal
Română— Alege o limbă
Meniu

Activarea executării codului în API

Lecția 12 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Rularea codului Python prin API-ul Grok
  2. Identificatorii de instrumente pe SDK
  3. Activarea de bază
  4. Cum utilizează modelul executarea codului
  5. Recomandare privind temperatura
  6. Puncte cheie

Rularea codului Python prin API-ul Grok

Executarea codului permite modelului să scrie și să ruleze cod Python în timp real, într-un mediu securizat și izolat (sandbox). În loc să genereze simplu cod pe care dumneavoastră să îl executați, modelul rulează codul direct și returnează rezultatele. Este un instrument puternic pentru calcule, analiza datelor și validarea codului.

🐍
Python în sandbox
NumPy
Pandas, SciPy...
🔒
Izolat și securizat
$5
/ 1.000 de apeluri

Identificatorii de instrumente pe SDK

Identificatorul instrumentului variază în funcție de SDK-ul pe care îl utilizați:

SDKIdentificator
xAI SDKcode_execution
OpenAI Responses APIcode_interpreter
Vercel AI SDKxai.tools.codeExecution()

Această diferență de denumire este importantă. Utilizați identificatorul care corespunde SDK-ului dumneavoastră pentru a evita erorile.

Activarea de bază

cURL / JSON direct

{
  "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()]
});

Cum utilizează modelul executarea codului

Când executarea codului este activată, procesul funcționează astfel:

  1. Modelul analizează cererea și stabilește dacă este necesar un calcul sau o analiză a datelor
  2. Scrie cod Python adaptat problemei
  3. Codul rulează în sandbox-ul Python al xAI
  4. Modelul primește rezultatele execuției (ieșirea standard, eventualele erori)
  5. Formulează răspunsul integrând rezultatele obținute

Dacă codul produce o eroare, modelul poate corecta automat și reexecuta codul, ceea ce poate genera mai multe invocări pentru o singură cerere.

Recomandare privind temperatura

Pentru calcule matematice și analiza datelor, xAI recomandă utilizarea unor valori scăzute ale temperaturii (0,0 până la 0,3). O temperatură scăzută reduce variabilitatea generării codului și produce rezultate mai reproductibile.

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
)

Puncte cheie

  • Executarea codului permite rularea Python în timp real într-un sandbox securizat
  • Identificatorul variază în funcție de SDK: code_execution (xAI), code_interpreter (OpenAI)
  • Modelul scrie, execută și interpretează codul automat
  • Utilizați grok-4.20-0309-reasoning și o temperatură scăzută pentru calcule
  • Costul este de 0,005 $ per execuție, fiind posibile mai multe invocări