Revisar atividade do agente

A criação de um agente é um processo iterativo. Isso envolve o reconhecimento de como os agentes trabalham, fazem alterações e veem os resultados que permitem a você criar agentes melhores. O acompanhamento de atividades do Copilot Studio oferece um mapeamento visual da sequência de entradas, decisões e saídas dos agentes em uma sessão, de maneira que você possa encontrar problemas e oportunidades de melhoria.

Um mapa de atividade é gerado para cada sessão, que começa quando um agente inicia uma conversa ou um evento externo dispara um agente. Um mapa representa cada atividade com um nó .

Há duas formas de rastreamento de atividade:

• Mapa de atividades em tempo real do desempenho do agente durante os testes
• Mapas de atividades e transcrições históricas de sessões anteriores

Mapa de atividade em tempo real durante o teste

Quando você faz uma pergunta ao agente no painel de teste, o mapa de atividades mostra uma representação visual do plano que foi gerado. O mapa realça erros, como parâmetros de entrada ou saída não encontrados ou inválidos para ações, e mostra quanto tempo cada etapa leva para ser executada. Você também pode verificar se as informações que seu agente está enviando ou recebendo estão corretas.

Para fazer o mapa de atividades aparecer automaticamente quando você enviar uma consulta ao seu agente no painel de teste, selecione os três pontos (...) e então ative Mostrar mapa de atividade durante o teste.

Aqui, o usuário perguntou: "Como vai estar o clima em Toronto, no Canadá, amanhã?" Você pode ver a ação selecionada para responder, além das entradas e saídas.

Testando gatilhos de eventos

Ao testar gatilhos de eventos, a carga útil do gatilho aparece como uma mensagem no chat de teste. Esta mensagem só permanece visível dentro do Copilot Studio, para fins de teste. Não fica visível para os usuários do seu agente. Você pode usar as mensagens de payload para entender quando e quais informações e instruções um gatilho envia ao seu agente.

Acompanhamento entre tópicos

Quando você testa o agente, a opção de rastrear entre tópicos está disponível. Com o rastreamento habilitado, quando um tópico é acionado como parte de um plano, os nós dentro do tópico aparecem no mapa de atividades à medida que são executados, permitindo monitorar o fluxo da conversa.

Atividade histórica

Sempre que um agente inicia uma sessão, inclusive sessões de teste iniciadas no Copilot Studio, a atividade é registrada na página Atividade em tempo real. Vá até a página Atividade para:

• Revise as interações e as decisões que seu agente tomou durante uma sessão
• Descubra onde o comportamento do agente não corresponde aos seus objetivos
• Veja quanto tempo o agente leva para concluir cada atividade
• Encontrar detalhes do erro

A atividade do agente histórica está disponível para:

• Interações no chat de teste do Copilot Studio
• Agente publicado no canal do Microsoft Teams
• Sessões que começaram com um gatilho autônomo

Vá para a página Atividade para revisar:

• A lista de sessões e seus detalhes
• A atividade passo a passo que aconteceu em uma sessão

Lista de sessões

Uma sessão é uma unidade de interação do agente que envolve uma conversa com um usuário, o registro e a resposta a eventos ou uma combinação dessas atividades.

Na lista de sessões, você pode ver:

• Nome: o nome do usuário que interage com o agente. Se a sessão não envolveu um usuário, como quando um agente realiza ações sem aviso humano, o usuário é exibido como Automatizado.
• Canais: o canal no qual a interação ocorreu. As sessões que aconteceram no painel de testes do agente têm o ícone do Copilot Studio.
• Data: quando começou a primeira interação da sessão.
• Etapas concluídas: os números de etapas que o agente concluiu durante a sessão.
• Última etapa: a etapa final concluída na sessão.
• Status: o status da sessão (bem-sucedido, falha, em andamento).

Personalize a exibição da tabela Activity

Você pode personalizar a exibição da tabela Activity para se concentrar nas informações mais relevantes para você.

Para personalizar a exibição da tabela de atividades:

