Rever atividade do agente

Criar um agente é um processo iterativo. Envolve compreender como os seus agentes trabalham, fazer alterações e ver os resultados que lhe permitem criar melhores agentes. A monitorização da atividade do Copilot Studio fornece um mapeamento visual da sequência de entradas, decisões e saídas dos seus agentes numa sessão, para que possa encontrar problemas e oportunidades de melhoria.

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

Existem duas formas de monitorização de atividades:

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

Mapa de atividades em tempo real durante os testes

Quando faz uma pergunta ao seu agente no painel de teste, o mapa de atividades mostra uma representação visual do plano gerado. O mapa realça erros, como parâmetros de entrada ou saída em falta ou inválidos para ações, e mostra quanto tempo cada passo demora a ser executado. Também pode verificar se as informações que o seu agente está a enviar ou a receber estão corretas.

Para que o mapa de atividade apareça automaticamente quando enviar uma consulta ao seu agente no painel de teste, selecione os três pontos (...) e depois ative Mostrar mapa de atividade durante o teste.

Aqui, o utilizador perguntou: “Como vai estar o tempo em Toronto, Canadá, amanhã?” É possível ver a ação que foi selecionada para responder, bem como as entradas e saídas.

Testar acionadores de eventos

Quando testa acionadores de eventos, a payload do acionador é apresentada como uma mensagem no chat de teste. Esta mensagem só é visível no Copilot Studio, para efeitos de teste. Não está visível para os utilizadores do seu agente. Pode utilizar as mensagens da payload para compreender quando e quais as informações e instruções que um acionador envia ao seu agente.

Monitorização entre tópicos

Quando testa o seu agente, está disponível a opção de monitorizar entre tópicos. Com a monitorização ativada, quando um tópico é acionado como parte de um plano, os nós no tópico aparecem no mapa de atividades à medida que são executados, permitindo monitorizar o fluxo da conversação.

Atividades do histórico

Cada vez que um agente inicia uma sessão, incluindo sessões de teste iniciadas no Copilot Studio, a atividade é registada na página Atividade em tempo real. Vá à página Atividade para:

• Rever as interações e as decisões que o seu agente tomou durante uma sessão
• Identificar onde o comportamento do agente não corresponde aos seus objetivos
• Ver quanto tempo o seu agente demora a concluir cada atividade
• Encontrar os detalhes dos erros

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

• Interações no chat de teste do Copilot Studio
• Agentes publicados no canal do Microsoft Teams
• Sessões que começaram com um acionador autónomo

Vá à página Atividade para rever:

• A lista de sessões e respetivos detalhes
• A atividade passo a passo que ocorreu numa sessão

Lista de sessões

Uma sessão é uma unidade de interação do agente que envolve a conversação com um utilizador, o registo e a resposta a eventos ou uma combinação destas atividades.

Na lista de sessões, pode ver:

• Nome: o nome do utilizador que interage com o agente. Se a sessão não envolveu um utilizador, por exemplo, quando um agente executa ações sem qualquer pedido humano, o utilizador aparece como Automatizado.
• Canais: o canal através do qual a interação ocorreu. As sessões ocorridas no painel de teste do agente têm o ícone do Copilot Studio.
• Data: quando começou a primeira interação da sessão.
• Passos concluídos: o número de passos que o agente concluiu durante a sessão.
• Último passo: o passo final concluído na sessão.
• Estado: o estado da sessão (com êxito, falhou, em progresso).

Personalizar a vista da Tabela de atividades

Pode personalizar a vista da Tabela de atividades para que se concentre nas informações mais relevantes para si.

Para personalizar a vista da tabela de atividades:

1. Vá para a página Atividade do seu agente. É apresentada uma lista de sessões de atividades.
2. Selecione Editar colunas. O painel Editar colunas é apresentado com uma lista das colunas disponíveis.
3. No painel Editar colunas:
   • Selecione a caixa de verificação junto ao nome das colunas que quer mostrar.
   • Desmarque a caixa de verificação junto ao nome das colunas que quer ocultar.
   • Arraste e largue as colunas na sua sequência preferida ou utilize as setas para cima e para baixo.
4. Selecione Guardar para confirmar e atualizar a vista da Tabela de atividades.

Ver atividade da sessão

Na página Atividade, pode ver a atividade de uma sessão num mapa de atividades visual ou numa transcrição de conversação e num mapa de atividades visual. Por predefinição, é apresentada a vista Transcrição + Mapa.

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

   • Para ver a transcrição e o mapa de atividades em conjunto, selecione Vista e depois selecione Vista Transcrição + Mapa.
   • Para ver apenas o mapa de atividades, selecione Vista e depois selecione Vista do mapa.

   

2. Para regressar à lista de sessões, selecione o ícone Anterior .

A vista Transcrição + Mapa mostra a conversação que ocorreu com o agente durante uma sessão, juntamente com o mapa de atividades visual. A transcrição regista a entrada de utilizador, as payloads do acionador e as respostas do agente. Pode utilizar as transcrições para ver como o seu agente responde às conversas com os utilizadores. Também pode ver as mensagens de payload do acionador que o seu agente recebe de acionadores de eventos.

Afixar ou desafixar a atividade da sessão

Na página Atividade, pode afixar sessões importantes no topo da lista de sessões para fácil acesso ou desafixá-las quando já não forem necessárias.

• Para afixar uma atividade de sessão, faça pairar o cursor sobre a atividade da sessão e selecione o ícone Afixar junto ao nome.
• Para desafixar uma atividade de sessão, faça pairar o cursor sobre a atividade da sessão afixada e selecione o ícone Desafixar junto ao nome.

Ver toda a atividade dos agentes no mapa de atividades

A vista de Mapa é uma representação visual do fluxo de entradas, decisões e reações que ocorreram durante uma sessão. Cada atividade que o seu agente, um utilizador ou um acionador executa com um nó. Ao visualizar o mapa de atividades, selecione um nó para ver detalhes sobre as entradas, decisões e saídas dessa atividade.

A imagem seguinte é um exemplo do que vê quando seleciona um nó de conhecimento. Mostra:

• A consulta utilizada pelo agente para pesquisar as fontes de conhecimento. Pode ser diferente da consulta escrita por um utilizador ou da entrada fornecida por um acionador.
• A resposta criada pelo agente com base nas fontes de conhecimento.
• As fontes que o agente referiu.
• Outras fontes pesquisadas, mas não utilizadas para criar a resposta. O agente pesquisou estas fontes, mas não encontrou informações relevantes para a consulta.

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

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

Fundamentação

A Lógica fornece uma explicação para como um agente decidiu chamar uma ferramenta específica. A IA gera a lógica a pedido e esta é baseada em metadados e na atividade do agente. A Lógica é apresentada para origens ou conectores de conhecimento com o estado Concluído. Selecione Mostrar lógica para apresentar a lógica.

Ao rever a atividade do agente, pode utilizar a Lógica para entender melhor por que motivo um agente optou por chamar uma ferramenta específica ou preencher parâmetros. É útil na resolução de problemas de comportamento do agente. No entanto, como a lógica é gerada com IA, há uma probabilidade de que não seja precisa. Nesse caso, deve utilizar o seu discernimento ao rever a lógica fornecida.

Estado do agente

A tabela seguinte fornece as informações sobre os vários estados que um agente pode encontrar durante a sua operação.

Enviar comentários

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