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.

Pré-requisitos

• Um agente criado com a infraestrutura do GitHub Copilot
• Ao menos uma conversa de teste na guia Prévia

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 rastro de atividades exibe uma visualização do raciocínio em cadeia (CoT) do processamento realizado pelo 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:

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 tenha falhado, consulte 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 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 chamadas de ferramenta de longa duração
   • Indicadores de moderação de conteúdo

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

Navegue do rastreio até a aba Build

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.

Informações relacionadas

• Visualizar e testar um agente
• Testar um agente
• Compartilhe seu agente com outras pessoas
• Gerenciar conversas de pré-visualização
• Monitore um agente