Revisar atividade do agente

A criação de um agente é um processo iterativo. Envolve entender como seus agentes funcionam, fazer alterações e ver os resultados. Esse processo ajuda você a criar agentes melhores. O acompanhamento de atividades do Copilot Studio fornece um mapeamento visual da sequência de entradas, decisões e saídas de seus agentes dentro de uma atividade para que você possa encontrar problemas e oportunidades de melhoria.

Um mapa de atividades é gerado para cada atividade. Uma atividade começa quando um agente inicia uma conversa ou um evento externo dispara um agente. Um mapa representa cada atividade com um nó .

Existem duas formas de acompanhamento de atividades:

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

Mapa de atividade em tempo real durante o teste

Quando você faz uma pergunta ao seu agente no painel Testar seu agente , o mapa de atividades mostra uma representação visual do plano que o agente gerou. O mapa realça erros, como parâmetros de entrada ou saída ausentes 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 com que o mapa de atividades apareça automaticamente quando você enviar uma consulta ao seu agente no painel Testar seu agente , selecione os três pontos (...) e, em seguida, ative Mostrar mapa de atividades ao testar.

Aqui, o usuário perguntou: "Como será o tempo em Toronto, Canadá amanhã?" Você pode ver a ação que o agente selecionou para responder e as entradas e saídas.

Gatilhos para eventos de teste

Quando você testa gatilhos de evento, o chat de teste mostra o conteúdo do gatilho como uma mensagem. Somente você pode ver essa mensagem no Copilot Studio para fins de teste. Os usuários do seu agente não podem vê-lo. Use as mensagens de conteúdo para entender quando e quais informações e instruções um gatilho envia ao seu agente.

Navegar entre tópicos

Ao testar seu agente, você pode navegar entre tópicos. Quando você habilita o acompanhamento, o mapa de atividades mostra os nós dentro do tópico à medida que são executados quando um tópico é disparado como parte de um plano. Você pode monitorar o fluxo de conversa.

Exibir variáveis

Você pode visualizar as variáveis que seu agente usa durante os testes. Essas variáveis podem ser globais, de ambiente, de sistema ou personalizadas que o agente pode acessar.

Para exibir as variáveis:

1. Abra seu agente. A página Visão Geral é exibida.
2. Selecione Testar para abrir o painel Testar seu agente .
3. No painel Testar seu agente , inicie uma conversa com seu agente inserindo uma consulta ou prompt.
4. Para exibir variáveis durante o teste, selecione Testar e selecionar Variáveis. O painel Variáveis é aberto mostrando as variáveis usadas durante o teste.

Exibir a cadeia de pensamento do agente no chat de teste

O recurso Cadeia de Pensamento (CoT) fornece insights sobre o processo de raciocínio do seu agente durante o teste. Ele exibe os passos intermediários, considerações e decisões que o agente toma ao processar entradas e gerar saídas. Esse recurso é útil para entender interações complexas e depurar o comportamento do agente.

Para exibir a cadeia de pensamento ou raciocínio do agente durante o teste, siga estas etapas:

1. Abra seu agente. A página Visão Geral é exibida.
2. Selecione Testar para abrir o painel Testar seu agente .
3. No painel Testar seu agente , inicie uma conversa com seu agente inserindo uma consulta ou prompt.
4. Antes que o agente responda, o raciocínio é exibido no painel Testar seu agente , exibindo a cadeia de pensamento para a resposta do agente.

Atividade histórica

Sempre que um agente inicia uma atividade, incluindo testes iniciados no Copilot Studio, a página Atividade registra a atividade em tempo real. Vá até a página Atividade para:

• Examine as interações e as decisões tomadas pelo agente durante uma atividade.
• Localize onde o comportamento do agente não corresponde às suas metas.
• Veja quanto tempo seu agente leva para concluir cada atividade.
• Encontre detalhes do erro.

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

• Interações no chat de teste do Copilot Studio
• Agentes publicados nos canais Microsoft Teams e Microsoft 365 Copilot
• Agentes publicados no canal SharePoint
• Atividades que começaram com um gatilho autônomo

Examine as seguintes informações na página Atividade :

• A lista de atividades e seus detalhes.
• A conversa passo a passo que acontece dentro de uma atividade.

Lista de atividades

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

Na lista de atividades, você pode ver:

