Saltar al contenido

El blog de Deska

Una política de uso de agentes que vale la pena copiar

Descarga una plantilla de política de uso de agentes diseñada para equipos de ingeniería que usan herramientas de IA autónomas manteniendo la seguridad local.

11 min de lectura

Desarrollar software en la era de los agentes autónomos requiere más que simples claves de API. Requiere un marco claro para gobernar cómo estas herramientas interactúan con tu código fuente, entornos de producción y datos propietarios. Una plantilla de política de uso de agentes sirve como base para esta gobernanza, asegurando que mientras los ingenieros aprovechan herramientas como Claude Code o Codex CLI, lo hagan dentro de límites de seguridad definidos. Este artículo proporciona una plantilla funcional y explora las consideraciones técnicas para implementar flujos de trabajo agénticos sin comprometer la seguridad.

La necesidad de una gobernanza formal de agentes

Los asistentes de IA tradicionales suelen funcionar como interfaces de chat simples. Los agentes, sin embargo, son fundamentalmente diferentes. Poseen la capacidad de ejecutar comandos, modificar sistemas de archivos y navegar por la web de forma independiente. Sin una política formal, un equipo corre el riesgo de exfiltración accidental de datos, eliminación involuntaria de recursos o la introducción de patrones de código inseguros que omiten los procesos de revisión estándar.

Una política robusta aborda tres dominios específicos. Primero, define la residencia de los datos, asegurando que el código y las variables de entorno sensibles no permanezcan en servidores de terceros. Segundo, establece límites de ejecución para evitar bucles infinitos o comandos de terminal destructivos. Tercero, aclara el requisito de supervisión humana, asegurando que ninguna acción agéntica se considere final hasta que un desarrollador humano valide el resultado.

Plantilla de política de uso de agentes para equipos de ingeniería

Puedes adaptar las siguientes secciones en tu documentación interna. Esta plantilla está diseñada para equipos que priorizan la ejecución local y la supervisión estricta de las acciones automatizadas.

1. Alcance y propósito

Esta política se aplica a todo el personal de ingeniería que utilice agentes de IA autónomos, definidos como cualquier software capaz de ejecutar comandos de shell, modificar archivos de origen o realizar llamadas a API basadas en objetivos de lenguaje natural de alto nivel. El objetivo es maximizar la velocidad del desarrollador manteniendo una postura de seguridad local-first.

2. Herramientas y entorno aprobados

Solo se permiten agentes que se ejecuten dentro de entornos aprobados, aislados o controlados. Se prefieren las herramientas que proporcionan un canvas unificado para monitorear múltiples hilos de agentes simultáneamente. Todos los agentes deben operar bajo las siguientes condiciones:

  • La ejecución debe ocurrir en la máquina local o en un relevo seguro aprobado.
  • El uso de inferencia gestionada se permite solo para datos no sensibles, a menos que esté activo un modelo BYOK (trae tu propia clave).
  • No se debe otorgar a los agentes privilegios de root o administración en la máquina host.

3. Manejo de datos y privacidad

La integridad del código es primordial. Para minimizar el riesgo, los ingenieros deben:

  • Preferir herramientas que mantengan los datos y el almacenamiento de forma local.
  • Nunca introducir secretos de producción no cifrados, PII o datos de clientes en un prompt de agente.
  • Auditar regularmente los logs del agente para asegurar que no se haya guardado información sensible en el contexto del modelo.

4. Supervisión humana y verificación

Ningún agente está autorizado a enviar código a un repositorio remoto o desplegar a producción de forma autónoma. Cada cambio iniciado por un agente debe ser:

  • Revisado en un editor de código estándar.
  • Verificado mediante suites de pruebas locales.
  • Confirmado explícitamente por el usuario humano.

Implementación de la política con espacios de trabajo modernos

Escribir la política es solo la mitad de la batalla. La otra mitad es usar herramientas que hagan del cumplimiento el camino de menor resistencia. Deska es una aplicación de escritorio gratuita para Mac, Windows y Linux que ayuda a los equipos a seguir estas pautas al proporcionar un entorno controlado para agentes de IA.

