Use o rastreio de atividade para depurar o seu agente

O rastreio de atividade nos agentes, alimentado pelo harness GitHub Copilot no Microsoft Copilot Studio, mostra-lhe exatamente como o seu agente processa cada mensagem. Utilize-o para compreender a cadeia de pensamento do seu agente, verificar a atribuição das fontes de conhecimento, confirmar a execução das ferramentas e resolver problemas.

Pré-requisitos

• Um agente criado com o arnês GitHub Copilot
• Pelo menos uma conversa de teste no separador Pré-visualização

Abrir o rastreio de atividades

1. Abra o seu agente no Copilot Studio e selecione o separador Pré-visualização.

2. Certifique-se de que a opção Pré-visualização do utilizador final está desativada (a vista predefinida de criador). O registo de atividade aparece ao lado do painel de conversação, mostrando os detalhes do processamento de cada mensagem.

3. Envie uma mensagem ao seu agente. O rastreio atualiza-se em tempo real à medida que o agente processa a mensagem.

Compreenda o rasto

O rastreio de atividades apresenta uma vista da cadeia de pensamento (CoT) do processamento do seu agente. Cada passo no rastreio aparece como um nó que mostra o que o agente fez e porquê.

Tipos de nó

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

Ver detalhes do nó

1. Selecione qualquer nó do rastreio para expandir os detalhes.

2. Reveja as informações apresentadas, que podem incluir:

   • Os dados de entrada que o agente enviou para o passo
   • A saída ou o resultado devolvido
   • Tempo de processamento e métricas
   • Detalhes do erro se o passo falhou

Resolver problemas da origem de conhecimento

Quando o seu agente utiliza conhecimento para responder a uma pergunta, o rastreio mostra quais as fontes consultadas:

1. Encontre o nó Conhecimento no rastreio.

2. Reveja a fonte para ver quais fontes de conhecimento foram acedidas.

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

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

Se o agente utilizou a fonte incorreta ou devolveu informações imprecisas, verifique a sua configuração de conhecimento no separador Criar.

Depuração da execução da ferramenta

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

1. Encontre o nó Ferramenta, Conector, Fluxo ou Competência no rastreio.

2. Reveja 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 que os resultados são os esperados.

4. Se a execução de uma ferramenta falhar, verifique os detalhes do erro no nó.

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

Solucionar erros

Quando ocorrem erros durante o processamento, o rastreio destaca-os:

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

2. Selecione o nó de erro para ver 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 ferramentas de longa duração
   • Sinalizadores de moderação de conteúdo

4. Corrija a causa raiz no separador Criar ou em Definições, em seguida, volte a testar.

Navegue de trace até ao separador Build

O rastreio de atividades está integrado no separador Criar para edição imediata.

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

2. O Copilot Studio direciona-o para o componente correspondente no separador Criar.

3. Faça as suas alterações e volte ao separador Pré-visualização para testar novamente.

Informações relacionadas

• Pré-visualizar e testar um agente
• Testar um agente
• Partilha o teu agente com outros
• Gerir conversas de pré-visualização
• Monitorizar um agente