Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Abilitare l'esecuzione del codice nell'API

Lezione 12 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Esegui codice Python tramite l’API Grok
  2. Identificatori degli strumenti per SDK
  3. Attivazione di base
  4. Come il modello utilizza l’esecuzione del codice
  5. Raccomandazione sulla temperatura
  6. Punti chiave

Esegui codice Python tramite l’API Grok

L’esecuzione del codice permette al modello di scrivere ed eseguire codice Python in tempo reale all’interno di un ambiente sicuro e isolato (sandbox). Invece di generare semplicemente codice che devi eseguire tu, il modello lo esegue direttamente e restituisce i risultati. È uno strumento potente per calcoli, analisi dati e validazione del codice.

🐍
Python in Sandbox
NumPy
Pandas, SciPy...
🔒
Isolato e sicuro
$5
/ 1.000 chiamate

Identificatori degli strumenti per SDK

L’identificatore dello strumento varia a seconda dell’SDK che utilizzi:

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

Questa differenza di denominazione è importante. Usa l’identificatore corrispondente al tuo SDK per evitare errori.

Attivazione di base

cURL / JSON diretto

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

Come il modello utilizza l’esecuzione del codice

Quando l’esecuzione del codice è abilitata, il processo funziona come segue:

  1. Il modello analizza la richiesta e determina se è necessario un calcolo o un’analisi dati
  2. Scrive il codice Python adatto al problema
  3. Il codice viene eseguito nella sandbox Python di xAI
  4. Il modello riceve i risultati dell’esecuzione (output standard, eventuali errori)
  5. Formula la sua risposta incorporando i risultati

Se il codice genera un errore, il modello può correggerlo automaticamente ed eseguirlo di nuovo, il che può generare più invocazioni per una singola richiesta.

Raccomandazione sulla temperatura

Per i calcoli matematici e l’analisi dati, xAI consiglia di utilizzare valori di temperatura bassi (da 0,0 a 0,3). Una temperatura bassa riduce la variabilità nella generazione del codice e produce risultati più riproducibili.

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
)

Punti chiave

  • L’esecuzione del codice abilita l’esecuzione Python in tempo reale in una sandbox sicura
  • L’identificatore varia in base all’SDK: code_execution (xAI), code_interpreter (OpenAI)
  • Il modello scrive, esegue e interpreta il codice automaticamente
  • Usa grok-4.20-0309-reasoning e una bassa temperatura per i calcoli
  • Il costo è di $0,005 per esecuzione, con la possibilità di multiple invocazioni