Testar e solucionar 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á.

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 integrar um agente do Amazon Bedrock na aplicação.

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.

  • 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 agente, o Amazon Bedrock Agents permite visualizar o rastreamento durante uma sessão com o agente. O rastreamento mostra o processo de step-by-step 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.

Veja as etapas a seguir para testar o agente. Escolha a guia do seu método preferido e siga as etapas:

Console
Como testar o agente

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

  2. No painel de navegação à esquerda, selecione Agentes. Escolha um agente na seção Agentes.

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

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

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

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

  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 throughput provisionado, selecione Alterar. Para obter mais informações, consulte Aumentar a capacidade de invocação do modelo com throughput provisionado no Amazon Bedrock.

  8. (Opcional) Para usar uma solicitação do Gerenciamento de solicitações, selecione o ícone de opções ( Vertical ellipsis icon representing a menu or more options. ) na caixa de mensagem e escolha Importar solicitação. Selecione o prompt e a versão. Insira valores para as variáveis do prompt na seção Valores das variáveis de teste. Para obter mais informações sobre prompts no gerenciamento de prompts, consulteConstruir e armazenar prompts reutilizáveis com o Gerenciamento de Prompts do Amazon Bedrock.

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

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

    É 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 AWS Management Console usando uma IAMfunção com as permissões do Amazon Bedrock e abra o console do Amazon Bedrock em. https://console.aws.amazon.com/bedrock/

  2. No painel de navegação à esquerda, selecione Agentes. Escolha um agente na seção Agentes.

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

  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 cujo estado você deseja alterar.

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

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

  8. Selecione Preparar para aplicar as alterações feitas 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 com um endpoint de tempo de construção do Agents for Amazon Bedrock. Inclua o agentId na solicitação. As alterações se aplicam à versão do DRAFT para a qual o alias do TSTALIASID aponta.

Consulte exemplos de código

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, 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 com um endpoint de tempo de execução do Agents for Amazon Bedrock.

nota

O AWS CLI não suporta InvokeAgent.

Consulte 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érico da sessão (de 2 a 100 caracteres)
    inputText O prompt do usuário a ser enviado ao agente

  • Os seguintes campos 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 esta solicitação.
    sessionState Inclui o contexto que influencia o comportamento do agente ou o comportamento das bases de conhecimento anexadas ao agente. Para obter mais informações, consulte Controlar o contexto da sessão do agente.

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. Se o agente consultou uma base de conhecimento, o chunk também incluirá citations. Os seguintes objetos também podem ser exibidos:

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

  • Se você configurar seu grupo de ação para pular usando uma função Lambda, ReturnControlPayloadum objeto será retornado no returnControl campo. A estrutura geral do ReturnControlPayloadobjeto é a seguinte:

    {
    "invocationId": "string",
    "invocationInputs": [
        ApiInvocationInput or FunctionInvocationInput,
        ...
    ]
}

    Cada membro da lista invocationInputs é um dos seguintes:

    • Um ApiInvocationInputobjeto contendo a API operação 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 ele obtém do usuário para cumprir o. API A estrutura do objeto ApiInvocationInput é descrita assim:

      {
    "actionGroup": "string",
    "apiPath": "string",
    "httpMethod": "string",
    "parameters": [
        {
            "name": "string",
            "type": "string",
            "value": "string"
        },
        ...
    ],
    "requestBody": {
        <content-type>: {
            "properties": [
                {
                    "name": "string",
                    "type": "string",
                    "value": "string"
                }
            ]
        }
    }
}

    • Um FunctionInvocationInputobjeto contendo 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 ele obtém do usuário. A estrutura do FunctionInvocationInputé a seguinte:

      {
    "actionGroup": "string",
    "function": "string",
    "parameters": [
        {
            "name": "string",
            "type": "string",
            "value": "string"
        }
    ]
}