---
read_when:
- Ajuste de los valores predeterminados del modo elevado, las listas de permitidos o el comportamiento de los comandos de barra diagonal
- Cómo pueden acceder al host los agentes aislados mediante sandbox
summary: 'Modo de ejecución con privilegios elevados: ejecuta comandos fuera del entorno aislado desde un agente aislado'
title: Modo elevado
x-i18n:
generated_at: "2026-07-11T23:34:09Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: ab035f2f0d0074da4e7661d9d690d89aa5eea25b7920ce48a2a03dffccded85b
source_path: tools/elevated.md
workflow: 16
---
Cuando un agente se ejecuta dentro de un entorno aislado, sus comandos `exec` quedan confinados al entorno aislado. El **modo elevado** permite que el agente salga de él y ejecute comandos fuera del entorno aislado, con controles de aprobación configurables.
El modo elevado solo cambia el comportamiento cuando el agente está **aislado**. Para los agentes no aislados, `exec` ya se ejecuta en el host.
## Directivas
Controla el modo elevado por sesión con comandos de barra:
| Directiva | Qué hace |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/elevated on` | Ejecuta fuera del entorno aislado en la ruta del host configurada y mantiene las aprobaciones |
| `/elevated ask` | Igual que `on` (alias) |
| `/elevated full` | Ejecuta fuera del entorno aislado en la ruta del host configurada y omite las aprobaciones cuando la política de aprobación del modo/host ya es permisiva |
| `/elevated off` | Vuelve a la ejecución confinada al entorno aislado |
También está disponible como `/elev on|off|ask|full`.
Envía `/elevated` sin argumentos para ver el nivel actual.
## Cómo funciona
El modo elevado debe estar habilitado en la configuración y el remitente debe estar en la lista de permitidos:
```json5
{
tools: {
elevated: {
enabled: true,
allowFrom: {
discord: ["user-id-123"],
whatsapp: ["+15555550123"],
},
},
},
}
```
Envía un mensaje que solo contenga la directiva para establecer el valor predeterminado de la sesión:
```
/elevated full
```
O úsala en línea (se aplica únicamente a ese mensaje):
```
/elevated on run the deployment script
```
Con el modo elevado activo, las llamadas a `exec` salen del entorno aislado. El host efectivo es
`gateway` de forma predeterminada, o `node` cuando el destino de ejecución configurado o de la sesión es
`node`. En el modo `full`, las aprobaciones de ejecución se omiten cuando la política resuelta de aprobación
del modo/host de ejecución ya es completamente permisiva (seguridad `full`,
solicitud `off`); de lo contrario, se sigue aplicando la política de aprobación normal. En
el modo `on`/`ask`, siempre se aplican las reglas de aprobación configuradas.
## Orden de resolución
1. **Directiva en línea** en el mensaje (se aplica únicamente a ese mensaje)
2. **Anulación de la sesión** (se establece enviando un mensaje que solo contenga la directiva)
3. **Valor predeterminado global** (`agents.defaults.elevatedDefault` en la configuración)
## Disponibilidad y listas de permitidos
- **Control global**: `tools.elevated.enabled` (debe ser `true`)
- **Lista de remitentes permitidos**: `tools.elevated.allowFrom` con listas por canal
- **Control por agente**: `agents.list[].tools.elevated.enabled` (solo puede imponer más restricciones; tanto el control global como el control por agente deben ser `true`)
- **Lista de permitidos por agente**: `agents.list[].tools.elevated.allowFrom` (el remitente debe coincidir tanto con la lista global como con la del agente)
- **Lista de permitidos alternativa proporcionada por el canal**: los plugins de canal pueden proporcionar opcionalmente una lista de permitidos alternativa mediante un enlace de adaptador del SDK, que se utiliza cuando `tools.elevated.allowFrom.` no está configurado. Actualmente ningún canal incluido implementa este enlace, por lo que, en la práctica, hoy cada proveedor necesita una entrada explícita `tools.elevated.allowFrom.`.
- **Deben superarse todos los controles**; de lo contrario, el modo elevado se considera no disponible
Formatos de las entradas de la lista de permitidos:
| Prefijo | Coincide con |
| ----------------------- | ------------------------------------------------ |
| (ninguno) | ID del remitente, E.164 o campo From |
| `name:` | Nombre mostrado del remitente |
| `username:` | Nombre de usuario del remitente |
| `tag:` | Etiqueta del remitente |
| `id:`, `from:`, `e164:` | Identidad especificada explícitamente |
## Qué no controla el modo elevado
- **Política de herramientas**: si la política de herramientas deniega `exec`, el modo elevado no puede anularla.
- **Política de selección del host**: el modo elevado no convierte `auto` en una anulación libre entre hosts. Utiliza las reglas de destino de ejecución configuradas o de la sesión y elige `node` únicamente cuando el destino ya es `node`.
- **Independiente de `/exec`**: la directiva `/exec` ajusta los valores predeterminados de ejecución por sesión (host, seguridad, solicitud, nodo) para remitentes autorizados y no requiere el modo elevado.
El comando de chat de bash (prefijo `!`; alias `/bash`) es un control independiente que requiere que `tools.elevated` esté habilitado, además de su propia opción `tools.bash.enabled`. Deshabilitar el modo elevado también bloquea los comandos de shell `!`.
## Relacionado
Ejecución de comandos de shell desde el agente.
Sistema de aprobación y listas de permitidos para `exec`.
Configuración del entorno aislado a nivel del Gateway.
Cómo se combinan los tres controles durante una llamada a una herramienta.