Agent Runtime es un conjunto de servicios que permite a los desarrolladores implementar, administrar y escalar agentes de IA en producción. Agent Runtime administra la infraestructura para escalar agentes en producción, de modo que puedas enfocarte en crear aplicaciones. Agent Runtime ofrece los siguientes servicios que puedes usar de forma individual o combinada:
- Tiempo de ejecución:
- Implementa y escala agentes con un entorno de ejecución administrado y capacidades de administración de extremo a extremo.
- Personaliza la imagen del contenedor del agente con secuencias de comandos de instalación en tiempo de compilación para las dependencias del sistema.
- Usa funciones de seguridad, como el cumplimiento de VPC-SC y la configuración de la autenticación y la IAM.
- Accede a modelos y herramientas, como las llamadas a funciones.
- Implementa agentes creados con diferentes frameworks de Python y el protocolo abierto Agent2Agent.
- Calidad y evaluación (versión preliminar): Evalúa la calidad del agente con el servicio de evaluación de IA generativa integrado y optimiza los agentes con ejecuciones de entrenamiento de modelos de Gemini.
- Sesiones de Agent Platform: Las sesiones de Agent Platform te permiten almacenar interacciones individuales entre usuarios y agentes, lo que proporciona fuentes definitivas para el contexto de la conversación.
- Agent Platform Memory Bank: Agent Runtime Agent Platform Memory Bank te permite almacenar y recuperar información de las sesiones para personalizar las interacciones del agente.
- Ejecución de código: La ejecución de código de Agent Runtime permite que tu agente ejecute código en un entorno de zona de pruebas seguro, aislado y administrado.
- Almacén de ejemplos few-shot (versión preliminar): Almacena y recupera dinámicamente algunos ejemplos para mejorar el rendimiento del agente.
- Observabilidad: Comprende el comportamiento de los agentes con Google Cloud Trace (compatible con OpenTelemetry), Cloud Monitoring y Cloud Logging.
- Gobernanza: Agent Runtime admite varias funciones para ayudarte a gobernar los agentes en producción y satisfacer tus necesidades empresariales y de seguridad:
- Detecta amenazas con Security Command Center: Agent Runtime Threat Detection (versión preliminar) es un servicio integrado de Security Command Center que te ayuda a detectar e investigar posibles ataques a los agentes implementados en Agent Runtime.
- Identidad del agente (versión preliminar): Usa la identidad del agente de Identity Access Management (IAM) para proporcionar funciones de seguridad y administración de acceso cuando uses agentes en Agent Runtime.
- Agent Gateway (versión preliminar): Usa Agent Gateway para definir reglas para las comunicaciones basadas en agentes y aplicar políticas de seguridad y control de acceso en agentes, clientes y herramientas que se conectan a tu proyecto deGoogle Cloud y desde él.
Crea e implementa en Agent Runtime
El flujo de trabajo para compilar un agente en Agent Runtime es el siguiente:
- Configura el entorno: Configura tu proyecto de Google e instala la versión más reciente del SDK de Agent Platform para Python.
- Desarrolla un agente: Desarrolla un agente que se pueda implementar en Agent Runtime.
- Implementa el agente: Implementa el agente en el entorno de ejecución administrado de Agent Runtime.
- Usar el agente: Envía una solicitud a la API para consultar al agente.
- Administra el agente implementado: Administra y borra los agentes que implementaste en Agent Runtime.
Los pasos se ilustran en el siguiente diagrama:
Frameworks compatibles
En la siguiente tabla, se describe el nivel de compatibilidad que proporciona Agent Runtime para varios frameworks de agentes:
| Nivel de asistencia | Frameworks de agentes |
|---|---|
| Plantilla personalizada: Puedes adaptar una plantilla personalizada para admitir la implementación en Agent Runtime desde tu framework. | CrewAI, marcos de trabajo personalizados |
| Integración del SDK de Agent Platform: Agent Runtime proporciona plantillas administradas por framework en el SDK y la documentación de Agent Platform. | LangChain, LangGraph, AG2, LlamaIndex |
| Integración completa: Las funciones se integran para trabajar en todo el framework, Agent Runtime y el ecosistema Google Cloud más amplio. | Kit de desarrollo de agentes (ADK) |
Implementa en producción con la CLI de Agents
La Agents CLI es la interfaz de línea de comandos y el conjunto de habilidades unificados para Gemini Enterprise Agent Platform. Proporciona a los agentes de codificación y a los desarrolladores una ruta predecible a través del ciclo de vida del desarrollo de agentes: andamiaje, evaluación, implementación, publicación y observación. La CLI de Agents proporciona lo siguiente:
- Plantillas de agentes prediseñadas: ReAct, RAG, multiagente y otras plantillas
- Espacio de pruebas interactivo: Prueba tu agente e interactúa con él.
- Infraestructura automatizada: Utiliza Terraform para optimizar la administración de recursos.
- Canalizaciones de CI/CD: Flujos de trabajo de implementación automatizados que aprovechan Cloud Build
- Observabilidad: Compatibilidad integrada con Cloud Trace y Cloud Logging
Para comenzar, consulta la Guía de inicio rápido.
Casos de uso
Para obtener información sobre Agent Runtime con ejemplos de extremo a extremo, consulta los siguientes recursos:
Haz clic para expandir los casos de uso
| Caso de uso | Descripción | Vínculos | |
|---|---|---|---|
| Compila agentes conectándote a APIs públicas | Convierte entre monedas. Crea una función que se conecte a una app de cambio de moneda, lo que permite que el modelo proporcione respuestas precisas a consultas como "¿Cuál es el tipo de cambio de euros a dólares hoy?". |
Notebook del SDK de Agent Platform (Python) - Introducción a la compilación y la implementación de un agente con Agent Runtime | |
| Diseña un proyecto de huerto solar. Identifica ubicaciones potenciales, busca oficinas y proveedores gubernamentales relevantes, y revisa imágenes satelitales y el potencial solar de regiones y edificios para encontrar la ubicación óptima para instalar tus paneles solares. |
Notebook del SDK de Agent Platform (Python): Compila e implementa un agente de la API de Google Maps con Agent Runtime | ||
| Crea agentes conectándote a bases de datos | Integración con AlloyDB y Cloud SQL para PostgreSQL | Publicación de blog: Anunciamos LangChain en la Plataforma de agentes de Gemini Enterprise para AlloyDB y Cloud SQL para PostgreSQL Notebook del SDK de la Plataforma de agentes (Python): Implementa una aplicación de RAG con Cloud SQL para PostgreSQL en Agent Runtime Notebook del SDK de la Plataforma de agentes (Python): Implementa una aplicación de RAG con AlloyDB para PostgreSQL en Agent Runtime |
|
| Crea agentes con herramientas que accedan a los datos de tu base de datos. | Notebook del SDK de Agent Platform (Python): Implementa un agente con Agent Runtime y MCP Toolbox para bases de datos | ||
| Consulta y comprende los almacenes de datos estructurados con lenguaje natural. | Notebook del SDK de Agent Platform (Python) - Compila un agente de búsqueda conversacional con Agent Runtime y RAG en Agent Search | ||
| Consulta y comprende bases de datos de grafos con lenguaje natural | Entrada de blog - GenAI GraphRAG y agentes de IA que usan Agent Runtime con LangChain y Neo4j | ||
| Consulta y comprende almacenes de vectores con lenguaje natural | Entrada de blog: Simplifica la recuperación aumentada por generación con MongoDB Atlas y Agent Runtime | ||
| Crea agentes con el Kit de desarrollo de agentes | Crear e implementar agentes con el Kit de desarrollo de agentes | Kit de desarrollo de agentes: Implementación en Agent Runtime | |
| Crea agentes con frameworks de OSS | Compila e implementa agentes con el framework de código abierto OneTwo. | Entrada de blog - OneTwo y Agent Runtime: explora el desarrollo avanzado de agentes de IA en Google Cloud | |
| Compila e implementa agentes con el framework de código abierto LangGraph. | Notebook del SDK de Agent Platform (Python): Compila e implementa una aplicación de LangGraph con Agent Runtime | ||
| Depuración y optimización de agentes | Compila y realiza seguimientos de agentes mediante OpenTelemetry y Cloud Trace. | Cuaderno de notas del SDK de Agent Platform (Python) - Agentes de depuración y optimización: Una guía de seguimiento en Agent Runtime | |
| Crea sistemas multiagente con el protocolo A2A (versión preliminar) | Crea agentes interoperables que se comuniquen y colaboren con otros agentes, independientemente de su framework. | Para obtener más información, consulta la documentación del protocolo A2A. | |
Seguridad empresarial
Agent Runtime admite varias funciones para ayudarte a cumplir con los requisitos de seguridad de la empresa, respetar las políticas de seguridad de tu organización y seguir las prácticas recomendadas de seguridad. Se admiten las siguientes funciones:
Controles del servicio de VPC: Agent Runtime admite los Controles del servicio de VPC para fortalecer la seguridad de los datos y mitigar los riesgos de robo de datos. Para obtener más información, consulta Controles del servicio de VPC del tiempo de ejecución del agente.
Interfaz de Private Service Connect: Para Agent Runtime, PSC-I permite que tus agentes interactúen con servicios alojados de forma privada en la VPC de un usuario. Para obtener más información, consulta Usa la interfaz de Private Service Connect con Agent Runtime.
Claves de encriptación administradas por el cliente (CMEK): Agent Runtime admite CMEK para proteger tus datos con tus propias claves de encriptación, lo que te otorga la propiedad y el control total de las claves que protegen tus datos en reposo en Google Cloud. Para obtener más información, consulta CMEK de Agent Runtime.
Residencia de datos (DRZ): Agent Runtime admite la residencia de datos (DRZ) para garantizar que todos los datos en reposo se almacenen dentro de la región especificada.
HIPAA: Como parte de Agent Platform, Agent Runtime admite cargas de trabajo de la HIPAA.
Transparencia de acceso: La Transparencia de acceso te proporciona registros que capturan las acciones que realizan los empleados de Google cuando acceden a tu contenido. Para obtener más información sobre cómo habilitar la Transparencia de acceso para Agent Runtime, consulta Transparencia de acceso en Agent Platform.
En la siguiente tabla, se muestran las funciones de seguridad empresarial compatibles con cada servicio de la Plataforma de agentes:
| Función de seguridad | Agent Runtime | Evaluación de agentes | Sesiones | Memory Bank | Almacén de ejemplos | Ejecución de código |
|---|---|---|---|---|---|---|
| Controles del servicio de VPC | Sí | No | Sí | Sí | No | Sí |
| Claves de encriptación administradas por el cliente | Sí | No | Sí | Sí | No | Sí |
| Residencia de datos (DRZ) en reposo | Sí | No | Sí | Sí | No | Sí |
| HIPAA | Sí | Sí | Sí | Sí | Sí | Sí |
| Transparencia de acceso | Sí | No | Sí | Sí | No | No |
| Aprobación de acceso | Sí | No | Sí | Sí | No | No |
Regiones admitidas
Consulta Ubicaciones para obtener una lista de las regiones compatibles con Agent Runtime.
Cuota
Consulta Cuotas y límites del sistema para obtener información sobre las cuotas de Agent Runtime.
Precios
Hay un nivel gratuito disponible para Agent Runtime. Para obtener información sobre los precios de Agent Runtime, consulta los precios de Gemini Enterprise Agent Platform.
Migración al SDK basado en el cliente
El módulo agent_engines del SDK de Agent Platform se está refactorizando a un diseño basado en el cliente por los siguientes motivos clave:
- Para alinearse con el Kit de desarrollo de agentes (ADK) y el SDK de IA generativa de Google en representaciones de tipos canónicos Esto garantiza una forma coherente y estandarizada de representar los tipos de datos en los diferentes SDKs, lo que simplifica la interoperabilidad y reduce la sobrecarga de conversión.
- Permite definir el alcance de los parámetros Google Cloud a nivel del cliente en aplicaciones de varios proyectos y varias ubicaciones. Esto permite que una aplicación administre las interacciones con los recursos en diferentes proyectos y ubicaciones geográficas de Google Cloud configurando cada instancia del cliente con su proyecto específico y la configuración de ubicación.
- Mejorar la visibilidad y la cohesión de los servicios de Agent Runtime
¿Qué sigue?
Configuración del entorno de ejecución de Agent Platform
Configura tu entorno para usar Agent Platform Runtime.