Activar la ejecución de código en la API
En esta página
Ejecutar código Python mediante la API de Grok
La ejecución de código permite al modelo escribir y ejecutar código Python en tiempo real dentro de un entorno seguro y aislado (sandbox). En lugar de limitarse a generar código para que tú lo ejecutes, el modelo lo ejecuta directamente y devuelve los resultados. Es una herramienta potente para cálculos, análisis de datos y validación de código.
Identificadores de herramienta por SDK
El identificador de la herramienta varía según el SDK que utilices:
| SDK | Identificador |
|---|---|
| xAI SDK | code_execution |
| OpenAI Responses API | code_interpreter |
| Vercel AI SDK | xai.tools.codeExecution() |
Esta diferencia de nomenclatura es importante. Utiliza el identificador que corresponda a tu SDK para evitar errores.
Activación básica
cURL / JSON directo
{
"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()]
});
Cómo utiliza el modelo la ejecución de código
Cuando la ejecución de código está activada, el proceso funciona de la siguiente manera:
- El modelo analiza la solicitud y determina que es necesario realizar un cálculo o un análisis de datos.
- Escribe código Python adecuado para el problema.
- El código se ejecuta en el sandbox de Python de xAI.
- El modelo recibe los resultados de la ejecución (salida estándar, posibles errores).
- Formula su respuesta incorporando dichos resultados.
Si el código genera un error, el modelo puede corregirlo automáticamente y volver a ejecutarlo, lo que puede dar lugar a múltiples invocaciones para una única solicitud.
Recomendación de temperatura
Para cálculos matemáticos y análisis de datos, xAI recomienda utilizar valores de temperatura bajos (de 0,0 a 0,3). Una temperatura baja reduce la variabilidad en la generación de código y produce resultados más reproducibles.
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
)
Puntos clave
- La ejecución de código permite la ejecución de Python en tiempo real en un sandbox seguro.
- El identificador varía según el SDK:
code_execution(xAI),code_interpreter(OpenAI). - El modelo escribe, ejecuta e interpreta el código automáticamente.
- Utiliza
grok-4.20-0309-reasoningy una temperatura baja para cálculos. - El coste es de 0,005 $ por ejecución, con la posibilidad de múltiples invocaciones.