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.

Note

As funcionalidades deste artigo são alimentadas pelo chicote GitHub Copilot, que utiliza Créditos Copilot para faturação baseada na utilização. Saiba mais sobre os Créditos Copilot na Visão Geral da faturação para agentes alimentados pelo arnês GitHub Copilot.

A faturação baseada no uso aplica-se à utilização, construção, teste e avaliação de agentes. Estas ações podem consumir Créditos Copilot.

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 rastreio de atividades aparece ao lado do painel de chat, a mostrar informações de processamento para 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:

Tipo de nó O que mostra
Mensagem do utilizador A mensagem enviada ao agente
Resposta do agente A resposta gerada pelo agente
Conhecimento Uma fonte de conhecimento que o agente consultou para fundamentação. Composto como um cartão fechável de "Conhecimento pesquisado" que mostra as fontes de cada fonte de conhecimento acedida e ligações para citações, quando disponíveis.
Ação executada Uma invocação de conector ou ferramenta composta como um cartão fechável que mostra o conector, os parâmetros de entrada preenchidos e a duração de entrega
Tool Uma ferramenta invocada pelo agente para realizar uma ação ou obter dados
Conector Um conector que o agente utilizou para aceder a dados externos
Fluxo Um fluxo de agente que foi acionado
Competência Uma competência que foi executada
Error Um erro que ocorreu durante o processamento
Concluído Uma marca de verificação verde é mostrada na parte inferior do rastreio quando todas as chamadas de ferramenta foram concluídas.

Ver detalhes do nó

  1. Selecione qualquer nó no rastreio para expandir os seus detalhes.

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

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

Problemas com a depuração da fonte 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 de ferramentas

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

  1. Encontre o nó de Ferramenta, de Conector, de Fluxo ou de 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. Caso a execução de uma ferramenta falhe, 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 longa duração de ferramentas
    • Sinalizadores de moderação de conteúdo

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

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.

  • Last updated on