El sistema de permisos controla qué acciones puede realizar el agente sin pedir tu aprobación. Puedes aprobar de antemano las acciones seguras, bloquear las peligrosas y solicitar siempre confirmación para operaciones sensibles.Documentation Index
Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
Use this file to discover all available pages before exploring further.
Comportamiento predeterminado de los permisos
| Tipo de herramienta | Ejemplo | Normal | Aceptar ediciones | Omitir | Autónomo (sandbox) |
|---|---|---|---|---|---|
| Solo lectura | Lecturas de archivos, grep, glob | No | No | No | No |
| Fetch | Solicitudes HTTP | Sí | Sí | No | No |
| Comandos de Bash | Ejecución del shell | Sí | Sí | No | No |
Ediciones de archivos mediante edit/write | Editar/escribir archivos | Sí | No (en el workspace) | No | Sí |
edit/write siguen requiriendo aprobación, porque esas herramientas funcionan fuera del sandbox. Autónomo solo está disponible cuando el sandbox a nivel del sistema operativo está activo.
Modo autónomo
--sandbox. Conceptualmente, equivale más o menos a “Aceptar ediciones en el workspace actual” más la capacidad de ejecutar cualquier comando de shell, con ambos comportamientos contenidos por el sandbox a nivel del sistema operativo. Cuando el sandbox está activo:
- Es el único modo de permisos disponible. Normal, Aceptar ediciones y Omitir se ocultan en las sesiones con sandbox. El modo Plan sigue estando disponible.
- Los comandos de shell y las operaciones de fetch se aprueban automáticamente en lugar de pedir confirmación, porque el sandbox impone lo que pueden leer, escribir y alcanzar a través de la red.
- Las ediciones directas de archivos mediante las herramientas
editywritesiguen pidiendo confirmación. Estas herramientas se ejecutan dentro del proceso de la CLI, en lugar de hacerlo dentro del sandbox, por lo que no pueden quedar restringidas por él. Conceder un ámbitoWrite(...)en el prompt amplía dinámicamente el sandbox para que los comandos de shell posteriores puedan escribir allí. - Los ámbitos concedidos a mitad de la sesión amplían dinámicamente el sandbox para los comandos posteriores.
--sandbox (que selecciona Autonomous) cuando quieras una ejecución desatendida con límites aplicados por el sistema operativo al acceso al sistema de archivos y a la red. Consulta la referencia de configuración de sandbox para obtener más información sobre las raíces con permisos de lectura/escritura y el filtrado de dominios, y Team Settings → Aplicación de Sandbox para los controles de Enterprise.
Cómo funcionan los permisos
- Reglas de denegación — Se comprueban primero. Si coinciden, la acción se bloquea de inmediato.
- Reglas de solicitud — Se comprueban en segundo lugar. Si coinciden, siempre se te pedirá confirmación (tienen prioridad sobre cualquier regla de autorización).
- Reglas de autorización — Se comprueban al final. Si coinciden, la acción continúa sin pedir confirmación.
- Predeterminado — Si no coincide ninguna regla, se te pedirá aprobación.
Como la denegación se comprueba antes que la solicitud, y la solicitud se comprueba antes que la autorización, una regla de denegación siempre prevalece. Si el mismo ámbito coincide tanto con una regla de denegación como con una de solicitud, se aplica la denegación.
Configuración
permissions de tu archivo de configuración:
En Windows, la ruta del archivo de configuración del usuario es
%APPDATA%\devin\config.json (normalmente C:\Users\<you>\AppData\Roaming\devin\config.json) en lugar de ~/.config/devin/config.json. Consulta Archivo de configuración para obtener más detalles.- Configuración del proyecto
- Configuración del usuario
- Anulación local
Sintaxis de permisos
Permisos basados en el ámbito
Read(glob)
Read(glob)
Controla el acceso de lectura a archivos. El patrón glob coincide con rutas de archivo.Las rutas de directorio incluyen automáticamente todos los archivos que contienen.
Write(glob)
Write(glob)
Controla el acceso de escritura y edición de archivos.
Exec(prefix)
Exec(prefix)
Controla la ejecución de comandos de shell. Coincide con los comandos que empiezan por el prefijo indicado.
Exec(git) coincide con “git”, “git status” y “git commit -m ‘msg’”, pero NO con “gitk” ni “github-cli”. El prefijo debe coincidir como una palabra completa.Fetch(pattern)
Fetch(pattern)
Controla el acceso HTTP mediante patrones de URL.Los patrones de URL siguen el estándar WHATWG URL Pattern. La abreviatura
domain: coincide con cualquier ruta del dominio exacto.Permisos por herramienta
read, edit, grep, glob, exec
Permisos de las herramientas del servidor MCP
| Patrón | Coincide con |
|---|---|
mcp__server__tool | Una herramienta específica |
mcp__server__* | Todas las herramientas de un servidor |
mcp__* | Todas las herramientas MCP en todas partes |
Patrones de ruta
Read() y Write() admiten:
| Patrón | Significado |
|---|---|
* | Cualquier carácter en un solo segmento de ruta |
** | Cualquier carácter a través de segmentos de ruta (recursivo) |
~ | Expansión del directorio de inicio |
Usa un prefijo de ruta absoluta (p. ej.,
Read(/**)) cuando quieras que coincida con todos los archivos del sistema. Un Read(**) sin una / inicial se resuelve en relación con tu directorio de trabajo actual, por lo que solo coincide con los archivos dentro de ese directorio, no con los archivos a los que se accede mediante rutas absolutas en otras ubicaciones.Opciones de persistencia
| Opción | Dónde se guarda | ¿Se comparte con el equipo? |
|---|---|---|
| Permitir esta vez | No se guarda | No |
| Permitir para la sesión | Solo en memoria | No |
| Permitir para el proyecto | .devin/config.json | Sí |
| Permitir para el proyecto (local) | .devin/config.local.json | No |
| Permitir globalmente | ~/.config/devin/config.json (%APPDATA%\devin\config.json en Windows) | No |
Permisos a nivel del servidor MCP
list_issues en el servidor de Figma), la solicitud de permisos también ofrece opciones más amplias a nivel del servidor:
| Opción | Efecto |
|---|---|
| Permitir esta herramienta (esta sesión) | Otorga acceso a la herramienta específica durante la sesión actual |
| Permitir siempre esta herramienta | Guarda en la configuración el permiso para esa herramienta específica |
| Permitir todas las herramientas de este servidor (esta sesión) | Otorga acceso a todas las herramientas del servidor durante la sesión |
| Permitir siempre las herramientas de este servidor | Guarda en la configuración el acceso a todas las herramientas del servidor |
Precedencia
- Configuración de la organización o del equipo (si es Enterprise)
- Permisos a nivel de sesión (aprobaciones interactivas)
- Configuración local del proyecto (
.devin/config.local.json) - Configuración del proyecto (
.devin/config.json) - Configuración del usuario (
~/.config/devin/config.json;%APPDATA%\devin\config.jsonen Windows)
