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 inmediata.
Cada entorno de zona de pruebas proporciona 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: Está inhabilitado de forma predeterminada. Puedes declarar de forma explícita una red
allowlistpara permitir que el agente acceda a recursos públicos de Internet o descargue bibliotecas externas.Integraciones extensibles: Admite la importación de capacidades personalizadas de forma dinámica, 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 funciona con 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 dominios permitidos 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 privilegios mínimos: Una vez que se habilita el acceso a la red, el contenedor carece de credenciales o permisos administrativos con privilegios. De forma predeterminada, solo puede consultar ubicaciones de Internet de acceso público.
Alcance de los datos para las activaciones de Cloud Storage y Skill Registry: Cuando adjuntas fuentes de datos externas de Cloud Storage o Skill Registry, el entorno recibe tokens de autorización con alcance reducido diseñados para acceder solo a los directorios o las habilidades específicos que se indican en las configuraciones del agente. La zona de pruebas no contiene credenciales de entorno y no puede acceder a otros repositorios o 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, con el arnés de Antigravity para la organización.
Tiempo de actividad (TTL) de la zona de pruebas: El entorno de la zona 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 las configuraciones de los agentes, y estas permanecen hasta que envías una solicitud
DELETEexplícita a la API de Agents.Colaboración de agentes: Varios agentes comparten el mismo entorno cuando proporcionas el mismo
env_iddurante la interacción.
Software ya instalado
La zona de pruebas contiene un conjunto de utilidades estándar de Linux:
| Categoría | Paquetes y herramientas |
|---|---|
| Herramientas de UNIX |
|
| Paquetes de Python 3.11 |
|
| Paquetes globales de Node.js 20 |
|
El agente puede instalar paquetes adicionales en el entorno 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
en el 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 del paquete de habilidades
original. Esta organización ayuda a garantizar que los archivos de habilidades individuales sigan siendo detectables por el agente.
Configuración de fuentes de ejemplo
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 que se aprovisiona el entorno de zona 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 de la zona de pruebas
Cuando se ejecuta en el entorno administrado, el agente tiene acceso a varias herramientas predeterminadas:
| Nombre de la herramienta | Descripción |
|---|---|
bash |
Ejecuta un comando de shell en la terminal de la zona de pruebas y devuelve el resultado. |
file_system |
Lee, escribe y borra el contenido de un archivo, y enumera el contenido de un directorio. |
¿Qué sigue?
Descripción general de la API de Managed Agents en Agent Platform
Obtén información sobre la API de Managed Agents en Agent Platform, un entorno basado en la configuración y centrado en REST para crear agentes autónomos.
Crea y administra agentes
Aprende a crear, actualizar, enumerar, obtener y borrar agentes con la API de REST.
Interactúa con agentes
Aprende a interactuar con los agentes durante el tiempo de ejecución, administrar el estado de la sesión y anular configuraciones de forma dinámica.