Pré-visualizar e testar um agente

A aba Prévia nos agentes, alimentada pelo harness GitHub Copilot no Microsoft Copilot Studio, oferece um ambiente de testes interativo onde você pode conversar com seu agente, depurar seu comportamento e revisar o histórico de conversas — tudo isso antes de publicar.

Note

Os recursos deste artigo são alimentados pelo chicote GitHub Copilot, que utiliza os Créditos Copilot para faturamento baseado no uso. Saiba mais sobre os Créditos Copilot na visão geral de faturamento para agentes alimentados pelo GitHub Copilot harness.

A cobrança baseada no uso se aplica ao uso, construção, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot.

O que você pode fazer em Visualizar?

A guia Visualizar oferece um conjunto abrangente de ferramentas de teste e depuração:

  • Chat interativo: envie mensagens para seu agente e analise suas respostas em tempo real. A experiência de chat simula como os usuários interagem com seu agente após a publicação.
  • Sugestões de prompt: a visualização exibe iniciadores de conversa da configuração do seu agente, para que você possa testar rapidamente cenários comuns.
  • Rastreamento de atividades: veja um rastreamento detalhado da CoT (cadeia de pensamento) que mostra como seu agente processou cada mensagem, incluindo quais fontes de conhecimento foram consultadas, quais ferramentas foram invocadas e as etapas de raciocínio seguidas.
  • Histórico de conversas: revise conversas de teste anteriores com seu agente.
  • Avaliação de resposta: classifique as respostas do agente com reação positiva ou negativa e forneça comentários por escrito para monitorar a qualidade das respostas.

Opções de layout da visualização

A guia Visualizar oferece diferentes modos de exibição para se adequar ao seu fluxo de trabalho:

  • Exibição do criador: a exibição padrão que inclui o card de raciocínio dentro do chat, para que você veja o raciocínio do agente enquanto testa.
  • Visualização do usuário final: ative a opção Visualização do usuário final para ver o agente como os usuários finais o veem, sem informações de depuração.

Você pode alternar entre as exibições usando a alternância Visualização do usuário final no cabeçalho da visualização.

Quando usar Visualizar ou Avaliar

Scenario Usar Visualizar Usar Avaliar
Testes rápidos e interativos durante o desenvolvimento
Depurando uma resposta específica ou chamada de ferramenta
Iterando instruções ou conhecimento
Medindo a qualidade em muitos casos de teste
Testes automatizados e repetíveis antes da publicação
Comparando resultados entre versões do agente

Ambas as abordagens são complementares. Use Visualizar para explorar e refinar, depois, use Avaliar para validar em escala.

Características principais

Recursos de chat

Ao testar na guia Visualizar, você pode:

  • Enviar mensagens de texto e conduzir conversas com várias rodadas
  • Veja respostas do agente renderizadas com formatação avançada
  • Copiar as respostas do agente para revisão ou documentação
  • Avaliar as respostas com um polegar para cima ou polegar para baixo
  • Fornecer um feedback detalhado por meio da janela de comentários, incluindo comentários por escrito
  • Iniciar uma nova conversa para testar com um contexto limpo

Rastreamento de atividades

O rastreamento de atividades mostra exatamente como seu agente processou cada mensagem:

  • Etapas da cadeia de pensamento: veja os nós de raciocínio que seu agente seguiu
  • Atribuição das fontes de conhecimento: veja quais fontes de conhecimento o agente consultou e as citações que utilizou
  • Execução de ferramentas: veja quando ferramentas, conectores, fluxos ou habilidades foram invocados e quais resultados foram retornados
  • Detalhes de erros: identifique e solucione erros que ocorreram durante o processamento

Selecione qualquer marcador de fonte ou de ferramenta no rastreamento de atividades para navegar diretamente até esse componente na guia Criar para edição.

Saiba mais em Usar o rastreamento de atividades para depurar seu agente.

Histórico da conversa

A guia Visualizar mantém um histórico das suas conversas de teste. É possível:

  • Revisar conversas anteriores e seus resultados
  • Filtrar conversas por status (Todas, Com Falha, Em andamento, Concluído, Autenticação Necessária ou Entrada Necessária)
  • Exibir a transcrição de uma conversa anterior e as etapas de raciocínio para verificar o comportamento do agente
  • Exibir métricas detalhadas para cada sessão, incluindo passos/rodadas, duração, última etapa e o modelo que processou a solicitação

Saiba mais em Gerenciar conversas de versão preliminar.