Pré-visualizar e testar um agente (GitHub Copilot)

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 usados por agentes ou fluxos de trabalho alimentados pelo GitHub Copilot.

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.

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

Uso de crédito

O chat Preview mostra o total acumulado estimado de Copilot Credits usados durante a sessão de teste atual. Ele é atualizado conforme você interage com o agente. Esse recurso ajuda você a entender como diferentes prompts, instruções, fontes de conhecimento e ferramentas impactam o consumo antes de publicar seu agente.

Captura de tela da estimativa de Créditos do Copilot usados, mostrada na experiência de Visualização Prévia.

Selecione a estimativa de crédito para ver uma dica explicando que o valor é uma estimativa. Saiba mais em Entender o uso estimado de crédito.

Contexto de horário e fuso horário

Quando o host fornece um fuso horário válido, o agente usa a data e hora locais na aba Preview para responder a questões de agendamento e outras questões sensíveis ao tempo. Se não houver fuso horário disponível, o agente usa o Tempo Universal Coordenado (UTC) ou solicita o fuso horário. Esse comportamento corresponde à forma como o agente lida com o tempo em conversas publicadas, então as respostas que você vê na aba Visualização refletem o contexto temporal que um usuário final experimentaria.