Gerenciar tópicos no Microsoft Copilot Studio

  • Artigo

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.

Existem várias maneiras de gerenciar seus tópicos. o Copilot Studio inclui um verificador de tópico que permite saber se há erros em seus tópicos. Você pode ativar ou desativar tópicos para que eles não apareçam para as pessoas que conversam com seu copiloto. Você também pode copiar ou duplicar tópicos para facilitar a criação de novos.

Pré-requisitos

Erros de tópico

Quando você salva um tópico, o Copilot Studio informa se ele contém um erro ou gera um aviso.

Captura de tela da mensagem que indica que um tópico tem erros a serem corrigidos.

  • Erros impedem o funcionamento do copiloto. Você deve corrigi-los antes de poder publicar o copiloto.
  • Os avisos não impedem o funcionamento do copiloto, mas podem fazer com que tópicos individuais não funcionem conforme o esperado. Você deve corrigir os avisos quando eles forem exibidos.

Você pode ver se um tópico tem erros e o número de erros na coluna Erros do tópico. Essa página mostra somente os erros, não os avisos, porque os erros impedem o funcionamento do copiloto.

Captura de tela da página Tópicos, com o número de erros em um tópico realçado.

Ver erros de tópicos

  1. Abra seu tópico na página Tópicos e Plug-ins.

  2. Selecione Verificador de tópico.

    Captura de tela da localização do botão Verificador de tópico.

    Você verá o painel Verificador de tópico aberto, que revela uma lista de erros e avisos do tópico.

    Captura de tela da lista de erros do Verificador de tópico no tópico.

  3. Selecione um erro para ir diretamente para o nó que contém o erro.

Tipos de erros

O verificador de tópico sinaliza quatro tipos de erros:

  • Nó: o nó inteiro está incorreto. O nó fica destacado em vermelho.
  • Campo: o campo pode ter dados obrigatórios ausentes. Os dados ficam destacados em vermelho.
  • Expressão: a expressão pode ser inválida. O erro fica destacado em vermelho.
  • Exclusão de variável: uma variável foi excluída, tornando-a "órfã". A variável deve ser removida ou substituída. O erro fica destacado em vermelho sempre que a variável é usada.

Status do tópico

Os tópicos podem ter um status de Ativado ou Desativado para indicar se eles podem ser usados ou desencadeados em uma conversa do copiloto. Por padrão, novos tópicos são criados com o status definido como Ligar. Altere o status usando a alternância na coluna Status na página Tópicos e Plug-ins.

Quando um tópico está Ativado, ele é desencadeado conforme o esperado. Os tópicos são desencadeados como resultado de suas frases de gatilho ou quando outro tópico é redirecionado para ele.

Quando um tópico é definido como Desativado:

  • O tópico não é desencadeado.
  • O tópico não será desencadeado quando as frases de gatilho forem usadas em uma conversa ou se outro tópico redirecionar para ele.
  • O Verificador de tópico identificará um erro se um tópico for redirecionado para um tópico Desativado.
  • Todos os tópicos serão publicados quando você estiver pronto para publicar seu copiloto, estejam eles Ativados ou Desativados.

Dica

Desligue um tópico Desativado para trabalhar nele em um estado de rascunho. Deixe seu status em Desativado enquanto publica alterações em outros tópicos que estão prontos para serem publicados.

Para verificar ou alterar o status do seu tópico, selecione ...Mais opções ao lado do nome do seu tópico e alterne a opção Status.

Captura de tela da página Tópicos com a coluna Status realçada.

Copiar um tópico

Depois de criar alguns tópicos, você poderá usar um tópico anterior como linha de base ao criar tópicos.

Na página Tópicos e Plug-ins, selecione o menu ...Mais ações e selecione Fazer uma cópia.

Captura de tela do menu Mais opções de um tópico, com a opção Fazer uma cópia destacada.

Esta opção duplica o tópico selecionado com (Copiar) adicionado ao nome. Todo o conteúdo do tópico - como descrição, frases de gatilho e toda a conversa - é copiado para o novo tópico.

Um tópico copiado é Desativado por padrão para evitar confusão com o tópico original, que tem as mesmas frases de gatilho.

Quando terminar de editar o novo tópico, ative Ligar para testá-lo. Quando estiver pronto, publique o novo tópico.

Não há um limite para o número de vezes que um tópico pode ser copiado. Um número será adicionado ao nome e cada tópico terá sua própria ID interna.

Para mudar a conversa do tópico atual para outro tópico, sem recomeçar a conversa, adicione um nó Redirecionar. Por padrão, quando a conversa chega ao final do novo tópico, ela é retomada no tópico original.

Redirecionar para outro tópico

  1. Abra seu tópico na tela de criação.

  2. Onde você quiser que a transição ocorra, selecione + para adicionar um nó e selecione Gerenciamento de tópicos e escolha Acessar outro tópico.

    Captura de tela do menu Gerenciamento de tópicos, com Gerenciamento de tópicos destacado.

  3. Selecione um tópico personalizado ou de sistema da lista.

    Captura de tela da lista de tópicos para redirecionamento.

  4. Transmita variáveis entre tópicos se necessário. Se o tópico para o qual você está redirecionando requer alguma variável de entrada ou saída, insira ou selecione um valor para cada uma.

  5. Salve o tópico e use o painel Testar seu copiloto para confirmar se o copiloto chama com êxito o tópico de redirecionamento.

Você pode inserir mais nós após o nó Redirecionar, se necessário. Quando o tópico de redirecionamento termina, o copiloto retorna ao tópico original e continua com todos os nós que continuam após o nó Redirecionar.

Captura da tela de criação mostrando o fluxo de nós de uma pergunta que segue um nó do tópico redirecionado.

Encerrar os tópicos atuais ou todos

Por padrão, uma conversa redirecionada retorna ao tópico original no final do tópico chamado. Use os nós Encerrar o tópico atual ou Encerrar todos os tópicos para sair de um tópico (ou da conversa) a qualquer momento.

Captura de tela mostrando onde as seleções Encerrar o tópico atual e Encerrar todos os tópicos estão localizadas.

  • Um nó Encerrar o tópico atual encerra o tópico atual. Se o tópico atual for chamado de outro tópico, a conversa retornará imediatamente ao tópico original. Um uso comum desse nó é em uma ramificação de condição. Uma ramificação sai do tópico antecipadamente, enquanto outra ramificação continua o tópico atual.

  • Um nó Encerrar todos os tópicos limpa imediatamente todos os tópicos ativos. Seu copiloto considera a próxima mensagem do usuário como a primeira mensagem em uma nova conversa.

    Para que o usuário saiba que o copiloto ache que a conversa terminou, adicione um nó Encerrar Conversaantes do nó Encerrar todos os tópicos.

Muitos dos tópicos do sistema usam esses nós para controlar como as conversas terminam ou recomeçam. Saiba como usar tópicos do sistema em Microsoft Copilot Studio.

Dica

O nó Encerrar todos os tópicos não limpa ou redefine nenhuma variável global. Para limpar variáveis globais, use um nó Limpar todas as variáveis primeiro. Para obter um exemplo, consulte o tópico padrão do sistema Redefinir Conversa.