Descripción general de las sesiones de Vertex AI Agent Engine
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Las sesiones de Vertex AI Agent Engine mantienen 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 las sesiones de Vertex AI Agent Engine:
Kit de desarrollo de agentes: Una vez que implementes tu agente del kit de desarrollo de agentes (ADK) en Agent Engine de Vertex AI, la administración de sesiones se realizará automáticamente.
Llamadas a la API: Puedes realizar llamadas directas a la API de las sesiones de Vertex AI Agent Engine 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.
Estado: Un estado contiene datos temporales relevantes solo durante la conversación actual.
Memoria: La memoria es información personalizada a la que se puede acceder en varias sesiones para un usuario en particular. El agente puede usar recuerdos para personalizar las respuestas al usuario y garantizar la continuidad entre sesiones.
Funcionalidades principales
Las funcionalidades principales de las sesiones de Vertex AI Agent Engine incluyen lo siguiente:
Iniciar conversaciones nuevas: Crea sesiones nuevas cuando un usuario comienza 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 (eventos) nuevas al historial de una sesión para actualizarla.
Conversaciones de la ficha: Busca los hilos de sesiones activas para un usuario y una aplicación en particular.
Limpieza: Borra los objetos de sesión y sus datos asociados cuando las conversaciones finalizan o ya no son necesarios.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[],[],null,["| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nVertex AI Agent Engine Sessions maintains the history of interactions between a user and agents. Sessions provide definitive sources for long-term memory and conversation context.\n\nYou have several options to use Vertex AI Agent Engine Sessions:\n\n- [Agent Development Kit](/vertex-ai/generative-ai/docs/agent-engine/sessions/manage-sessions-adk): Once you deploy your Agent Development Kit (ADK) agent to Vertex AI Agent Engine, session management is handled automatically.\n\n- [API calls](/vertex-ai/generative-ai/docs/agent-engine/sessions/manage-sessions-api): You can make direct API calls to Vertex AI Agent Engine Sessions if you don't want to manage sessions using an ADK agent.\n\nCore concepts\n\n- **Session**: A session represents the chronological sequence of messages and actions (events) for a single, ongoing interaction between a user and your agent system.\n\n- **Event**: An event stores the content of the conversation, as well as the actions taken by the agents such as function calls.\n\n- **State**: A state holds temporary data relevant only during the current conversation.\n\n- **Memory**: Memory is personalized information that can be accessed across multiple sessions for a particular user. The agent can use memories to personalize responses to the user and ensure cross-session continuity.\n\nCore functionalities\n\nThe core functionalities of Vertex AI Agent Engine Sessions include the following:\n\n- **Starting new conversations**: Create new sessions when a user begins an interaction with an agent.\n\n- **Resuming existing conversations**: Retrieving a specific session so the agent can resume a conversation that has been paused.\n\n- **Saving progress**: Append new interactions (events) to a session's history to update the session.\n\n- **Listing conversations**: Find the active session threads for a particular user and application.\n\n- **Cleaning up**: Delete session objects and their associated data when conversations are finished or no longer needed.\n\nWhat's next\n\n- [Manage sessions using ADK](/vertex-ai/generative-ai/docs/agent-engine/sessions/manage-sessions-adk).\n- [Manage sessions using API calls](/vertex-ai/generative-ai/docs/agent-engine/sessions/manage-sessions-api)."]]
