Teste e solucione problemas de comportamento do agente - Amazon Bedrock

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

Teste e solucione problemas de comportamento do agente

Depois de criar um agente, você terá um rascunho de trabalho. O rascunho de trabalho é uma versão do agente que você pode usar para criar o agente de forma iterativa. Cada vez que você faz alterações em seu agente, o rascunho de trabalho é atualizado. Quando estiver satisfeito com as configurações do seu agente, você pode criar uma versão, que é um instantâneo do seu agente, e um alias, que aponta para a versão. Em seguida, você pode implantar seu agente em seus aplicativos chamando o alias. Para obter mais informações, consulte Implemente e integre um agente Amazon Bedrock em seu aplicativo.

A lista a seguir descreve como você testa seu agente:

  • No console do Amazon Bedrock, você abre a janela de teste ao lado e envia informações para que seu agente responda. Você pode selecionar o rascunho de trabalho ou uma versão que você criou.

  • NoAPI, o rascunho de trabalho é a DRAFT versão. Você envia informações ao seu agente usando InvokeAgentcom o alias de teste,TSTALIASID, ou um alias diferente apontando para uma versão estática.

Para ajudar a solucionar problemas de comportamento do seu agente, o Amazon Bedrock Agents oferece a capacidade de visualizar o rastreamento durante uma sessão com seu agente. O rastreamento mostra o processo de step-by-step raciocínio do agente. Para obter mais informações sobre o rastreamento, consulteRastreie o processo de step-by-step raciocínio do agente usando trace.

A seguir estão as etapas para testar seu agente. Selecione a guia correspondente ao seu método de escolha e siga as etapas.

Console
Para testar um agente

  1. Faça login no AWS Management Console usando uma IAMfunção com permissões do Amazon Bedrock e abra o console do Amazon Bedrock em. https://console.aws.amazon.com/bedrock/

  2. Selecione Agentes no painel de navegação esquerdo. Em seguida, escolha um agente na seção Agentes.

  3. Na seção Agentes, selecione o link do agente que você deseja testar na lista de agentes.

  4. A janela Teste aparece em um painel à direita.

    nota

    Se a janela Teste estiver fechada, você poderá reabri-la selecionando Teste na parte superior da página de detalhes do agente ou em qualquer página dentro dela.

  5. Depois de criar um agente, você deve empacotá-lo com as alterações preliminares 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ê atualiza o rascunho de trabalho, você deve preparar o agente para empacotar o agente com suas alterações mais recentes. Como prática recomendada, recomendamos que você sempre verifique a última hora de preparação do agente na seção Visão geral do agente na página de rascunho de trabalho para verificar se está testando seu agente com as configurações mais recentes.

  6. Para escolher um alias e uma versão associada para testar, use o menu suspenso na parte superior da janela Teste. Por padrão, a combinação TestAlias: Rascunho de trabalho é selecionada.

  7. (Opcional) Para selecionar a taxa de transferência provisionada para seu alias, o texto abaixo do alias de teste selecionado indicará Usando ou Usando PT. ODT Para criar um modelo de taxa de transferência provisionada, selecione Alterar. Para obter mais informações, consulte Aumente a capacidade de invocação do modelo com a taxa de transferência provisionada no Amazon Bedrock.

  8. Para testar o agente, digite uma mensagem e escolha Executar. Enquanto você espera a resposta ser gerada ou depois de gerada, 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 para cada etapa e o uso de seus grupos de ação e bases de conhecimento, selecione Mostrar rastreamento. O rastreamento é atualizado em tempo real para que você possa visualizá-lo antes que a resposta seja retornada. Para expandir ou reduzir o traçado de uma etapa, selecione uma seta ao lado de uma etapa. Para obter mais informações sobre a janela Trace e os detalhes que aparecem, consulteRastreie o processo de step-by-step raciocínio do agente usando trace.

    • Se o agente invocar uma base de conhecimento, a resposta conterá notas de rodapé. Para visualizar o link para o objeto S3 contendo as informações citadas para uma parte específica da resposta, selecione a nota de rodapé relevante.

    • Se você configurar seu agente para retornar o controle em vez de usar uma função Lambda para lidar com o grupo de ação, a resposta conterá a ação prevista e seus parâmetros. Forneça um exemplo de valor de saída da função API or 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.

    Você pode realizar as seguintes ações na janela Teste:

    • Para iniciar uma nova conversa com o agente, selecione o ícone de atualização.

    • Para visualizar a janela Trace, selecione o ícone de expansão. Para fechar a janela Trace, selecione o ícone de redução.

    • Para fechar a janela Teste, selecione o ícone de seta para a direita.

