Saltar al contenido

El blog de Deska

Gestión de agentes en una base de código aislada (Air-Gapped)

Aprende a desplegar y gestionar agentes de IA en una base de código aislada manteniendo la privacidad de datos y protocolos de seguridad local-first.

12 min de lectura

La ejecución de agentes en una base de código aislada (Air-Gapped) presenta un conjunto único de desafíos para los equipos de desarrollo modernos. Aunque las ganancias de productividad de los agentes de codificación autónomos están bien documentadas, los requisitos de seguridad de los repositorios sensibles a menudo impiden el uso de extensiones de IDE basadas en la nube que transmiten el contenido de los archivos a servidores externos. Implementar una estrategia local-first garantiza que tu propiedad intelectual permanezca dentro de tu entorno controlado mientras sigues aprovechando el poder de los modelos de lenguaje extensos para refactorización, depuración e implementación de funciones.

Entendiendo la restricción del entorno aislado

En el contexto de la ingeniería de software, un entorno aislado o air-gapped se refiere a un sistema que está física o lógicamente separado de redes no seguras, específicamente de la internet pública. Para muchas organizaciones, este es el estándar básico para manejar algoritmos propietarios, sistemas financieros o infraestructura gubernamental.

Las herramientas de IA estándar suelen tener dificultades en estos entornos. La mayoría de las extensiones populares funcionan como clientes ligeros que envían fragmentos de código a una API central para su procesamiento. Cuando trabajas con agentes en una base de código aislada, esta arquitectura falla. En su lugar, debes confiar en herramientas que respeten los límites de los datos, asegurando que la lógica, el sistema de archivos y el entorno de ejecución permanezcan localizados.

La arquitectura de los agentes de IA locales

Para mantener una postura segura, el stack para agentes locales debe descomponerse en tres capas distintas. Cada capa debe ser validada por su capacidad de operar sin telemetría de salida.

  1. El motor de inferencia: Es el backend que ejecuta el modelo. Puede ser un proveedor local como Ollama o una instancia privada de un LLM alojada en hardware interno.
  2. El framework agéntico: Esta capa maneja los bucles de razonamiento. Determina qué archivos leer, qué comandos ejecutar y cómo iterar sobre una solución.
  3. El espacio de trabajo de interacción: Aquí es donde el desarrollador supervisa al agente. Una interfaz fragmentada provoca cambios de contexto constantes, razón por la cual se prefiere un lienzo unificado para gestionar múltiples procesos paralelos.

Comparación de estrategias Local-First

Diferentes herramientas abordan el problema del aislamiento con distintos grados de éxito. Al evaluar tu stack, considera cómo cada herramienta maneja el acceso a archivos y la gestión del estado.

Categoría de herramientaPrivacidad de datosRequisito de conectividadGestión de ventana de contexto
Extensiones IDE en nubeBajaConstanteAutomática
Agentes basados en CLIAltaOpcionalManual
Espacios local-firstAltaNingunaVisual/Espacial

Herramientas como Aider u OpenCode difieren en su enfoque en comparación con los entornos integrados. Las herramientas de CLI son excelentes para tareas específicas, pero pueden volverse difíciles de gestionar cuando un agente necesita mostrar cambios visuales complejos en múltiples archivos simultáneamente.

Aprovechando Deska para el desarrollo aislado

Deska proporciona un entorno especializado para desarrolladores que necesitan mantener su trabajo de forma local. Es una aplicación de escritorio gratuita disponible para Mac, Windows y Linux que funciona como un espacio de trabajo de lienzo infinito. Debido a que es local-first, el código que escribes y los archivos que procesas nunca salen de tu máquina a menos que configures explícitamente una API externa.

Dentro de Deska, puedes ejecutar múltiples agentes de codificación como Claude Code, Codex CLI y OpenCode uno al lado del otro. Cada agente opera en su propio panel, lo que te permite comparar sus resultados en tiempo real sin cambiar de pestaña.

El poder de los paneles y el lienzo

