Hosted Shell OpenAI API: ejecuta comandos con GPT
Hosted Shell OpenAI API permite que modelos compatibles de OpenAI ejecuten comandos de shell dentro de un entorno administrado. Mediante Responses API, el modelo puede utilizar Hosted Shell para inspeccionar archivos, ejecutar comandos, automatizar tareas de desarrollo y trabajar con herramientas de línea de comandos dentro de workflows agentic.
¿Qué es Hosted Shell OpenAI API?
Hosted Shell OpenAI API es una herramienta
de Responses API que permite a determinados modelos
ejecutar uno o varios comandos de shell
en un entorno administrado.
El modelo puede utilizar la terminal para inspeccionar
archivos, ejecutar utilidades, automatizar tareas
y obtener resultados mediante stdout
y stderr.
Qué permite hacer Hosted Shell OpenAI API
Hosted Shell añade una interfaz de línea de comandos a los workflows de Responses API.
Ejecutar comandos
Permite al modelo utilizar comandos de shell dentro del entorno disponible.
Trabajar con archivos
Puede inspeccionar, organizar y procesar archivos accesibles desde el entorno.
Automatizar desarrollo
Ejecutar herramientas, scripts y comandos relacionados con workflows técnicos.
Consultar salida
La herramienta puede devolver salida estándar y errores de comandos.
Encadenar tareas
Varias operaciones pueden formar parte de un workflow de múltiples pasos.
Agentes de desarrollo
Resulta especialmente útil para agentes capaces de trabajar sobre código y archivos.
Cómo funciona Hosted Shell en OpenAI API
El modelo decide qué comandos necesita, los ejecuta mediante la herramienta shell y analiza el resultado.
El modelo planifica
Determina qué comando necesita ejecutar para avanzar.
Se ejecuta el comando
Hosted Shell ejecuta la acción dentro del entorno.
El modelo analiza
Utiliza stdout, stderr y el estado para decidir el siguiente paso.
Hosted Shell OpenAI API dentro de Responses API
La herramienta shell puede declararse dentro de las herramientas disponibles para modelos compatibles.
Ejecutar comandos desde el workflow
La referencia de Responses API describe la herramienta shell como una capacidad que permite al modelo ejecutar comandos mediante un entorno controlado.
Cuando Hosted Shell está disponible, el modelo puede ejecutar comandos reales dentro del entorno proporcionado.
Ver Responses API →Cómo habilitar Hosted Shell OpenAI API
La herramienta puede incluirse dentro del array de tools de Responses API.
Permitir comandos de shell
{
"model": "gpt-5.6-sol",
"tools": [
{
"type": "shell"
}
],
"input": "Revisa los archivos del proyecto y dime qué pruebas fallan."
}La herramienta shell puede trabajar con configuraciones de entorno distintas. Revisa siempre la referencia vigente para los campos exactos disponibles.
El entorno de Hosted Shell
La herramienta shell ejecuta comandos dentro de un entorno asociado al workflow.
Shell dentro de un espacio controlado
La API diferencia entre ejecución en entornos administrados y otras configuraciones de shell disponibles en determinados workflows.
El entorno, sus archivos, red y capacidades dependen de la configuración disponible para esa ejecución.
Qué es una shell tool call
Cuando el modelo decide utilizar Hosted Shell, Responses API puede devolver una llamada de herramienta específica.
Comandos ejecutados por el modelo
La referencia describe estas llamadas como ejecuciones de uno o más comandos de shell dentro de un entorno administrado.
stdout y stderr en Hosted Shell
La salida de una ejecución puede incluir información estándar y mensajes de error.
| Campo | Función |
|---|---|
stdout |
Salida estándar producida por el comando |
stderr |
Salida de error producida durante la ejecución |
outcome |
Información sobre el resultado de esa parte de la ejecución |
Ejemplo conceptual de salida de shell
El modelo puede analizar el resultado antes de decidir su siguiente acción.
Salida capturada
{
"stdout": "12 tests passed\n2 tests failed",
"stderr": "",
"outcome": {
"type": "exit"
}
}La estructura exacta del objeto de resultado debe comprobarse con la versión actual de la API.
Ejecutar más de un comando
La referencia actual describe la shell tool call como una llamada capaz de ejecutar uno o más comandos.
Inspeccionar los archivos disponibles.
Ejecutar una herramienta o script.
Analizar su salida.
Ejecutar un segundo comando cuando sea necesario.
Utilizar el resultado para continuar el workflow.
Eventos de Hosted Shell
Responses API dispone de eventos específicos para comandos y sus outputs.
| Evento | Función general |
|---|---|
| Command added | Se añadió un comando a la tool call |
| Command delta | Actualización parcial del comando |
| Command done | El comando quedó completo |
| Output content delta | Se recibe parte de la salida |
| Output content done | La salida terminó de generarse |
Forzar el uso de Hosted Shell
Responses API
dispone de un tipo
de tool_choice
específico para shell.
Shell como herramienta requerida
{
"tool_choice": {
"type": "shell"
}
}Cuando utilizas selección automática, el modelo puede decidir si necesita ejecutar comandos o si puede responder directamente.
Casos de uso de Hosted Shell OpenAI API
Hosted Shell resulta especialmente útil para tareas relacionadas con desarrollo, archivos y automatización.
Testing: ejecutar pruebas de un proyecto.
Build: ejecutar herramientas de compilación o procesos similares.
Archivos: localizar, inspeccionar y organizar contenido.
Diagnóstico: revisar logs y errores.
Automatización: encadenar comandos dentro de un workflow.
Agentes de código: combinar shell, Apply Patch y otras herramientas.
Hosted Shell vs Code Interpreter
Ambas herramientas ejecutan código, pero están orientadas a tipos de tareas diferentes.
| Aspecto | Hosted Shell | Code Interpreter |
|---|---|---|
| Interfaz | Comandos de shell | Entorno de código |
| Uso principal | Desarrollo y sistema | Análisis y procesamiento |
| Salida | stdout / stderr | Outputs de ejecución |
| Archivos | Manipulación mediante comandos | Procesamiento programático |
| Ejemplo | Ejecutar tests | Analizar un CSV |
Un workflow técnico puede utilizar diferentes herramientas según la etapa de la tarea.
Ver Code Interpreter →Hosted Shell vs Function Calling
Function Calling resulta más adecuado cuando necesitas operaciones predefinidas y controladas.
| Aspecto | Hosted Shell | Function Calling |
|---|---|---|
| Entrada | Comandos | Argumentos estructurados |
| Flexibilidad | Alta | Controlada por la función |
| Backend propio | No necesariamente | Sí |
| Uso típico | Herramientas de desarrollo | Acciones de negocio |
Si una tarea puede resolverse mediante una función bien definida, suele ser preferible a conceder acceso a un shell general.
Ver Function Calling →Hosted Shell y Apply Patch
OpenAI ofrece ambas herramientas en modelos compatibles, y pueden cubrir etapas diferentes de un workflow de código.
Inspeccionar y comprobar
Ejecutar comandos, tests y herramientas del proyecto.
Modificar archivos
Aplicar cambios estructurados al código o documentos.
Revisar → modificar → ejecutar pruebas → volver a corregir.
Modelos OpenAI compatibles con Hosted Shell
La compatibilidad con Hosted Shell depende del modelo.
| Modelo | Hosted Shell | Orientación |
|---|---|---|
| GPT-6 Astra | Compatible | Workflows end-to-end complejos |
| GPT-5.6 Sol | Compatible | Programación y trabajo profesional complejo |
| GPT-5.5 | Compatible | Workflows generales avanzados |
| GPT-5.5 Pro | Compatible | Razonamiento de alta capacidad |
| Chat Latest | No compatible | Chat general |
Hosted Shell no está disponible en todos los modelos, incluso si ese modelo soporta otras herramientas de Responses API.
Comparar modelos →Buenas prácticas con Hosted Shell OpenAI API
Un shell es una herramienta muy flexible, por lo que requiere controles estrictos.
Utiliza entornos aislados.
Limita archivos y recursos disponibles.
No expongas secretos innecesarios.
Controla acceso a red cuando corresponda.
Registra los comandos ejecutados.
Requiere aprobación para acciones especialmente sensibles.
No expongas credenciales al shell sin necesidad
Tokens, API keys y credenciales deben manejarse con especial cuidado.
Entrega únicamente lo necesario
Si un comando no necesita acceder a un servicio externo, no hay razón para poner esas credenciales dentro del entorno.
Control de red en entornos de ejecución
La referencia actual incluye configuraciones de política de red para determinados containers y entornos.
Restringir dominios accesibles
Cuando una configuración lo permite, una allowlist puede limitar los dominios con los que el entorno puede comunicarse.
Evitar acceso de red innecesario reduce el número de recursos externos disponibles para una ejecución.
No conviertas contenido externo en comandos confiables
Un agente puede leer archivos, documentación o contenido externo antes de utilizar shell.
Separa datos de instrucciones
Texto encontrado en un archivo o fuente externa no debería convertirse automáticamente en un comando con privilegios.
Cuándo conviene utilizar Hosted Shell
Hosted Shell es apropiado cuando la tarea se expresa naturalmente mediante comandos de terminal.
Ejecutar tests de un proyecto.
Revisar estructura de directorios.
Ejecutar herramientas de desarrollo.
Diagnosticar errores utilizando logs.
Automatizar secuencias de comandos.
Cuándo no necesitas Hosted Shell
Utilizar un shell general puede ser innecesario para tareas muy estructuradas.
Operaciones de negocio
Cuando necesitas una función bien definida con argumentos claros.
Análisis de datos
Cuando el objetivo principal es procesamiento, estadísticas o cálculo.
Modificar archivos
Cuando necesitas aplicar cambios estructurados al código.
Costos de Hosted Shell OpenAI API
El costo total de un workflow depende del modelo y de las herramientas utilizadas.
Revisa el pricing actual antes de producción
OpenAI puede cobrar por tokens y por determinadas herramientas o recursos utilizados durante una ejecución.
Un agente puede ejecutar varios comandos y varias llamadas al modelo antes de finalizar.
Ver precios OpenAI API →Hosted Shell y los límites de OpenAI API
Los workflows que utilizan shell continúan sujetos a los límites del modelo y del proyecto.
Controla concurrencia y duración
Un agente que ejecuta muchos comandos puede aumentar latencia, consumo y complejidad operacional.
Ver límites OpenAI API →Documentación oficial de Hosted Shell OpenAI API
Hosted Shell continúa evolucionando, por lo que conviene revisar siempre la referencia oficial antes de desarrollar una integración.
Shell tool en Responses API
Consulta tipos de herramientas, llamadas de shell, outputs y eventos disponibles.
Consultar documentación oficial →Guías relacionadas con Hosted Shell OpenAI API
Continúa explorando herramientas para programación, agentes y Responses API.
FAQ sobre Hosted Shell OpenAI API
Respuestas sobre shell commands, modelos, seguridad y Responses API.
Hosted Shell OpenAI API permite a modelos compatibles ejecutar comandos de shell dentro de un entorno administrado.
Sí. Hosted Shell aparece entre las herramientas compatibles de determinados modelos mediante Responses API.
La salida puede incluir stdout, stderr y datos relacionados con el resultado de la ejecución.
Sí. La referencia describe una shell tool call capaz de ejecutar uno o más comandos dentro de un entorno administrado.
Sí. OpenAI publica Hosted Shell entre las herramientas compatibles con GPT-5.6 Sol.
Sí. Hosted Shell figura actualmente entre las herramientas compatibles de GPT-6 Astra.
No. Hosted Shell está orientado a comandos de terminal, mientras Code Interpreter está especialmente orientado a ejecución de código, cálculos y análisis dentro de containers.
Debe utilizarse con aislamiento, permisos mínimos, protección de secretos y controles sobre archivos, red y comandos.
Responses API dispone de un tipo de tool choice específico para shell.
Sí. Puede utilizarse para ejecutar tests, inspeccionar archivos y usar herramientas de línea de comandos dentro de workflows de programación.
Continúa con Apply Patch en OpenAI API
Ya sabes cómo utilizar Hosted Shell para ejecutar comandos. El siguiente paso es aprender cómo GPT puede crear, modificar y eliminar archivos mediante patches estructurados.
Ver Apply Patch →