View a markdown version of this page

Construtor de agentes - Criador de aplicações de IA generativa na AWS
AgentCore integraçãoConfiguração do agenteStreaming e processamentoGerenciamento de memóriaObservabilidadeConstrutor de fluxo

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Construtor de agentes

O Agent Builder fornece uma plataforma para criar, implantar e gerenciar agentes de IA prontos para produção no Amazon Bedrock. AgentCore Esta seção descreve os componentes técnicos e os detalhes da implementação.

AgentCore integração

O Agent Builder usa uma abordagem de implantação baseada em configuração com imagens de agentes pré-criadas para permitir implantações de agentes rápidas, seguras e escaláveis.

Imagens de agentes pré-criadas

As imagens do contêiner do agente são criadas pela equipe do GAAB durante o CI/CD pipeline e publicadas em um repositório ECR público. Cada versão da imagem está vinculada à versão da solução GAAB (por exemplo, v4.0.0 →:v4.0.0). gaab-strands-agent As imagens são baseadas no SDK Strands e incluem:

  • Ambiente de tempo de execução do agente

  • Integração com o cliente MCP

  • Capacidades de gerenciamento de memória

  • OpenTelemetry instrumentação

Cache pull-Through do ECR

A solução usa o ECR Pull-Through Cache para distribuir automaticamente imagens do agente do repositório ECR público para o ECR privado do cliente. Esse serviço gerenciado pela AWS:

  • Armazena imagens em cache na primeira extração (atraso de 2 a 5 minutos)

  • Elimina a lógica personalizada de cópia de imagens

  • Fornece disponibilidade de imagens locais para implantações subsequentes

  • Cria regras de cache exclusivas por implantação para evitar conflitos

Armazenamento de configuração

As configurações do agente são armazenadas no DynamoDB junto com as configurações de casos de uso existentes. Cada configuração inclui:

  • Modelo de prompt do sistema

  • Fornecedor do modelo e ID do modelo

  • Parâmetros do modelo (temperatura, max_tokens)

  • Referências e endpoints do servidor MCP

  • Configurações de memória (alternância de memória de longo prazo)

  • Metadados de implantação

Registro da versão da imagem

Uma tabela do DynamoDB rastreia as versões disponíveis da imagem do agente e seu URIs cache, permitindo o gerenciamento de versões e a compatibilidade com versões anteriores.

Configuração do agente

Solicitações do sistema

Os prompts do sistema definem o comportamento, a personalidade e as capacidades do agente. Os usuários administradores podem:

  • Edite o modelo padrão por meio da interface do Agent Builder

  • Inclua instruções para uso da ferramenta e formatação de respostas

  • Redefina para o modelo padrão a qualquer momento

Seleção de modelos

O Agent Builder oferece suporte aos modelos Amazon Bedrock na v4.0.0:

  • Fornecedor de modelos: Amazon Bedrock (única opção na v4.0.0)

  • Seleção de modelos: Claude, Nova e outros modelos Bedrock

  • Parâmetros do modelo: temperatura, max_tokens, top_p e configurações específicas do modelo

Integração do servidor MCP

Os servidores do Model Context Protocol fornecem aos agentes acesso a ferramentas e dados corporativos:

  • Descoberta de servidores por meio do endpoint da API GET /mcp

  • Configuração dinâmica sem alterações de código

  • Autenticação e gerenciamento de endpoints

  • Capacidade da ferramenta: exposição a agentes

Streaming e processamento

Streaming em tempo real

O Agent Builder usa eventos enviados pelo servidor (SSE) de forma interligada WebSocket para streaming AgentCore de respostas em tempo real:

  • A função Lambda estabelece conexão SSE com o Runtime AgentCore

  • Os fluxos são vinculados ao API Gateway WebSocket

  • Permite token-by-token a entrega de respostas aos clientes

  • Mantém a conexão para solicitações de longa duração

Restrições de processamento

O processamento do agente na v4.0.0 está limitado ao tempo limite de execução do Lambda:

  • Tempo máximo de processamento: 15 minutos

  • Modelo de processamento síncrono

  • Adequado para agentes conversacionais e fluxos de trabalho moderados

  • Suporte assíncrono estendido planejado para a versão 4.1+

Gerenciamento de memória

Memória de curto prazo

Ativado por padrão para todos os agentes usando um personalizado MemoryHookProvider:

  • Captura eventos de conversação por meio de manipuladores de retorno de chamada Strands

  • Organiza por ActorID e SessionID para isolamento de contexto

  • Mantém o contexto da conversa nas sessões

  • Integração automática com a AgentCore memória

Memória de longo prazo

Recurso opcional usando a Ferramenta AgentCore de Memória de strands_tools:

  • Simples alternância na interface do Agent Builder

  • Estratégia de memória semântica com configurações padrão

  • Acesso controlado por agente por meio da invocação natural de ferramentas

  • Armazena insights extraídos em todas as sessões

  • Usa ConversationID como SessionID

Observabilidade

OpenTelemetry Distribuição da AWS (ADOT)

Os agentes são instrumentados automaticamente durante a construção do contêiner:

  • Geração automática de rastreamento para operações de agentes

  • Rastreamento distribuído entre os limites do serviço

  • Registro estruturado com correlação IDs

  • Integração com a Pesquisa CloudWatch de Transações

Fluxo de autenticação

Os usuários se autenticam por meio do Amazon Cognito com tokens JWT validados por autorizadores personalizados do Lambda que recuperam políticas do IAM do DynamoDB com base em grupos de usuários.

Construtor de fluxo

O Workflow Builder permite a orquestração de vários agentes criando um agente supervisor que coordena vários agentes do Agent Builder usando o padrão de delegação Agents as Tools.

Arquitetura de fluxo de trabalho

Componentes-chave

  • Agente supervisor: agente de ponto de entrada que recebe solicitações de usuários e delega a agentes especializados

  • Agentes especializados: casos de uso do Agent Builder registrados como ferramentas para o supervisor

  • Registro do agente: tabela do DynamoDB que armazena configurações e metadados do agente

  • Camada de orquestração: implementação do Strands SDK do padrão Agents as Tools

Instanciação do agente

Criação de agente local

Todos os agentes especializados são instanciados localmente no mesmo AgentCore Runtime:

  1. Recupera as configurações do agente do DynamoDB

  2. Cria instâncias locais de cada agente do Agent Builder

  3. Cada agente mantém suas próprias conexões de servidor MCP

  4. Agente supervisor registra agentes especializados como ferramentas

  5. O Strands SDK gerencia a seleção e delegação de agentes