Testar seu copiloto no Copilot Studio

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

Conforme você cria o copiloto no Copilot Studio, você pode usar o painel Testar copiloto para ver como o copiloto conduz um cliente durante a conversa.

Para ajudá-lo a encontrar e corrigir comportamentos inesperados, é possível habilitar o rastreamento entre tópicos para guiá-lo passo a passo pela conversa do copiloto e ir para o nó correspondente na tela de criação.

Aplicativo Web

Use o painel Testar o copiloto para percorrer as conversas de copiloto como um usuário. É uma boa maneira de garantir que seus tópicos estejam funcionando e que as conversas fluam conforme o esperado.

Visualizar uma conversa

1. Se o painel Testar o copiloto estiver oculto, abra-o selecionando Testar na parte superior de qualquer página.

   

2. No campo na parte inferior do painel Testar o copiloto, insira um texto. Se o texto for semelhante a uma frase de gatilho para um tópico, esse tópico será iniciado.

3. Selecione a resposta do copiloto no painel Testar o copiloto. Isso leva você ao tópico e ao nó que enviou a resposta. Os nós disparados têm uma marca de seleção colorida e uma borda inferior colorida.

   

   Ao continuar a conversa no tópico ativo, observe que cada nó acionado está marcado com a caixa de seleção e a borda inferior e centralizado na tela.

4. Se você quiser acompanhar automaticamente a conversa inteira, à medida que ela se move de tópico para tópico, ative Rastreamento na parte superior do painel Testar o copiloto.

   

5. Continue a conversa até que esteja satisfeito com o fluxo desejado.

Você pode atualizar um tópico a qualquer momento enquanto interage com a opção testar copiloto. Basta salvar o tópico para aplicar as alterações e continuar a conversa com o copiloto.

Sua conversa não é apagada automaticamente quando você salva um tópico. Se, a qualquer momento, você desejar limpar a conversa do copiloto de teste e recomeçar, selecione o ícone Redefinir.

Testar valores da variável

Você pode observar os valores das variáveis ao testar o copiloto.

1. Selecione Variáveis na barra de ferramentas secundária para abrir o painel Variáveis.

   

2. Mude para a guia Teste e expanda as categorias de variáveis desejadas.

   À medida que prossegue com sua conversa de teste, você pode monitorar o valor das variáveis em uso.

   

3. Para inspecionar as propriedades da variável, selecione a variável desejada. O painel Propriedades da variável é exibido.

   

Para obter informações sobre como usar o painel Variáveis para testar o preenchimento de slot, consulte Usar entidades e preenchimento de slot.

Salvar instantâneos de conversas

Ao testar seu copiloto, você pode capturar o conteúdo da conversa, além de dados de diagnóstico, e salvá-los como um arquivo. Você pode analisar os dados para solucionar problemas como o copiloto não está respondendo da maneira esperada.

Aviso

O arquivo do instantâneo tem todo o conteúdo do seu copiloto, o que pode incluir informações confidenciais.

1. Na parte superior do painel Testar o copiloto, selecione o ícone Mais (…) e Salvar instantâneo.

   

   Uma mensagem é exibida, notificando que o arquivo de instantâneo pode incluir informações confidenciais.

2. Selecione Salvar para salvar o conteúdo do copiloto e o diagnóstico da conversa em um arquivo .zip chamado botContent.zip.

   O arquivo botContent.zip contém dois arquivos:

   • dialog.json contém diagnósticos de conversa, incluindo descrições detalhadas de erros.
   • botContent.yml contém os tópicos e outros conteúdos do copiloto, incluindo entidades e variáveis.

Gerenciar conexões

Se o copiloto exigir conexões de usuário final, para gerenciar as conexões usadas pelo chat de teste, selecione o ícone Mais (...) na parte superior do painel de teste e Gerenciar conexões.

Clássico

Testar um tópico no painel Bot de teste

Use o painel Bot de teste para percorrer as conversas do bot como usuário. É uma boa maneira de garantir que seus tópicos estejam funcionando e que as conversas fluam conforme o esperado.

1. Se o painel Bot de teste estiver escondido, selecione Teste seu bot na parte inferior do painel do lado esquerdo para abri-lo.

   