El diseño del canvas es particularmente útil cuando se trabaja en una base de código aislada porque te permite visualizar el estado completo del sistema. Puedes colocar una terminal junto a un editor de código y un hilo de agente, luego alejar el zoom para ver la relación entre ellos.

  • Terminales: Ejecuta tus scripts de construcción locales o servidores de inferencia.
  • Editor de código: Un editor Monaco integrado para la manipulación directa de archivos.
  • Navegador: Inspecciona documentación local o salidas de interfaz basadas en web.
  • Notas: Mantén un registro de las decisiones arquitectónicas tomadas por el agente.

Gestión de conectividad con BYOK

Para los usuarios que pueden acceder a un proxy privado o una pasarela LLM interna, Deska admite un modelo de "trae tu propia clave" (BYOK). Esto es parte del nivel de por vida, asegurando que el modelo de precios se alinee con las necesidades de infraestructura a largo plazo. Si tu entorno aislado permite un único túnel controlado a un endpoint de API específico, puedes ingresar tus claves directamente en la aplicación para dirigir a los agentes mientras mantienes el espacio de trabajo totalmente local.

Integración del flujo de trabajo y Ask Deska

Gestionar un agente requiere más que una interfaz de chat. Requiere un asistente que comprenda el espacio de trabajo. Deska incluye Ask Deska, un asistente de voz y chat capaz de dirigir el entorno. Puede abrir paneles, ejecutar terminales y revisar sesiones activas.

Si estás monitoreando una refactorización larga mientras estás lejos de tu estación de trabajo principal, la aplicación móvil te permite revisar el progreso. Utiliza un relevo seguro donde los dispositivos se emparejan directamente. No se exponen puertos a la internet pública, manteniendo la integridad de tu entorno aislado.

Mejores prácticas de seguridad para agentes locales

Al desplegar agentes en una base de código aislada, sigue estos protocolos para asegurar que no ocurran fugas de datos:

  • Desactiva toda la telemetría en tu IDE y herramientas de CLI.
  • Utiliza un servidor de inferencia local si la política de seguridad prohíbe todas las llamadas a API externas.
  • Audita el bucle agéntico para asegurar que no intente descargar dependencias externas durante la ejecución.
  • Utiliza configuraciones de datos y almacenamiento que apunten a volúmenes cifrados.

Al centralizar estas herramientas en un espacio de trabajo unificado, reduces la superficie de ataque para errores de configuración. Mantener tu código y archivos git dentro de una sola aplicación monitoreada como Deska simplifica el proceso de auditoría.

Preguntas frecuentes

¿Cómo ejecuto agentes de IA sin conexión a internet?

Debes usar un motor de inferencia local como Ollama o LocalAI combinado con un framework de agentes compatible. El agente debe estar configurado para apuntar a tu endpoint local en lugar de a una API pública. Deska permite ejecutar estos agentes como paneles dentro de su espacio de trabajo local-first.

¿Son seguros los agentes de codificación para repositorios propietarios?

Son seguros solo si la herramienta sigue una arquitectura local-first. Evita las herramientas que cargan tu código para "análisis contextual". En su lugar, utiliza plataformas que mantengan el código en tu máquina y solo envíen prompts específicos a tu proveedor de LLM elegido y asegurado.

¿Puedo usar Claude Code en un entorno restringido?

Sí, siempre que tengas el acceso necesario a la API o un proxy local. Al ejecutar Claude Code dentro de un panel de terminal en Deska, puedes integrar sus capacidades de razonamiento en un flujo de trabajo más amplio y gestionado localmente.

Comenzando con espacios de trabajo locales

La transición a un flujo de trabajo de IA local-first no requiere sacrificar la experiencia de desarrollo moderna. Al utilizar un lienzo infinito y la ejecución de agentes en paralelo, puedes mantener una alta velocidad incluso bajo estrictas restricciones de seguridad. Puedes explorar la guía de inicio para entender cómo configurar tu primer entorno aislado.

Para comenzar a construir con agentes bajo tus propios términos, puedes descargar la aplicación de escritorio Deska para tu sistema operativo preferido.