Activarea executării codului în API
Pe această pagină
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.
Identificatorii de instrumente pe SDK
Identificatorul instrumentului variază în funcție de SDK-ul pe care îl utilizați:
| SDK | Identificator |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.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:
- Modelul analizează cererea și stabilește dacă este necesar un calcul sau o analiză a datelor
- Scrie cod Python adaptat problemei
- Codul rulează în sandbox-ul Python al xAI
- Modelul primește rezultatele execuției (ieșirea standard, eventualele erori)
- 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