2. Selecione o ícone Redefinir na parte superior do painel Testar bot para remover conversas anteriores.

   A reinicialização facilita o acompanhamento do fluxo do tópico atual sem se confundir com conversas anteriores.

   

3. No prompt Digite sua mensagem, insira uma das frases de gatilho do tópico.

Rastrear o caminho da conversa do tópico

A frase de gatilho inicia a conversa. O painel Bot de teste exibe a resposta do bot e as opções de resposta do usuário que você especificou.

1. Continue a conversa, testando se ela flui da maneira pretendida como projetado no tópico.

2. Você pode retornar à tela de criação do tópico a qualquer momento para examinar o caminho da conversa. O painel Bot de teste será atualizado automaticamente quando você salvar as alterações em um tópico.

Salvar instantâneos de conversas

Ao testar seu bot, você pode capturar o conteúdo da conversa, além de dados de diagnóstico, e salvá-los como um arquivo. Você pode analisar os dados para solucionar problemas, tais como o bot não responder da forma esperada.

Aviso

O arquivo instantâneo tem todo o conteúdo do seu bot, o que pode incluir informações confidenciais.

1. Na parte superior do painel Testar bot, selecione o ícone Mais (⋮), em seguida, selecione Salvar instantâneo.

   

   Uma mensagem é exibida, notificando que o arquivo de instantâneo pode incluir informações confidenciais.

2. Selecione Salvar para salvar o conteúdo do bot e o diagnóstico da conversa em um arquivo .zip chamado DSAT.zip.

   O arquivo DSAT.zip contém dois arquivos:

   • dialog.json contém diagnósticos de conversa, incluindo descrições detalhadas de erros.
   • botContent.json contém os tópicos e outros conteúdos do bot, incluindo entidades e variáveis.

Teams

Testar um tópico no painel Bot de teste

1. Se o painel Bot de teste estiver oculto, abra-o selecionando Testar seu bot no menu de navegação.

   

2. É uma boa ideia selecionar Redefinir na parte superior do painel Bot de teste para limpar conversas anteriores. A limpeza das conversas anteriores facilita a visualização do fluxo do tópico que você quer ver sem confusões.

   

3. No prompt Digite sua mensagem prompt na parte inferior do painel Bot de teste, insira uma frase de gatilho para o tópico.

   A frase de gatilho inicia a conversa do tópico e o painel Bot de teste exibe as respostas de bot e as opções de resposta do usuário que você especificou.

4. Continue a conversa, testando se ela flui da maneira pretendida como projetado no tópico.

5. Selecione uma resposta no painel Bot de teste, que levará você à resposta no editor de conversas desse tópico. A tela de criação exibe os nós realçados em verde.

   

Você pode retornar à tela de criação do tópico a qualquer momento para revisar seu caminho de conversa. O painel Chat de teste será atualizado automaticamente quando você salvar as alterações em um tópico.

Rastrear o caminho da conversa do tópico

Conforme você ajusta seu bot, pode ser útil habilitar o rastreamento entre tópicos, para que você possa seguir o caminho da conversa passo a passo.

1. Se o painel Bot de teste estiver oculto, abra-o selecionando Testar seu bot no menu de navegação.

   

2. Na parte superior do painel Bot de teste, defina Rastrear entre tópicos como Ativado.

   

3. Digite uma frase de gatilho para o tópico que você deseja verificar e continue testando a conversa.

4. Conforme você percorre a conversa no painel Bot de teste, a tela de criação destaca o local atual no caminho da conversa. A tela de criação exibe os nós realçados em verde.

5. Para navegar até um ponto anterior no caminho da conversa na tela de criação, selecione-o no painel Bot de teste.

Se o caminho da conversa no painel Testar seu bot se mover de um tópico para outro, a tela de criação atualiza e se move entre os tópicos para os nós apropriados realçados.

Observação

Ajude-nos a melhorar o Copilot Studio relatando problemas. Use o ícone de Sinalizador próximo à parte superior do painel de teste para enviar sua ID de conversa à Microsoft. A ID é um identificador único que a Microsoft usa para solucionar problemas em uma conversa. Outras informações, como o que é armazenado em um arquivo instantâneo da conversa, não são enviadas quando você reporta um problema. Todas as informações coletadas permanecem anônimas e serão usadas para ajudar a melhorar a qualidade do copiloto.