Ir al contenido principal
Español— Elegir un idioma
Menú

Asegurar un agente: seguridad, permisos y carpetas de confianza

Lección 3 de 14 Actualizado el 2 de noviembre de 2026 Avanzado
En esta página
  1. Qué hace (y qué no hace) safety
  2. Primera palanca: herramientas disponibles
  3. Segunda palanca: permisos por herramienta
  4. Tercera palanca: alcance del directorio de trabajo
  5. Cuarta palanca: carpetas de confianza
  6. Responder a una solicitud de aprobación
  7. Elegir el equilibrio adecuado
  8. Puntos clave

Lección reescrita el 2 de noviembre de 2026. La versión anterior describía el campo safety como un nivel de permiso. La documentación de Vibe es explícita: se trata de un indicador visual que colorea el borde del campo de entrada; no impone restricción alguna. La protección real proviene de las listas de herramientas, los permisos por herramienta y las carpetas de confianza. Fuentes: Safety, approvals, and permissions · Configuration reference.

Qué hace (y qué no hace) safety

El campo safety en un archivo de agente acepta cinco valores: safe, neutral (el predeterminado), destructive, smart y yolo. Cambia el color del borde del área de entrada para ofrecerte un recordatorio visual instantáneo del agente que estás utilizando. No elimina herramientas ni activa solicitudes de aprobación. Un agente marcado como safe pero equipado con bash sin restricciones puede seguir ejecutando comandos destructivos.

Existe una excepción: cuando un administrador desactiva la aprobación automática (enable_auto_approve = false), Vibe oculta todos los agentes marcados como yolo. Por lo demás, safety es una etiqueta, no un candado. Combínalo siempre con los controles reales que se detallan a continuación.

Primera palanca: herramientas disponibles

enabled_tools (lista de permitidos) y disabled_tools (lista de denegados, aplicada posteriormente) deciden qué puede invocar el agente. Aceptan nombres exactos, patrones glob y expresiones regulares con el prefijo re:.

# Agente de auditoría de solo lectura
display_name = "Security Audit"
safety = "safe"
enabled_tools = ["read_file", "grep"]

Si una herramienta no está en la lista, no existe para ese agente. Esta es tu garantía más sólida.

Segunda palanca: permisos por herramienta

Para las herramientas disponibles, un bloque [tools.<tool>] establece la regla: "always" (sin pregunta), "ask" (preguntar cada vez) o "never" (bloquear).

display_name = "Refactoring"
safety = "neutral"
enabled_tools = ["read_file", "grep", "edit", "write_file", "bash"]

[tools.edit]
permission = "always"

[tools.write_file]
permission = "ask"

[tools.bash]
permission = "ask"
allowlist = ["git status", "git diff", "pnpm test"]
denylist = ["rm -rf", "git push"]

Para bash, allowlist y denylist especifican prefijos de comando que siempre están permitidos o siempre denegados. Vibe permite algunos comandos de solo lectura por defecto (ls, pwd, cat, git status, etc.), pero cualquier lista que escribas reemplaza la lista predeterminada: incluye cualquier comando por defecto que quieras mantener. Para read_file, write_file y edit, estas listas aceptan patrones de ruta absoluta. Una regla prudente: un script ejecutado mediante bash puede construir rutas que Vibe no ve en el propio comando; mantén bash configurado como "ask" siempre que las consecuencias lo justifiquen.

Tercera palanca: alcance del directorio de trabajo

Por defecto, Vibe solicita confirmación antes de que una herramienta de archivo o shell acceda a una ruta fuera del directorio de trabajo, incluso mediante un enlace simbólico, y antes de leer o modificar archivos .env y .envrc. Puedes reforzar este comportamiento:

outside_workdir = "deny"   # denegar en lugar de preguntar; el agente recibe un error y continúa

Cuarta palanca: carpetas de confianza

Un repositorio puede incluir su propia configuración de Vibe (agentes, habilidades, servidores MCP, permisos) en una carpeta .vibe/, o instrucciones en un archivo AGENTS.md. Dado que esta configuración cambia el comportamiento de Vibe, solo se carga desde una carpeta que hayas aprobado explícitamente. En el primer lanzamiento, Vibe lista los archivos detectados y ofrece Trust folder, Trust full repo o Don’t trust; tus elecciones se guardan en ~/.vibe/trusted_folders.toml. El diálogo no analiza estos archivos: revísalos como cualquier otro código del repositorio, especialmente las definiciones de servidores MCP y los permisos. En modo programático, Vibe nunca pregunta: vibe --trust otorga confianza temporal para una única ejecución.

Responder a una solicitud de aprobación

Cuando Vibe solicita confirmación, hay cuatro respuestas de teclado posibles: 1 o y permite una vez, 2 para el resto de la sesión, 3 siempre, y 4, n o Escape deniega. El color del borde te recuerda qué agente está activo.

Elegir el equilibrio adecuado

NecesidadConfiguración
Analizar sin tocar nadaenabled_tools = ["read_file", "grep"]
Refactorizar con confianzaedit establecido en "always", bash en "ask" con una allowlist de comandos de prueba
Limpiar un proyectobash en "ask" y una denylist de comandos irreversibles
Tarea desatendida en CIContenedor efímero, vibe --prompt … --auto-approve, límites --max-turns y --time-limit

La regla de oro sigue siendo el mínimo privilegio: da a cada agente lo estrictamente necesario, comienza con restricciones y abre el acceso solo según sea necesario.

Puntos clave

  • safety (safe, neutral, destructive, smart, yolo) colorea el borde; no aplica permisos
  • Candados reales: enabled_tools/disabled_tools, luego [tools.<tool>] (always, ask, never)
  • Para bash, allowlist y denylist reemplazan las listas predeterminadas
  • Vibe pregunta antes de salir del directorio de trabajo o tocar archivos .env
  • La configuración del proyecto solo se carga en una carpeta de confianza; revísala antes de aprobar