• Nome: o nome do usuário que interage com o agente. Se a atividade não envolver um usuário, como quando um agente executa ações sem solicitação humana, o usuário aparece como Automatizado.
• Canais: o canal em que a interação ocorreu. As atividades que acontecem no painel Teste seu agente têm o ícone do Copilot Studio.
• Data: a data em que a primeira interação da atividade começa.
• Etapas concluídas: o número de etapas que o agente conclui durante a atividade.
• Última etapa: a etapa final concluída na atividade.
• Status: o status da atividade (bem-sucedido, com 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. Aparece uma lista de atividades.
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.

Classificar e filtrar sessões

Você pode ordenar e filtrar as sessões com base em data, canal, status e erros para filtrá-las rapidamente e facilitar a triagem e revisão. Você também pode personalizar a visualização para focar no que mais importa para o seu fluxo de trabalho.

Para classificar ou filtrar sessões, vá para a página Atividade . Uma lista das sessões de atividade é exibida.

• Para classificar as sessões, passe o mouse sobre o cabeçalho da coluna que você deseja classificar até que a seta de classificação apareça e selecione-a. Selecione-o novamente para reverter a ordem de classificação.
• Para personalizar sua exibição para se concentrar em sessões específicas, selecione Filtros e escolha os critérios pelos quais deseja filtrar.
• Para restringir as sessões por status, selecione uma das seguintes pílulas de filtro no topo da lista de sessões: Falhado, Bloqueado, Em andamento, Aguardando o usuário ou Concluído.

Exibir atividade da sessão

Na página Atividade , você pode exibir a conversa dentro de uma atividade 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 uma conversa dentro de uma atividade, selecione uma atividade.

   • 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 atividades, selecione o ícone Voltar .

A visualização Transcrição + Mapa exibe a conversa que ocorreu com o agente durante uma atividade, junto com um mapa visual da atividade. A transcrição registra a entrada do usuário, as cargas do gatilho e as respostas do agente. Use 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 que seu agente recebe de gatilhos de evento.

Exibir a cadeia de pensamento do agente

O recurso Cadeia de Pensamento (CoT) fornece insights sobre o processo de raciocínio do seu agente durante uma atividade. Ele exibe as etapas, considerações e decisões intermediárias tomadas pelo agente à medida que processa entradas e gera saídas. Esse recurso é útil para entender interações complexas e depurar o comportamento do agente. Você pode exibir a cadeia de pensamento do agente para uma atividade específica somente no modo de exibição Mapa.

Para exibir a cadeia de pensamento ou raciocínio do agente para uma atividade específica:

1. Na guia Atividade , selecione a atividade que você deseja examinar. Por padrão, a visualização Transcrição + Mapa é mostrada.
2. No mapa de atividades, selecione a seta de Raciocínio. A cadeia de pensamento do agente aparece.

Veja as interações do seu agente com outros usuários

Quando o administrador do sistema permite o compartilhamento das transcrições de atividade do seu agente com outros usuários, você pode ver as interações que outros usuários têm com seu agente na página de Atividade . Você pode revisar como seu agente está se comportando em interações reais e identificar áreas a serem melhoradas.

Saiba mais em Compartilhar agentes com outros usuários.

Fixar ou desafixar atividade

Na página Atividade , você pode fixar atividades importantes na parte superior da lista de atividades para facilitar o acesso ou desafixá-las quando elas não forem mais necessárias.

• Para fixar uma atividade, passe o mouse sobre a atividade e selecione o ícone Fixar ao lado do nome.
• Para desafixar uma atividade, passe o mouse sobre a atividade fixada e selecione o ícone Desafixar ao lado do nome.

Exibir todas as atividades do agente no mapa de atividades

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

A imagem a seguir é um exemplo do que você vê quando seleciona um nó de conhecimento. Ela mostra:

• A consulta que o agente usou 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 que o agente referenciou.
• Outras fontes que o agente pesquisou, mas não usou 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 para Obter a previsão amanhã mostrando as entradas e saídas:

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

Lógica

O Rationale fornece uma explicação de como um agente decidiu chamar uma ferramenta específica. A IA gera a lógica sob demanda e se baseia em metadados e atividades do agente. Racionalidade é exibida para fontes de conhecimento ou conectores com status de Concluído. Selecione Mostrar raciocínio para exibi-lo.

Ao revisar a atividade do agente, use o Racionale para entender melhor por que um agente optou por chamar uma ferramenta específica ou preencher parâmetros. Ele ajuda você a solucionar problemas de comportamento do agente. No entanto, como a IA gera a lógica, ela pode não ser precisa. Use seu melhor julgamento ao revisar a lógica fornecida.

Status do agente

A tabela a seguir descreve os vários estados que um agente pode encontrar durante sua operação:

Enviar comentários

Se você tiver sugestões sobre como melhorar a qualidade do agente, envie seus comentários usando o ícone Comentários na guia Atividade .