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 de teste, 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 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 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 monitorar entre os 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

Na página Atividade , você pode exibir as variáveis usadas pelo agente durante o teste ou em atividades históricas. Essas variáveis podem ser variáveis globais, de ambiente ou de sistema às quais o agente tem acesso.

Para exibir as variáveis usadas durante uma atividade:

1. Vá para a página Atividade . Aparece uma lista de atividades.
2. 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.
3. Para exibir variáveis em uma atividade histórica, selecione uma atividade na lista. Em seguida, selecione Variáveis. O painel Variáveis é aberto mostrando as variáveis usadas durante essa atividade.

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 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.

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

1. Abra seu agente no Copilot Studio. A página Visão Geral é exibida.
2. Selecione Testar para abrir o painel de teste.
3. No painel de teste, inicie uma conversa com seu agente inserindo uma consulta ou prompt.
4. Antes que o agente responda, o raciocínio aparece no painel de teste, 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 histórica do agente está disponível para:

• Interações no Copilot Studio test chat
• 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 ocorrem no painel de teste do 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.

Exibir conversa dentro de uma atividade

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.

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 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 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 referenciadas pelo agente.
• 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.

Justificativa

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. Isso é útil para resolver problemas do comportamento do agente. No entanto, como a lógica é gerada com IA, ela pode não ser precisa, portanto, use seu melhor julgamento ao revisar a lógica fornecida.

Status do agente

A tabela a seguir fornece informações sobre 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 .