1. Vá até a página Atividade do agente. Uma lista das sessões de atividade é exibida.
2. Selecione Editar colunas. O painel Editar colunas é exibido com uma lista de colunas disponíveis.
3. No painel Editar colunas:
   • Marque a caixa de seleção ao lado do nome das colunas que você deseja mostrar.
   • Desmarque a caixa de seleção ao lado do nome das colunas que você deseja ocultar.
   • Arraste e solte as colunas na sequência preferida ou use as setas para cima e para baixo.
4. Selecione Salvar para confirmar e atualizar a exibição da tabela Activity.

Exibir atividade da sessão

Na página Atividade, você pode exibir a atividade dentro de uma sessão em um mapa de atividade visual ou em uma transcrição de conversa e um mapa de atividades visuais. Por padrão, a exibição Transcrição + Mapa é mostrada.

1. Para ver a atividade de uma sessão, selecione a sessão.

   • Para exibir a transcrição e o mapa de atividades juntos, selecione Exibir e Transcrição + Exibição de mapa.
   • Para só exibir o mapa de atividades, selecione Exibir e Exibição de mapa.

   

2. Para retornar à lista de sessões, selecione o ícone Voltar .

A exibição Transcrição + Mapa mostra a conversa que ocorreu com o agente durante uma sessão com o mapa de atividade visual. A transcrição registra a entrada do usuário, as cargas úteis do gatilho e as respostas do agente. Você pode usar as transcrições para ver como seu agente responde às conversas com os usuários. Você também pode ver as mensagens de carga útil do gatilho que seu agente recebe de gatilhos de evento.

Fixar ou desafixar atividade de sessão

Na página Atividade, você pode fixar sessões importantes no topo da lista para ter acesso fácil ou desafixá-las quando deixam de ser necessárias.

• Para fixar uma atividade de sessão, focalize o mouse a atividade da sessão e selecione o ícone Fixar ao lado do nome.
• Para desafixar uma atividade de sessão, focalize o mouse a atividade da sessão fixada e selecione o ícone Desafixar ao lado do nome.

Exibir todas as atividades do agente no mapa de atividades

A exibição Mapa é uma representação do fluxo de entradas, decisões e reações que aconteceram durante uma sessão. Cada atividade realizada pelo agente, usuário ou gatilho com o nó . Ao exibir o mapa de atividade, selecione um nó para ver detalhes sobre as entradas, decisões e saídas dessa atividade.

A imagem a seguir é um exemplo daquilo que você vê ao selecionar um nó de conhecimento. Ela mostra:

• A consulta usada pelo agente para pesquisar as fontes de conhecimento. Ela pode ser diferente da consulta escrita por um usuário, ou da entrada fornecida por um gatilho.
• A resposta criada pelo agente com base nas fontes de conhecimento.
• As fontes referenciadas pelo agente.
• Outras fontes são pesquisadas, mas não são usadas para criar a resposta. O agente pesquisou essas fontes, mas não encontrou informações relevantes para a consulta.

Neste exemplo, você pode ver os detalhes de um nó de ação de Obter a previsão de amanhã mostrando as entradas e as saídas:

Selecione Editar para exibir e alterar a configuração associada à atividade selecionada.

Justificativa

Raciocínio apresenta uma explicação de como um agente optou por chamar uma ferramenta em especial. A IA gera o raciocínio, sob demanda, e se baseia em metadados e atividade do agente. Justificativa é exibida para fontes de conhecimento de status Concluído ou conectores. Selecione Mostrar raciocínio para exibi-lo.

Ao analisar a atividade do agente, você pode usar o Raciocínio para conseguir uma compreensão melhor do porquê um agente optou por chamar uma ferramenta em especial ou preencher parâmetros. Isso é útil para resolver problemas do comportamento do agente. No entanto, como o raciocínio é gerado por IA, existe uma chance de não ser preciso, logo, você deve usar o bom senso ao analisar o raciocínio apresentado.

Status do agente

A tabela a seguir fornece informações sobre os estados variados que um agente pode encontrar durante a operação.

Enviar comentários

Se você tiver sugestões de como melhorar a qualidade do seu corretor, envie seu feedback usando o ícone de Feedback na página de Atividade .