Use o rastreamento de atividade para depurar seu agente

O rastreamento de atividade nos agentes, alimentado pelo chicote GitHub Copilot no Microsoft Copilot Studio, mostra exatamente como seu agente processa cada mensagem. Use-o para compreender o raciocínio do seu agente, verificar a atribuição das fontes de conhecimento, confirmar a execução das ferramentas e solucionar erros.

Note

Os recursos deste artigo são alimentados pelo chicote GitHub Copilot, que utiliza os Créditos Copilot para faturamento baseado no uso. Saiba mais sobre os Créditos Copilot na visão geral de faturamento para agentes alimentados pelo GitHub Copilot harness.

A cobrança baseada no uso se aplica ao uso, construção, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot.

Pré-requisitos

  • Um agente criado com o chicote GitHub Copilot
  • Pelo menos uma conversa de teste na guia Versão Preliminar

Abrir o rastreamento de atividades

  1. Abra o agente no Copilot Studio e selecione a guia Versão Preliminar.

  2. Certifique-se de que a opção Versão preliminar do usuário final esteja desativada (a visualização padrão do criador). O rastreamento de atividades aparece ao lado do painel de bate-papo, mostrando os detalhes do processamento de cada mensagem.

  3. Envie uma mensagem para o agente. O rastreamento se atualiza em tempo real à medida que o agente processa a mensagem.

Entender o rastreamento

O rastreamento de atividades exibe uma visualização da cadeia de raciocínio (CoT) do processamento do seu agente. Cada etapa do rastreamento aparece como um nó que mostra o que o agente fez e por que.

Tipo de nó

O rastreamento pode incluir os seguintes tipos de nós:

Tipo de nó O que ele mostra
Mensagem do usuário A mensagem que você enviou para o agente
Resposta do agente A resposta gerada pelo agente
Conhecimento Uma fonte de conhecimento que o agente consultou para fundamentação. Exibido como um cartão expansível "Conhecimento pesquisado", mostrando as fontes para cada fonte de conhecimento acessada e links de citação, quando disponíveis.
Ação executada Uma invocação de conector ou ferramenta exibida como um cartão recolhível que mostra o conector, os parâmetros de entrada preenchidos e a duração da entrega
Ferramenta Uma ferramenta que o agente invocou para realizar uma ação ou recuperar dados
Connector Um conector que o agente usou para acessar dados externos
Fluxo Um fluxo de agente que foi ativado
Habilidade Uma habilidade que foi executada
Error Ocorreu um erro durante o processamento
Concluído Um indicador de marca de seleção verde exibido na parte inferior do rastreamento quando todas as chamadas de ferramentas forem concluídas

Exibir detalhes do nó

  1. Selecione qualquer nó no rastreamento para expandir os detalhes.

  2. Verifique as informações exibidas, que podem incluir:

    • A entrada enviada pelo agente para a etapa
    • A saída ou resultado retornado
    • Tempo de processamento e métricas
    • Detalhes do erro caso o passo falhe

Depurar problemas relacionados à fonte de conhecimento

Quando seu agente utiliza conhecimentos para responder a uma pergunta, o histórico mostra quais fontes foram consultadas:

  1. Encontre o nó Conhecimento no rastreamento.

  2. Consulte a fonte para ver quais fontes de conhecimento foram acessadas.

  3. Selecione uma fonte para ver o conteúdo específico recuperado.

  4. Verifique se o agente usou a fonte correta e se o conteúdo recuperado é relevante.

Se o agente usou a fonte errada ou retornou informações incorretas, verifique sua configuração de conhecimento na guia Criar.

Execução da ferramenta de depuração

Quando o seu agente invoca uma ferramenta, o rastreamento mostra os detalhes da execução:

  1. Localize o nó Ferramenta, Conector, Fluxo ou Habilidade no rastreamento.

  2. Revise os detalhes da execução, incluindo os parâmetros de entrada e os resultados de saída.

  3. Verifique se a ferramenta correta foi invocada e se os resultados estão conforme o esperado.

  4. Caso a execução da ferramenta falhe, revise os detalhes do erro no nó.

Para reconfigurar uma ferramenta, abra a guia Criar e localize a ferramenta na configuração do seu agente.

Solucionar erros

Quando ocorrem erros durante o processamento, o rastreamento os destaca:

  1. Procure por nós marcados com um indicador de erro no rastreamento.

  2. Selecione o nó de erro para visualizar os detalhes do erro, incluindo a mensagem de erro e o contexto.

  3. Os problemas comuns incluem:

    • Falhas de autenticação para ferramentas ou conectores
    • Erros de acesso à fonte de conhecimento
    • Erros de tempo limite em execuções prolongadas de ferramentas
    • Indicadores de moderação de conteúdo

  4. Aborde a causa raiz na guia Criar ou Configurações, depois teste novamente.

O rastreamento de atividades se integra com a guia Criar para edição rápida.

  1. Selecione qualquer fonte, ferramenta ou componente no rastreamento.

  2. O Copilot Studio vai para o componente correspondente na guia Criar.

  3. Faça suas alterações e volte para a guia Versão preliminar para realizar um novo teste.

  • Last updated on