Skip to main content
code_execution ejecuta análisis remoto de Python en un entorno aislado mediante la API Responses de xAI (https://api.x.ai/v1/responses, el mismo endpoint que usa x_search). Está registrado por el plugin xai incluido conforme al contrato tools.
code_execution se ejecuta en los servidores de xAI. xAI cobra $5 por cada 1,000 llamadas a herramientas, además de los tokens de entrada y salida del modelo.
Úselo para cálculos, tabulación, estadísticas rápidas y análisis con gráficos, incluidos los datos devueltos por x_search o web_search. No tiene acceso a archivos locales, al shell, al repositorio ni a dispositivos vinculados, y no conserva el estado entre llamadas, por lo que cada llamada debe tratarse como un análisis efímero, no como una sesión de cuaderno. Para obtener datos recientes de X, ejecute primero x_search y canalice el resultado. Para la ejecución local, use exec en su lugar.

​
Configuración

1

Proporcionar credenciales de xAI

OAuth requiere una suscripción válida a SuperGrok o X Premium (verificación mediante código de dispositivo, por lo que funciona desde hosts remotos sin una devolución de llamada a localhost):
Durante una instalación nueva, la misma opción está disponible en la incorporación:
O bien, una clave de API:
O mediante la configuración:
Cualquiera de estas tres opciones también permite utilizar x_search y web_search de Grok.
2

Habilitar y ajustar code_execution

Si se omite enabled, code_execution solo se expone cuando el proveedor del modelo activo es xai y se pueden resolver las credenciales de xAI. Para un modelo activo con un proveedor conocido distinto de xAI, establezca plugins.entries.xai.config.codeExecution.enabled en true para habilitar el uso entre proveedores. Si falta el proveedor del modelo activo o no se puede resolver, la herramienta permanece oculta. Establezca enabled en false para deshabilitarla para todos los proveedores. Las credenciales de xAI siempre son obligatorias.Use el mismo bloque para sustituir el modelo, el límite de turnos o el tiempo de espera:
3

Reiniciar el Gateway

code_execution aparece en la lista de herramientas del agente una vez que el plugin de xAI vuelve a registrarse y se superan las comprobaciones anteriores del proveedor, la habilitación y la autenticación.

​
Cómo usarla

Indique explícitamente la intención del análisis; la herramienta acepta un único parámetro task, por lo que debe enviar la solicitud completa y todos los datos insertados en una sola instrucción:

​
Errores

Sin autenticación, la herramienta devuelve un error JSON estructurado (no una excepción generada), lo que permite al agente autocorregirse:

​
Temas relacionados

Herramienta Exec

Ejecución local del shell en su máquina o Node vinculado.

Aprobaciones de Exec

Política de autorización o denegación para la ejecución del shell.

Herramientas web

web_search, x_search y web_fetch.

Proveedor xAI

Modelos Grok, búsqueda web/X y configuración de ejecución de código.