Descripción general de Agent Platform Sessions

Agent Platform Sessions mantiene el historial de interacciones entre un usuario y los agentes. Las sesiones proporcionan fuentes definitivas para la memoria a largo plazo y el contexto de la conversación.

Tienes varias opciones para usar Agent Platform Sessions:

  • Kit de desarrollo de agentes (ADK): Una vez que implementas tu agente del ADK en Gemini Enterprise Agent Platform, la administración de sesiones se controla automáticamente.

  • Llamadas a la API: Puedes realizar llamadas directas a la API a las sesiones de Agent Platform si no quieres administrar sesiones con un agente de ADK.

Conceptos básicos

  • Sesión: Una sesión representa la secuencia cronológica de mensajes y acciones (eventos) para una sola interacción en curso entre un usuario y tu sistema de agentes.

  • Evento: Un evento almacena el contenido de la conversación, así como las acciones que realizan los agentes, como las llamadas a funciones. Los eventos admiten un esquema flexible para dar cabida a datos personalizados y diferentes frameworks.

  • Estado: Un estado contiene datos temporales que solo son relevantes durante la conversación actual.

  • Memoria: La memoria es información personalizada a la que se puede acceder en varias sesiones de un usuario en particular. El agente puede usar memorias para personalizar las respuestas al usuario y garantizar la continuidad entre sesiones.

Funcionalidades principales

Las funcionalidades principales de las sesiones de Agent Platform incluyen lo siguiente:

  • Iniciar conversaciones nuevas: Crea sesiones nuevas cuando un usuario comience una interacción con un agente.

  • Reanudar conversaciones existentes: Recuperar una sesión específica para que el agente pueda reanudar una conversación que se pausó.

  • Guardar el progreso: Agrega interacciones nuevas (eventos) al historial de una sesión para actualizarla.

  • Mostrar conversaciones: Busca los hilos de sesiones activas de un usuario y una aplicación específicos.

  • Limpieza: Borra los objetos de sesión y sus datos asociados cuando las conversaciones finalicen o ya no sean necesarias.

Seguridad y administración empresarial

Las sesiones de Agent Platform admiten controles de seguridad empresarial para ayudarte a proteger el historial de conversaciones, el estado de la sesión y los eventos contra el acceso no autorizado o el robo de datos.

Controles del servicio de VPC (Controles del servicio de VPC)

Las sesiones de Agent Platform admiten los Controles del servicio de VPC para mitigar el riesgo de robo de datos de tus datos de sesión y eventos de conversación. Debido a que sessions y events son recursos secundarios de una instancia de Agent Runtime (reasoningEngines) que se entrega a través de la API de Agent Platform (aiplatform.googleapis.com), agregar la API de Agent Platform a un perímetro de servicio de los Controles del servicio de VPC protege todas las operaciones de sesión (CreateSession, GetSession, ListSessions, UpdateSession, DeleteSession, AppendEvent y ListEvents).

Cuando configures los Controles del servicio de VPC para las sesiones, sigue estos lineamientos:

  • Configuración del perímetro: Agrega la API de Agent Platform (aiplatform.googleapis.com) al perímetro de servicio de los Controles del servicio de VPC. Asegúrate de que tu proyecto se agregue al perímetro de servicio antes de crear la instancia superior de Agent Runtime que aloja tus sesiones.
  • Conectividad de extremos privados: Enruta las solicitudes a LOCATION-aiplatform.googleapis.com (o aiplatform.googleapis.com para extremos globales) desde tu red de VPC a través de restricted.googleapis.com (199.36.153.4/30) o un extremo interno de Private Service Connect para las APIs de Google.
  • Usa sesiones con Agent Gateway en un perímetro de servicio: Cuando un agente implementado en Agent Runtime está vinculado a un Agent Gateway de aplicación de políticas en el modo de agente a cualquier lugar (salida), las llamadas a la API salientes de tu agente a las sesiones atraviesan la puerta de enlace. Para evitar bloqueos perimetrales o de puerta de enlace, haz lo siguiente:
    • Configura la puerta de enlace con una plantilla de conectividad de agente (AgentConnectivityTemplate) con vpcEgress establecido en ALL_TRAFFIC y el intercambio de tráfico de Cloud DNS privado para googleapis.com.. Para obtener más detalles, consulta Cumplimiento de los Controles del servicio de VPC para Agent Gateway.
    • Registra y agrega a la lista de entidades permitidas los extremos regionales y de mTLS de Agent Platform API en Agent Registry para que tu agente pueda llamar al extremo de sesiones (https://LOCATION-aiplatform.googleapis.com/API_VERSION/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/sessions) y otorgarle a tu identidad de agente el rol de salida de IAP (roles/iap.egressor). Para obtener instrucciones paso a paso, consulta Enruta el tráfico de Agent Runtime a través de Agent Gateway.

Claves de encriptación administradas por el cliente (CMEK)

De forma predeterminada, Google Cloud encripta el estado de la sesión y los eventos de conversación en reposo con Google-owned and Google-managed encryption keys. Para proteger los datos de tu sesión con claves que administras en Cloud Key Management Service (Cloud KMS), especifica el encryption_spec (kms_key_name) cuando crees la instancia superior de Agent Runtime. Todas las sesiones y los eventos almacenados en esa instancia heredan su configuración de CMEK. Para conocer los pasos generales de configuración de proyectos y claves, consulta CMEK para Gemini Enterprise Agent Platform.

Se aplican las siguientes limitaciones cuando se usa CMEK con las sesiones:

  • Restricciones del extremo global y del entorno de ejecución implementado: No puedes usar CMEK cuando Sessions está configurado para usar el extremo global (location="global"), ya que Cloud Key Management Service requiere que las claves de encriptación residan dentro de un límite geográfico de residencia de datos. Para usar CMEK, crea una instancia superior independiente (sin implementar el código del entorno de ejecución del agente) en una ubicación regional o multirregional compatible con una clave de Cloud KMS coincidente (para las instancias multirregionales, usa una clave us para us o una clave europe para eu). Si la instancia superior también implementa un agente en Agent Runtime, debes usar una ubicación de una sola región, ya que los entornos de ejecución implementados no admiten CMEK en extremos multirregionales (us o eu).
  • No se puede actualizar la clave de encriptación: Una vez que se crea una instancia con una clave de Cloud KMS, no puedes cambiar la clave de esa instancia. Para usar una clave diferente, debes crear una instancia nueva.

¿Qué sigue?