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á.
# Testar e solucionar problemas de comportamento do agente
Após criar um agente, você terá um *rascunho de trabalho*. O rascunho de trabalho é uma versão do agente que é possível usar para compilar o agente de forma iterativa. Cada vez que você faz alterações no agente, o rascunho de trabalho é atualizado. Quando as configurações do agente estiverem adequadas, você poderá criar uma *versão*, que é um snapshot do agente, e um *alias*, que aponta para a versão. É possível implantar o agente nas aplicações chamando o alias. Para obter mais informações, consulte [Implantar e usar um agente do Amazon Bedrock na aplicação](agents-deploy.md).
A seguinte lista descreve como testar o agente:
+ No console do Amazon Bedrock, abra a janela de teste na lateral e envie entrada para que o agente responda. É possível selecionar o rascunho de trabalho ou uma versão que você criou.
+ Na API, o rascunho de trabalho é a versão do `DRAFT`. Envie a entrada ao agente usando [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) com o alias de teste, `TSTALIASID` ou um alias diferente que aponta para uma versão estática. Antes de testar o agente, você deve prepará-lo chamando [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html).
## Rastrear o comportamento do agente
Para ajudar a solucionar problemas de comportamento do agente, o Amazon Bedrock Agents permite visualizar o *rastreamento* durante uma sessão com o agente. O rastreamento mostra o processo passo a passo do raciocínio do agente. Para obter mais informações sobre o rastreamento, consulte [Rastreie o processo de step-by-step raciocínio do agente usando trace](trace-events.md).
## Testar o agente
Veja as etapas a seguir para testar o agente. Escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como testar o agente**
1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console do Amazon Bedrock. Em seguida, abra o console do Amazon Bedrock em [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).
1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**.
1. Na seção **Agentes**, selecione o link do agente que você deseja testar na respectiva lista.
1. A janela **Teste** é exibida em um painel à direita.
**nota**
Se a **Janela de teste** estiver fechada, será possível reabri-la selecionando **Teste** na parte superior da página de detalhes do agente ou em qualquer página dentro dela.
1. Depois de criar um agente, empacote-o com as alterações do rascunho de trabalho preparando-o de uma das seguintes formas:
+ Na janela **Teste**, selecione **Preparar**.
+ Na página **Rascunho de trabalho**, selecione **Preparar** na parte superior da página.
**nota**
Toda vez que você atualizar o rascunho de trabalho, deverá preparar o agente para empacotá-lo com as alterações mais recentes. Uma prática recomendada é sempre verificar o horário da **Última preparação** do agente na seção **Visão geral do agente** na página **Rascunho de trabalho** para verificar se você está testando o agente com as configurações mais recentes.
1. Para escolher um alias e a versão associada para o teste, use o menu suspenso na parte superior da **Janela de teste**. Por padrão, a combinação **TestAlias: Rascunho de trabalho** é selecionada.
1. (Opcional) Para selecionar o throughput provisionado para o alias, o texto abaixo do alias de teste selecionado indicará **Usando ODT** ou **Usando PT**. Para criar um modelo de throughput provisionado, selecione **Alterar**. Para obter mais informações, consulte [Aumentar a capacidade de invocação do modelo com throughput provisionado no Amazon Bedrock](prov-throughput.md).
1. (Opcional) Para usar um prompt do Gerenciamento de Prompts, selecione o ícone de opções (![\[Vertical ellipsis icon representing a menu or more options.\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/images/icons/vertical-ellipsis.png)) na caixa de mensagem e escolha **Importar prompt**. Selecione o prompt e a versão. Insira valores para as variáveis do prompt na seção **Testar valores de variáveis**. Para ter mais informações sobre prompts no Gerenciamento de Prompts, consulte [Construir e armazenar prompts reutilizáveis com o Gerenciamento de Prompts do Amazon Bedrock](prompt-management.md).
1. Para testar o agente, digite uma mensagem e escolha **Executar**. Enquanto aguarda a geração da resposta ou depois de geração, você tem as seguintes opções:
+ Para ver os detalhes de cada etapa do processo de orquestração do agente, incluindo o prompt, as configurações de inferência e o processo de raciocínio do agente em cada etapa e uso dos grupos de ação e bases de conhecimento, selecione **Mostrar rastreamento**. O rastreamento é atualizado em tempo real para que seja possível visualizá-lo antes que a resposta seja apresentada. Para expandir ou reduzir o rastreamento dessa etapa, selecione uma seta ao lado de uma etapa. Para obter mais informações sobre a janela **Rastreamento** e os detalhes exibidos, consulte [Rastreie o processo de step-by-step raciocínio do agente usando trace](trace-events.md).
+ Se o agente invocar uma base de conhecimento, a resposta conterá notas de rodapé. Para visualizar o link para o objeto do S3 que contém as informações citadas em uma parte específica da resposta, selecione a nota de rodapé relevante.
+ Se você configurar o agente para retornar o controle, em vez de usar uma função do Lambda para lidar com o grupo de ação, a resposta conterá a ação prevista e os respectivos parâmetros. Forneça um exemplo de valor de saída da API ou da função para a ação e escolha **Enviar** para gerar uma resposta do agente. Para obter um exemplo, veja a imagem a seguir.
![\[Solicitação de janela de teste para fornecer um exemplo de saída para a ação.\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/images/agents/roc-testwindow.png)
É possível executar as ações a seguir na janela **Teste**.
+ Para iniciar uma nova conversa com o agente, selecione o ícone de atualização.
+ Para visualizar a janela **Rastreamento**, selecione o ícone de expansão. Para fechar a janela **Rastreamento**, selecione o ícone de redução.
+ Para fechar a janela **Teste**, selecione o ícone de seta para a direita.
É possível habilitar ou desabilitar grupos de ação e bases de conhecimento. Use esse recurso para solucionar problemas do agente. Para isso, isole grupos de ação ou bases de conhecimento que precisam ser atualizados avaliando seu comportamento com diferentes configurações.
**Como habilitar um grupo de ação ou uma base de conhecimento**
1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console do Amazon Bedrock. Em seguida, abra o console do Amazon Bedrock em [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).
1. No painel de navegação à esquerda, selecione **Agentes**. Escolha um agente na seção **Agentes**.
1. Na seção **Agentes**, selecione o link do agente que você deseja testar na respectiva lista.
1. Na página de detalhes do agente, na seção **Rascunho de trabalho**, selecione o link para o **Rascunho de trabalho**.
1. Na seção **Grupos de ação** ou **Bases de conhecimento**, passe o mouse sobre o **Estado** do grupo de ação cujo estado você deseja alterar.
1. Um botão de edição é exibido. Selecione o ícone de edição e escolha no menu suspenso se o grupo de ação ou a base de conhecimento está **Habilitado** ou **Desabilitado**.
1. Se um grupo de ação estiver **Desabilitado**, o agente não o usará. Se uma base de conhecimento estiver **Desabilitada**, o agente não a usará. Habilite ou desabilite grupos de ação ou bases de conhecimento e use a janela **Teste** para solucionar problemas do agente.
1. Selecione **Preparar** para aplicar as alterações feitas no agente antes de testá-lo.
------
#### [ API ]
Para agentes criados `after` 31 de março de 2025:
+ Se você criou seu agente no console, o streaming está habilitado por padrão. Você pode desabilitar o streaming a qualquer momento.
+ Observe que o perfil de execução do agente deve incluir a permissão `bedrock:InvokeModelWithResponseStream` para o modelo de agente configurado.
Antes de testar o agente pela primeira vez, você deve empacotá-lo com as alterações no rascunho de trabalho enviando uma solicitação [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Inclua o `agentId` na solicitação. As alterações se aplicam à versão do `DRAFT` para a qual o alias do `TSTALIASID` aponta.
```
def prepare_agent(self, agent_id):
"""
Creates a DRAFT version of the agent that can be used for internal testing.
:param agent_id: The unique identifier of the agent to prepare.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
prepared_agent_details = self.client.prepare_agent(agentId=agent_id)
except ClientError as e:
logger.error(f"Couldn't prepare agent. {e}")
raise
else:
return prepared_agent_details
```
Para obter mais informações, consulte [Olá, agentes do Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
**nota**
Toda vez que você atualizar o rascunho de trabalho, deverá preparar o agente para empacotá-lo com as alterações mais recentes. Como prática recomendada, envie uma solicitação [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgent.html) (consulte o link para obter os formatos de solicitação e de resposta e os detalhes do campo) com um [endpoint de tempo de compilação do Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e verifique o horário `preparedAt` para que o agente verifique se você está testando o agente com as configurações mais recentes.
Para testar o agente, envie uma solicitação [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) ao agente. Para obter um código de exemplo, consulte [Invocar um agente por meio de sua aplicação](agents-invoke-agent.md).
**nota**
A AWS CLI não oferece suporte ao [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html).
Os seguintes campos existem na solicitação:
+ No mínimo, forneça os seguintes campos obrigatórios:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/agents-test.html)
+ Os seguintes campos são opcionais:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/agents-test.html)
A resposta é apresentada em um fluxo de eventos. Cada evento contém um `chunk`, que contém parte da resposta no campo `bytes`, que deve ser decodificado. Os seguintes objetos também podem ser exibidos:
+ Se o agente consultou uma base de conhecimento, o `chunk` também incluirá `citations`.
+ Se o streaming estiver habilitado e o barreira de proteção estiver configurada para o agente, a resposta será gerada nos intervalos de caracteres especificados para o intervalo da barreira de proteção. Por padrão, o intervalo é definido como cinquenta caracteres.
+ Se você habilitou um rastreamento, um objeto `trace` também será exibido. Se ocorrer um erro, um campo será exibido com a mensagem de erro. Para obter mais informações sobre como ler o rastreamento, consulte [Rastreie o processo de step-by-step raciocínio do agente usando trace](trace-events.md).
+ Se você configurar o grupo de ação para ignorar o uso de uma função do Lambda, um objeto [ReturnControlPayload](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ReturnControlPayload.html) será exibido no campo `returnControl`. A estrutura geral do objeto [ReturnControlPayload](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ReturnControlPayload.html) é a seguinte:
```
{
"invocationId": "string",
"invocationInputs": [
[ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html) or [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html),
...
]
}
```
Cada membro da lista `invocationInputs` é um dos seguintes:
+ Um objeto [ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html) que contém a operação de API que o agente prevê que deve ser chamada com base na entrada do usuário, além dos parâmetros e outras informações que obtém do usuário para atender à API. A estrutura do objeto [ApiInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ApiInvocationInput.html) é descrita a seguir.
```
{
"actionGroup": "string",
"apiPath": "string",
"httpMethod": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
},
...
],
"requestBody": {
: {
"properties": [
{
"name": "string",
"type": "string",
"value": "string"
}
]
}
}
}
```
+ Um objeto [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html) que contém a função que o agente prevê que deve ser chamada com base na entrada do usuário, além dos parâmetros dessa função que obtém do usuário. A estrutura da [FunctionInvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FunctionInvocationInput.html) é a seguinte:
```
{
"actionGroup": "string",
"function": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
}
]
}
```
------