API de Managed Agents en el entorno de pruebas de Agent Platform

La API de Managed Agents en Agent Platform opera con zonas de pruebas de Linux estándar y aisladas. En este contenedor de ejecución seguro y completamente administrado, los agentes personalizados pueden razonar, planificar flujos de trabajo, ejecutar comandos de Bash y leer o escribir archivos de forma predeterminada.

Todos los entornos de zona de pruebas proporcionan los siguientes sistemas y controles principales:

• Sistema de archivos persistente: Conserva de forma segura los archivos, la lógica del agente y el estado de ejecución en las interacciones de varios turnos.

• Terminal de Bash: Proporciona un entorno seguro para ejecutar comandos de terminal, ejecutar secuencias de comandos personalizadas y procesar archivos locales.

• Aislamiento de red: Inhabilitado de forma predeterminada. Puedes declarar de forma explícita una red allowlist para permitir que el agente acceda a recursos de Internet públicos o descargue bibliotecas externas.

• Integraciones extensibles: Admite la importación dinámica de capacidades personalizadas, incluidas las APIs web estándar, los servidores del Protocolo de contexto del modelo (MCP) o las habilidades de Skill Registry.

Permisos y seguridad de la zona de pruebas

Para mantener los límites de seguridad empresarial estándar, la zona de pruebas remota opera según los siguientes modelos de permisos:

• Aislamiento de red: De forma predeterminada, la zona de pruebas funciona sin acceso a la red externa. Habilita la conectividad de forma explícita configurando una lista de entidades permitidas de dominios en la configuración de tu entorno. Consulta Configura el acceso a la red para ver ejemplos de listas de entidades permitidas.

• Ejecución con privilegio mínimo: Una vez que se habilita el acceso a la red, el contenedor no tiene credenciales ni permisos administrativos con privilegios. De forma predeterminada, solo puede consultar ubicaciones de Internet de acceso público.

• Alcance de datos para las vinculaciones de Cloud Storage y Skill Registry: Cuando adjuntas fuentes de datos externas de Google Cloud Storage o Skill Registry, el entorno recibe tokens de autorización con alcance reducido diseñados para acceder solo a los directorios o habilidades específicos que se indican en las configuraciones del agente. La zona de pruebas no contiene credenciales ambientales y no puede acceder a otros repositorios ni archivos de tu proyecto.

• Alcance de las credenciales de MCP: Las configuraciones de encabezado para los servidores del Protocolo de contexto del modelo (MCP), que contienen tokens de autenticación de backend, se transmiten solo cuando se accede a los extremos de MCP específicos definidos en tu configuración.

Ejecución y administración del ciclo de vida

Estos parámetros estándar rigen la ejecución y el ciclo de vida de la zona de pruebas:

• Entorno de zona de pruebas: Los agentes se ejecutan con un entorno de zona de pruebas completamente administrado, que usa el arnés de Antigravity para la organización.

• Tiempo de actividad (TTL) del entorno de pruebas: El entorno de pruebas tiene un tiempo de actividad (TTL) estándar de 7 días. Cada interacción nueva restablece automáticamente este temporizador para garantizar que los agentes activos sigan disponibles.

• Persistencia de la configuración del agente: El backend almacena de forma persistente la configuración del agente, y esta permanece hasta que envías una solicitud DELETE explícita a la API de Agents.

• Colaboración entre agentes: Varios agentes comparten el mismo entorno cuando proporcionas el mismo env_id durante la interacción.

Software ya instalado

La zona de pruebas contiene un conjunto de utilidades estándar de Linux:

El agente puede instalar paquetes adicionales en el tiempo de ejecución con pip install o npm install cuando el acceso a la red está habilitado. Estos paquetes persisten en la instantánea del entorno y permanecen disponibles para las interacciones que reutilizan el mismo env_id.

Arquitectura de montaje de habilidades

Cuando configuras habilidades externas de fuentes como el registro de habilidades dentro del base_environment.sources de un agente, estos recursos se adjuntan directamente al sistema de archivos de la zona de pruebas. El sistema coloca cada habilidad dentro de los directorios de destino especificados, lo que conserva la estructura de directorios original del paquete de habilidades. Esta organización ayuda a garantizar que el agente pueda seguir descubriendo los archivos de habilidades individuales.

Ejemplo de configuración de fuentes

En el siguiente ejemplo, se adjuntan tres habilidades del Registro de habilidades:

"sources": [
  {
    "type": "skill_registry",
    "source": "projects/{projectID}/locations/{location}/skills/pdf-skill",
    "target": "/.agent/skills/"
  },
  {
    "type": "skill_registry",
    "source": "projects/{projectID}/locations/{location}/skills/finance-skill",
    "target": "/.agent/skills/"
  },
  {
    "type": "skill_registry",
    "source": "projects/{projectID}/locations/{location}/skills/git-skill",
    "target": "/.agent/other-skills/"
  }
]

Estructura del sistema de archivos de la zona de pruebas después de la activación

Después de aprovisionar el entorno de pruebas, los archivos se activan y estructuran dentro del contenedor de la siguiente manera:

/ (root)
└── .agent/
    ├── skills/                    <-- Mount Target for pdf-skill & finance-skill
    │   ├── pdf-skill/             <-- Preserved skill directory
    │   │   ├── SKILL.md
    │   │   └── scripts/
    │   └── finance-skill/         <-- Preserved skill directory
    │       ├── SKILL.md
    │       └── scripts/
    └── other-skills/              <-- Mount Target for git-skill
        └── git-skill/             <-- Preserved skill directory
            ├── SKILL.md
            └── scripts/

Herramientas integradas en la zona de pruebas

Cuando se ejecuta en el entorno administrado, el agente tiene acceso a varias herramientas predeterminadas:

¿Qué sigue?