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
<a name="configuring-agent-builder"></a>

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
<a name="system-prompt-configuration"></a>

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

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

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

1. 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
<a name="mcp-server-integration"></a>

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

1. 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
<a name="memory-settings"></a>

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

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

1. 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
<a name="monitoring-agent-builder"></a>

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.

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

1. Encontre o painel chamado`AgentBuilder-<UseCaseId>`.

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

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

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

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