Présentation des sessions du moteur d'agent Vertex AI
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les sessions Vertex AI Agent Engine conservent l'historique des interactions entre un utilisateur et les agents. Les sessions fournissent des sources définitives pour la mémoire à long terme et le contexte de la conversation.
Vous disposez de plusieurs options pour utiliser les sessions Vertex AI Agent Engine :
Agent Development Kit : une fois que vous avez déployé votre agent Agent Development Kit (ADK) sur Vertex AI Agent Engine, la gestion des sessions est gérée automatiquement.
Appels d'API : vous pouvez effectuer des appels d'API directs aux sessions Vertex AI Agent Engine si vous ne souhaitez pas gérer les sessions à l'aide d'un agent ADK.
Concepts fondamentaux
Session : une session représente la séquence chronologique de messages et d'actions (événements) pour une interaction unique et continue entre un utilisateur et votre système d'agent.
Événement : un événement stocke le contenu de la conversation, ainsi que les actions effectuées par les agents, comme les appels de fonction.
État : un état contient des données temporaires qui ne sont pertinentes que pendant la conversation en cours.
Mémoire : la mémoire est une information personnalisée à laquelle un utilisateur peut accéder lors de plusieurs sessions. L'agent peut utiliser les infos mémorisées pour personnaliser les réponses à l'utilisateur et assurer la continuité entre les sessions.
Fonctionnalités de base
Voici les principales fonctionnalités des sessions Vertex AI Agent Engine :
Démarrer de nouvelles conversations : créez des sessions lorsqu'un utilisateur commence une interaction avec un agent.
Reprise des conversations existantes : récupération d'une session spécifique pour que l'agent puisse reprendre une conversation qui a été mise en pause.
Enregistrement de la progression : ajoutez de nouvelles interactions (événements) à l'historique d'une session pour la mettre à jour.
Lister les conversations : trouvez les fils de discussion de session active pour un utilisateur et une application spécifiques.
Nettoyage : supprimez les objets de session et les données associées lorsque les conversations sont terminées ou ne sont plus nécessaires.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]