Você pode ativar ou desativar grupos de ação e bases de conhecimento. Use esse recurso para solucionar problemas do seu agente, isolando quais grupos de ação ou bases de conhecimento precisam ser atualizados, avaliando seu comportamento com diferentes configurações.

Para habilitar um grupo de ação ou base de conhecimento

  1. Faça login no AWS Management Console usando uma IAMfunção com permissões do Amazon Bedrock e abra o console do Amazon Bedrock em. https://console.aws.amazon.com/bedrock/

  2. Selecione Agentes no painel de navegação esquerdo. Em seguida, escolha um agente na seção Agentes.

  3. Na seção Agentes, selecione o link do agente que você deseja testar na lista de agentes.

  4. Na página de detalhes do agente, na seção Rascunho de trabalho, selecione o link para o rascunho de trabalho.

  5. Na seção Grupos de ação ou Bases de conhecimento, passe o mouse sobre o Estado do grupo de ação ou da base de conhecimento cujo estado você deseja alterar.

  6. Um botão de edição é exibido. Selecione o ícone de edição e, em seguida, escolha no menu suspenso se o grupo de ação ou a base de conhecimento estão ativados ou desativados.

  7. Se um grupo de ação estiver desativado, o agente não usará o grupo de ação. Se uma base de conhecimento estiver desativada, o agente não a usará. Ative ou desative grupos de ação ou bases de conhecimento e, em seguida, use a janela Teste para solucionar problemas com seu agente.

  8. Escolha Preparar para aplicar as alterações que você fez no agente antes de testá-lo.

API

Antes de testar seu agente pela primeira vez, você deve empacotá-lo com as alterações preliminares enviando um PrepareAgentsolicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de construção do Agents for Amazon Bedrock. Inclua o agentId na solicitação. As alterações se aplicam à DRAFT versão para a qual o TSTALIASID alias aponta.

Veja exemplos de código

nota

Toda vez que você atualiza o rascunho de trabalho, você deve preparar o agente para empacotar o agente com suas alterações mais recentes. Como prática recomendada, recomendamos que você envie um GetAgentsolicite (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de construção do Agents for Amazon Bedrock e verifique o preparedAt horário em que seu agente pode verificar se você está testando seu agente com as configurações mais recentes.

Para testar seu agente, envie um InvokeAgentsolicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de execução do Agents for Amazon Bedrock.

nota

A ferramenta AWS CLI não suporta InvokeAgent.

Veja exemplos de código

Os seguintes campos existem na solicitação:

  • No mínimo, forneça os seguintes campos obrigatórios:

    Campo Descrição breve
    agentId ID do agente
    agentAliasId ID do alias. Use TSTALIASID para invocar a versão DRAFT
    sessionId ID alfanumérica da sessão (2 a 100 caracteres)
    inputText A solicitação do usuário para enviar ao agente

  • Os campos a seguir são opcionais:

    Campo Descrição breve
    enableTrace Especifique TRUE para visualizar o rastreamento.
    endSession Especifique TRUE para encerrar a sessão com o agente após essa solicitação.
    sessionState Inclui contexto que influencia o comportamento do agente ou o comportamento das bases de conhecimento vinculadas ao agente. Para obter mais informações, consulte Contexto da sessão do agente de controle.

A resposta é retornada em um fluxo de eventos. Cada evento contém umchunk, que contém parte da resposta no bytes campo, que deve ser decodificada. Se o agente consultou uma base de conhecimento, isso chunk também incluicitations. Os seguintes objetos também podem ser retornados: