A partir de 29 de abril de 2025, os modelos Gemini 1.5 Pro e Gemini 1.5 Flash não estarão disponíveis em projetos que não os usaram antes, incluindo novos projetos. Para mais detalhes, consulte Versões e ciclo de vida do modelo.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
As sessões do Vertex AI Agent Engine mantêm o histórico de interações entre um usuário e agentes. As sessões fornecem fontes definitivas para memória de longo prazo e contexto de conversa.
Você tem várias opções para usar as sessões do Vertex AI Agent Engine:
Agent Development Kit: depois de implantar o agente do Agent Development Kit (ADK) no Vertex AI Agent Engine, o gerenciamento de sessões é feito automaticamente.
Chamadas de API: é possível fazer chamadas de API diretas para as sessões do Vertex AI Agent Engine se você não quiser gerenciar sessões usando um agente ADK.
Principais conceitos
Sessão: uma sessão representa a sequência cronológica de mensagens e ações (eventos) de uma única interação contínua entre um usuário e seu sistema de agente.
Evento: um evento armazena o conteúdo da conversa, bem como as ações realizadas pelos agentes, como chamadas de função.
Estado: um estado contém dados temporários relevantes apenas durante a conversa atual.
Memória: são informações personalizadas que podem ser acessadas em várias sessões de um usuário específico. O agente pode usar memórias para personalizar respostas ao usuário e garantir a continuidade entre sessões.
Funcionalidades principais
As principais funcionalidades das sessões do Vertex AI Agent Engine incluem o seguinte:
Iniciar novas conversas: crie novas sessões quando um usuário iniciar uma interação com um agente.
Retomar conversas: recuperar uma sessão específica para que o agente possa retomar uma conversa que foi pausada.
Salvar progresso: adicione novas interações (eventos) ao histórico de uma sessão para atualizar.
Listar conversas: encontre as linhas de execução de sessões ativas de um usuário e aplicativo específicos.
Limpeza: exclua objetos de sessão e os dados associados quando as conversas terminarem ou não forem mais necessárias.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[],[],null,["# Vertex AI Agent Engine Sessions overview\n\n| **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\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--------------------\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\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)."]]
