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 viabilizados pelo GitHub Copilot harness, que utiliza Créditos do Copilot para faturamento baseado no uso. Saiba mais na Visão Geral sobre faturamento para agentes alimentados pelo GitHub Copilot harness.

A cobrança por uso se aplica ao uso, criação, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot. Saiba mais em Gerenciar os custos de agentes viabilizados pelo GitHub Copilot harness.

O que você pode fazer na Preview

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 prompts: A visualização exibe formas de iniciar conversas nas configurações 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 pré-visualização

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

  • Visão do criador: a visão padrão que inclui o cartão de raciocínio no chat, para que você possa ver 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 Visualização x Avaliação

Scenario Usar visualização Usar Avaliar
Testes rápidos e interativos durante o desenvolvimento
Depurando uma resposta específica ou chamada de ferramenta
Refinando 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 a Pré-visualização para explorar e refinar, e depois use a Avaliação para validar em escala.

Características principais

Recursos de chat

Ao testar na guia Visualizar, você pode:

  • Enviar mensagens de texto e manter conversas com múltiplas interações
  • 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 etiqueta de origem ou ferramenta no rastreamento para navegar diretamente a esse componente na guia Build para edição.

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

Histórico da conversa

A aba Prévia 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.