Este documento descreve uma arquitetura de alto nível para um aplicativo que gera e administra um teste de aprendizado interativo com um fluxo de trabalho de IA agêntica. O agente avalia o conhecimento de um usuário sobre um tópico específico e usa um estado de sessão persistente e memória de longo prazo para criar uma experiência personalizada. O agente mantém um histórico das respostas do usuário, o que permite ajustar dinamicamente a dificuldade e o conteúdo das perguntas subsequentes.
O público-alvo deste documento inclui arquitetos, desenvolvedores e administradores que criam e gerenciam aplicativos de IA agêntica. Essa arquitetura é adaptável para criar aplicativos educacionais interativos e com estado em vários setores. O documento pressupõe um entendimento básico dos sistemas de agentes de IA. Para informações sobre como os agentes diferem dos sistemas não agênticos , consulte Qual é a diferença entre agentes de IA, assistentes de IA e bots?
A seção de implantação deste documento fornece um link para um exemplo de código para ajudar você a experimentar a implantação de um aplicativo de IA agêntica que administra um teste de aprendizado interativo.
Arquitetura
O diagrama a seguir mostra uma arquitetura de alto nível para um agente de aprendizado interativo.
A arquitetura mostra o seguinte fluxo de dados:
- Um usuário realiza uma ação, como iniciar um teste ou enviar uma resposta, no aplicativo de teste hospedado no Cloud Run.
- O aplicativo encaminha a entrada do usuário para o agente de IA.
O agente de IA usa o modelo do Gemini na Gemini Enterprise Agent Platform para interpretar a entrada do usuário. Com base na solicitação do usuário, o agente chama as ferramentas adequadas para realizar a ação de teste solicitada.
Por exemplo, o agente seleciona uma ferramenta para iniciar uma sessão de teste, avaliar uma resposta ou gerar a próxima pergunta.
O agente envia a resposta ao aplicativo de teste.
O aplicativo de teste encaminha a resposta ao usuário.
Para manter o estado do teste e personalizar a experiência, o agente realiza as seguintes tarefas em segundo plano:
- O agente anexa o progresso e a pontuação mais recentes do teste ao histórico da sessão salva armazenada em Sessões da Gemini Enterprise Agent Platform.
- O agente transforma os dados do teste em memórias e os armazena no Memory Bank para recuperação de longo prazo. O agente usa os dados históricos armazenados na memória para gerar respostas contextuais em sessões futuras.
Produtos usados
Esta arquitetura de exemplo usa os seguintes Google Cloud produtos e ferramentas de código aberto:
- Cloud Run: uma plataforma de computação sem servidor que permite executar contêineres diretamente na infraestrutura escalonável do Google.
- Kit de Desenvolvimento de Agente (ADK): um conjunto de ferramentas e bibliotecas para desenvolver, testar e implantar agentes de IA.
- Gemini Enterprise Agent Platform: uma plataforma abrangente que permite criar, escalonar, governar e otimizar agentes de IA de nível empresarial.
- Sessões da Gemini Enterprise Agent Platform: um serviço de armazenamento persistente que salva e recupera o histórico de interações entre um usuário e agentes.
- Memory Bank: um serviço de armazenamento persistente que gera, refina, gerencia e recupera memórias de longo prazo com base nas conversas de um usuário com um agente.
Considerações sobre segurança
Para ajudar a lidar com os riscos de segurança exclusivos dos agentes de IA, o Google recomenda uma abordagem que combina controles de segurança determinísticos com defesas dinâmicas baseadas em raciocínio:
- Supervisão humana: incorpore um fluxo de human-in-the-loop em sistemas essenciais para os negócios para que os supervisores humanos possam revisar as saídas e aprovar, substituir ou pausar as ações do agente.
- Identidade do agente: Atribua a cada agente uma identidade vinculada à carga de trabalho para aplicar o controle de acesso de privilégio mínimo e gerenciar as credenciais de ferramentas externas de maneira centralizada.
- Gateway de Agente: aplique a governança de tráfego de entrada e saída, políticas de acesso de negação padrão, e inspeção de comandos e ferramentas inline com o Model Armor.
- Registro de Agente: verifique se os agentes só se conectam a subagentes e ferramentas de MCP aprovados.
As orientações desta seção não são completas. Para mais informações sobre fatores de design e práticas recomendadas, e para recomendações sobre como criar e implantar um sistema de IA multiagente, consulte Sistema de IA multiagente em Google Cloud.
Implantação
Para implantar um exemplo de implementação dessa arquitetura que fornece testes relacionados à programação, use o exemplo de código do tutor do Python disponível no GitHub.
A seguir
- (Notebook) Comece a usar as sessões e o Memory Bank da Agent Platform para agentes do ADK no Cloud Run.
- (Blog) Saiba mais sobre o estado e a memória com o ADK.
- (Codelab) Crie um assistente de revisão de código de IA de produção com o ADK.
- (Vídeo) Assista à memória de longo prazo do agente de IA com o Memory Bank.
- Saiba como hospedar agentes de IA no Cloud Run.
- Para uma visão geral dos princípios e recomendações arquitetônicos específicos para cargas de trabalho de IA e ML em Google Cloud, consulte a perspectiva de IA e ML no Well-Architected Framework.
- Para mais arquiteturas de referência, diagramas e práticas recomendadas, confira a Central de arquitetura do Cloud.
Colaboradores
Autor: Samantha He | Redatora técnica
Outros colaboradores:
- Amina Mansour | Líder técnica, relações com desenvolvedores globais e conteúdo estratégico
- Kumar Dhanagopal | Desenvolvedor de soluções para vários produtos
- Megan O'Keefe | Mediadora de desenvolvedores
- Rachael Deacon-Smith | Mediadora de desenvolvedores
- Shir Meir Lador | Gerente de engenharia de relações com desenvolvedores