View a markdown version of this page

Configurando o Agent Builder - Criador de aplicações de IA generativa na AWS
Configuração do prompt do sistemaIntegração de servidor MCPMemory SettingsMonitorando implantações do Agent Builder

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á.

Configurando o Agent Builder

O Agent Builder fornece opções de configuração abrangentes para criar agentes de IA prontos para produção. Esta seção descreve como configurar e gerenciar as implantações do Agent Builder.

Configuração do prompt do sistema

O prompt do sistema define o comportamento, a personalidade e as capacidades do seu agente. Para configurar o prompt do sistema:

  1. No assistente do Agent Builder, navegue até a etapa Configurar agente.

  2. Edite o modelo de prompt do sistema no editor de texto.

  3. Inclua instruções claras para:

    • Papel e propósito do agente

    • Como usar as ferramentas disponíveis (servidores MCP)

    • Preferências de formatação de resposta

    • Diretrizes comportamentais

  4. Use o botão Redefinir para o padrão para restaurar o modelo original, se necessário.

Práticas recomendadas para solicitações de agentes:

  • Seja específico sobre as capacidades e limitações do agente

  • Forneça exemplos claros do comportamento desejado

  • Inclua instruções para o uso da ferramenta e quando invocá-las

  • Defina as expectativas do formato de resposta

  • Estabeleça limites para o comportamento do agente

Integração de servidor MCP

Os servidores Model Context Protocol (MCP) fornecem aos agentes acesso a ferramentas corporativas e fontes de dados. Para configurar servidores MCP:

  1. Na etapa Configurar Agente, localize a seção Servidores MCP.

  2. Selecione entre os servidores MCP disponíveis no menu suspenso.

nota

Os servidores MCP devem estar configurados e acessíveis antes da implantação do agente. O agente descobrirá e usará automaticamente as ferramentas expostas pelos servidores MCP configurados. Consulte a documentação do MCP para obter informações sobre a configuração do servidor e da ferramenta.

Memory Settings

O Agent Builder fornece dois tipos de memória para manter o contexto e o conhecimento:

Memória de curto prazo

Ativado por padrão para todos os agentes:

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

  • Captura automaticamente as mensagens do usuário e as respostas do agente

  • Organizado por ActorID e SessionID para isolamento adequado

  • Nenhuma configuração é necessária

Memória de longo prazo

Recurso opcional para armazenar insights em todas as sessões:

  1. Na etapa Configurar agente, localize a seção Configuração de memória.

  2. Alterne a opção Ativar memória de longo prazo para ativar.

  3. Quando ativado, o agente pode:

    • Extraia e armazene informações importantes em todas as conversas

    • Recupere o contexto relevante de sessões anteriores

    • Desenvolva conhecimento sobre as preferências e o histórico do usuário

nota

A memória de longo prazo usa AgentCore Memória com estratégia de memória semântica e configurações de retenção padrão.

Monitorando implantações do Agent Builder

O Agent Builder fornece monitoramento abrangente por meio de CloudWatch painéis e métricas.

Acessando CloudWatch painéis

  1. Navegue até o CloudWatch console em sua conta da AWS.

  2. Selecione Painéis na navegação à esquerda.

  3. Encontre o painel chamadoAgentBuilder-<UseCaseId>.

  4. Visualize métricas em tempo real e dados históricos de desempenho.

Acesso e análise de registros

Os registros do agente estão disponíveis em CloudWatch Registros:

  1. Navegue até CloudWatch Logs no console da AWS.

  2. Encontre grupos de registros prefixados com/aws/bedrock-agentcore/runtimes/.

  3. Use o CloudWatch Insights para consultar e analisar registros.

  4. Pesquise padrões específicos de solicitação IDs ou erro.