OpenShell explicado: límites de actuación de un agente
OpenShell explicado: límites de actuación de un agente
Identifica sandbox, supervisor fiable y gateway antes de evaluar las afirmaciones de seguridad.
Qué aprenderás
- Distinguir los límites
- Separar política y credenciales
- Delimitar las afirmaciones
Antes de empezar
- Una carga desechable y un runtime soportado
- Permiso para revisar política y proveedores
Convierte los controles descritos en un informe acotado que otro operador pueda revisar.
Conclusiones clave
- El supervisor decide fuera de la carga de trabajo.
- Las credenciales reales permanecen fuera del proceso del agente.
- Las garantías de seguridad exigen pruebas en el entorno propio.
Distinguir los límites
OpenShell ejecuta al agente autónomo dentro de un sandbox y sitúa un supervisor de confianza fuera de esa carga. El gateway administra su ciclo de vida y acceso. La arquitectura fijada describe una barrera de red que permite a la carga contactar únicamente con el supervisor.
Esto importa cuando el agente puede leer archivos, instalar paquetes o llamar API. Una instrucción en el prompt no impone permisos. Los controles documentados actúan sobre archivos, procesos y red; esta revisión de fuentes no los ha probado en un host real.
Separar política y credenciales
La política describe archivos, procesos, destinos y métodos API accesibles. Los proveedores conservan las credenciales fuera de la carga no fiable y el supervisor las añade únicamente a peticiones aprobadas.
Hay que inspeccionar la política efectiva incluso en un sandbox nuevo. La política predeterminada no tiene reglas de salida, pero una imagen, una política global o un proveedor conectado pueden cambiar el resultado. Omitir `--policy` no demuestra ausencia de acceso.
Delimitar las afirmaciones
El README describe controles del núcleo y comprobación formal de cambios propuestos. Son afirmaciones arquitectónicas del proyecto. El código y la documentación fijados muestran el flujo previsto, sin sustituir una prueba de penetración independiente ni certificar un despliegue concreto.
Los próximos capítulos tratan una primera ejecución pequeña, despliegue, código, coste y operación. Un piloto útil empieza con una carga desechable y conserva la lista de permisos concedidos.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Identificar gateway, supervisor y carga no fiable.
- 2
Inspeccionar la política efectiva antes de permitir llamadas externas.
- 3
Elegir una tarea desechable con resultado comprobable.
Ejemplo para copiar
agente -> mediación del sandbox -> supervisor fiable -> destino aprobado
gateway -> política, identidad y ciclo de vida
credencial -> solo supervisorPreguntas frecuentes
¿El agente ve la clave API del proveedor?
La arquitectura fijada dice que el supervisor conserva e inyecta credenciales solo en destinos aprobados.
¿El primer sandbox carece siempre de salida a red?
No. La imagen, la política global o las reglas del proveedor pueden alterar la política efectiva.
Fuentes
- OpenShell / README.mdFuente verificada 2026-10-04
- OpenShell / docs/about/architecture.mdxFuente verificada 2026-10-04
- OpenShell / docs/how-it-works/policies/default-policy.mdxFuente verificada 2026-10-04
- OpenShell / docs/how-it-works/providers/overview.mdxFuente verificada 2026-10-04