Al usar un espacio de trabajo de lienzo infinito, puedes colocar paneles para Claude Code, Codex CLI y OpenCode uno al lado del otro. Esta visibilidad es crucial para la sección de "Supervisión humana" de tu política. En lugar de procesos ocultos en segundo plano, cada acción del agente es visible en un panel de terminal en tu pantalla. Puedes alejarte para ver todo el flujo de trabajo o acercarte para inspeccionar un comando de terminal específico.

La naturaleza local-first de Deska se alinea con los requisitos de manejo de datos de una plantilla de política de uso de agentes profesional. Debido a que el espacio de trabajo permanece en tu máquina, tus archivos y sesiones no se almacenan en una base de datos en la nube. Cuando usas la aplicación mobile para monitorear el progreso, los dispositivos se emparejan directamente a través de un relevo seguro sin exponer puertos, manteniendo el límite de seguridad definido en tu documento de gobernanza.

Comparación de estrategias de orquestación de agentes

Diferentes equipos requieren diferentes niveles de autonomía. La siguiente tabla compara enfoques comunes para el despliegue de agentes.

EstrategiaNivel de SeguridadAutonomíaSupervisión Humana
Chat basado en navegadorBajoMínimaAlta
Agentes solo de CLIMedioAltaBaja (Difícil de rastrear)
Lienzo Unificado (Deska)AltoBalanceadaAlta (Rastreo visual)
CI/CD totalmente autónomoVariableMáximaAuditoría periódica

Los equipos a menudo encuentran que un espacio de trabajo unificado proporciona el mejor equilibrio. Por ejemplo, usar Ask Deska permite a un desarrollador dirigir el espacio de trabajo mediante voz o chat, pidiendo al asistente que abra paneles o verifique sesiones. Esto crea un rastro de auditoría claro de qué se abrió y cuándo, lo que respalda los requisitos de auditoría de una política estándar.

Salvaguardas técnicas y mejores prácticas

Más allá de la política escrita, los ingenieros deben implementar restricciones técnicas. En Deska, puedes organizar tu trabajo en diferentes workspaces. Esto te permite aislar un experimento de agente de alto riesgo en un espacio de trabajo mientras mantienes tu entorno de producción estable en otro.

Usa terminals con variables de entorno restringidas al probar nuevos agentes. Si un agente requiere acceso a la web, usa browser widgets para limitar su alcance a sitios de documentación específicos. Estas características convierten los puntos teóricos de tu plantilla de política de uso de agentes en hábitos prácticos diarios.

Si eres un suscriptor que utiliza inferencia gestionada, asegúrate de entender las implicaciones de privacidad. Para aquellos que requieren el nivel más alto de privacidad, el modelo de pricing permite una opción BYOK para un nivel de por vida, asegurando que tengas control total sobre las claves de API y los datos enviados a los proveedores.

FAQ

¿Cómo escribir una política de IA para mi equipo de desarrollo?

Comienza por definir el nivel de acceso que los agentes tienen a tu sistema de archivos y shell. Usa una plantilla que enfatice la ejecución local y la verificación manual de todos los cambios de código. Asegúrate de que la política cubra tanto el uso de herramientas internas como de proveedores de LLM externos.

¿Cuáles son los riesgos de los agentes de programación con IA?

Los riesgos principales incluyen la generación de código inseguro, la eliminación accidental de archivos y la filtración de código propietario a proveedores de LLM. Usar una herramienta que mantenga el código y los archivos git de forma local puede mitigar muchos de estos riesgos al evitar la sincronización en la nube de activos sensibles.

¿Cómo monitorear agentes de IA autónomos?

El monitoreo efectivo requiere un espacio de trabajo visual donde las salidas del agente se rendericen en tiempo real. Usar un lienzo que ejecute agentes lado a lado en paneles de terminal te permite detectar errores inmediatamente. Además, revisar los hilos de agentes ayuda a reconstruir la lógica utilizada por la IA.

Descarga las herramientas para asegurar tu flujo de trabajo

Establecer una política es un paso vital hacia la adopción profesional de la IA. Para proporcionar a tu equipo el entorno que necesitan para seguir estas reglas, puedes download Deska gratis. Te ofrece el lienzo, las terminales y la arquitectura local-first necesaria para ejecutar agentes como Claude Code y OpenCode de forma segura. Al combinar una plantilla de política de uso de agentes clara con un espacio de trabajo de escritorio robusto, aseguras que la IA siga siendo un activo poderoso en lugar de una responsabilidad.