Criar e editar tópicos

No Copilot Studio, um tópico define como uma conversa de agente progride.

Para criar tópicos, você pode descrever o que deseja e fazer com que a IA crie o tópico para você ou crie tópicos do zero.

No Copilot Studio, um tópico representa alguma parte de um thread de conversação entre um usuário e um agente. Você define e trabalha com tópicos em um canvas de criação. Um tópico contém um ou mais nodos, que juntos definem os caminhos de conversação que um tópico pode seguir. Cada nó executa uma ação, como enviar uma mensagem ou fazer uma pergunta.

Para obter mais informações sobre limites de agente e tópico, consulte Cotas, limites, registo de aplicação, certificados e valores de configuração.

Pré-requisitos

• Para criar um agente, consulte Guia de início rápido: criar e implantar um agente.

Selecionando o tópico certo para responder a um usuário

Para determinar como responder aos usuários, os agentes usam orquestração generativa ou orquestração clássica.

Com a orquestração generativa, um agente determina a combinação mais apropriada de tópicos, ações e conhecimento a ser usada para responder a consultas do usuário ou responder a gatilhos de eventos. Cada tópico tem uma descrição que informa o agente do seu propósito. Saiba mais sobre como criar descrições.

Em agentes configurados para usar orquestração clássica, cada tópico tem um conjunto de frases de gatilho — frases, palavras-chave e perguntas que um cliente provavelmente usará para consultas relacionadas a um problema específico. Esses agentes usam a compreensão de linguagem natural, a mensagem do seu cliente e as frases de gatilho do tópico para encontrar o melhor tópico a ser acionado. A entrada do cliente não precisa corresponder exatamente a uma frase de gatilho de tópico para acionar o tópico. Por exemplo, um tópico sobre o horário da loja pode ter a frase de gatilho "verificar o horário da loja". Se um cliente inserir "ver horário de funcionamento da loja", essa frase acionará o tópico de horário da loja. Saiba mais sobre como criar frases de gatilho.

Tópicos no Copilot Studio

Aplicação Web

Um agente pode ter dois tipos de tópicos , sistema e tópicos personalizados . Cada novo agente começa com um conjunto de tópicos de sistema e personalizados predefinidos.

• Os tópicos do sistema suportam comportamentos essenciais, como um pedido personalizado para falar com uma pessoa ou terminar a conversa. Alguns tópicos do sistema têm frases de gatilho, que você pode personalizar para atender às necessidades do seu agente.

  • Não é possível criar tópicos de sistema.
  • Você não pode excluir tópicos do sistema, mas pode desativá-los.
  • Você pode fazer alterações nos tópicos do sistema. No entanto, até que você se sinta confortável em criar experiências completas de agente, não recomendamos editar os tópicos do sistema.

  Para obter mais informações, consulte Utilizar tópicos de sistema.

• Os tópicos personalizados predefinidos abrangem comportamentos comuns, como cumprimentar um cliente, encerrar uma conversa ou reiniciar a conversa.

  • Você pode fazer alterações nos tópicos personalizados predefinidos ou removê-los totalmente do seu agente.
  • Todos os tópicos que você cria são tópicos personalizados.

Tipos de nós

Os seguintes tipos de nó disponíveis:

Tipo de nó	Descrição
Nó Mensagem	Envie uma mensagem ao cliente.
Nó Pergunta	Faça uma pergunta ao cliente.
Nó Cartão Adaptável	Crie um trecho JSON para trocar com outros aplicativos.
Nós Condição	Ramifique a sua conversação com base numa condição.
Nós Gestão de variáveis	Defina um valor, analise um valor ou limpe variáveis (incluindo a capacidade de limpar o histórico de conversas usado pelo agente).
Gestão de tópicos	Redirecionar a conversa, transferir o usuário ou encerrar o tópico ou conversa.
Nós Chamar uma ferramenta	Chame um fluxo como o Power Automate ou o Excel Online ou use um conector ou outro tipo de ferramenta.
Avançado	Envie respostas generativas, solicitações HTTP, eventos e muito mais.

Sugestão

Renomeie os nós para torná-los mais fáceis de identificar. Selecione o campo de nome do nó para atualizar o nome diretamente ou selecione o ícone Mais(...) do nó e selecione Renomear no menu. Você também pode renomear nós no editor de códigos.

Não é possível renomear nós de Acionador e nós de Ir para o passo.

Os nomes dos nós podem ter até 500 caracteres.

Criar um tópico

1. Vá para a página Tópicos do seu agente. Para melhor visibilidade, feche o painel de teste por enquanto.

2. Selecione Adicionar um tópico e selecione A partir do zero.

   Um nó Acionador é apresentado numa tela de criação de tópicos em branco.

3. Selecione o ícone Mais (...) do nó Acionador e, em seguida, selecione Propriedades. É apresentado o painel Propriedades de intenção reconhecida.

4. Em Propriedades de intenção reconhecida, selecione a área Frases . O painel secundário Frases é exibido.

5. Em Adicionar frases, insira uma frase de gatilho para o seu tópico.

   Seu agente precisa de 5 a 10 frases de gatilho para treinar a IA a entender as respostas de seus clientes. Para adicionar mais frases de gatilho, você pode:

   • Selecione o ícone Adicionar ao lado do campo de texto e insira a frase desejada.
   • Cole um conjunto de frases de gatilho, cada uma em uma linha separada, e selecione Enter.
   • Digite um conjunto de frases de gatilho, pressionando Shift+Enter após cada uma para colocá-la em uma linha separada e selecione Enter.
   • Carregue um arquivo listando frases de gatilho que você deseja adicionar para este tópico.

   Você pode incluir pontuação em uma frase de gatilho, mas é melhor usar frases curtas em vez de frases longas.

6. Selecione Detalhes na barra de ferramentas para abrir o painel Detalhes do tópico .

7. Adicione detalhes para o seu tópico:

   • Insira um nome para identificar o tópico, como "Horário da loja". A página Tópicos lista todos os tópicos definidos em seu agente, com esse nome.
   • Se desejar, insira um nome para exibição para mostrar ao cliente quando o agente não puder determinar qual tópico corresponde à mensagem do cliente.
   • Se desejar, use o campo Descrição para descrever o propósito do tópico para si próprio e para outros criadores de agentes na sua equipa. Os clientes nunca veem descrições de tópicos.

8. Selecione Salvar na barra de menu superior para salvar seu tópico.

Importante

Evite usar pontos (.) nos nomes dos tópicos. Não é possível exportar uma solução que contenha um agente com pontos no nome de qualquer dos seus tópicos.

Carregar frases de ativação para um tópico

No painel Expressões do nó Acionador de um tópico, pode adicionar ou substituir o conjunto de expressões do acionador associadas ao tópico.

1. Prepare um arquivo de texto (máximo 3 MB) listando todas as frases de gatilho que você deseja adicionar ao seu tópico, com cada frase em uma linha separada.

2. Em Adicionar frases, selecione carregar um arquivo.

3. Em Carregar um arquivo, selecione a opção desejada:

   • Se quiser adicionar novas frases de gatilho para o tópico, selecione Acrescentar.
   • Para substituir todas as frases de gatilho existentes pela lista do seu arquivo, selecione Substituir.

4. Solte seu arquivo na janela. Como alternativa, selecione clique para navegar, navegue até o arquivo e selecione-o.

5. Revise as frases de gatilho exibidas e selecione Adicionar.

6. Salve seu tópico.

Baixar frases de gatilho para um determinado tópico

No painel Expressões do nó Acionador de um tópico, pode transferir o conjunto de expressões do acionador associadas ao tópico.

1. Em Adicionar frases, selecione download.

2. Salve o arquivo de texto resultante ou abra-o em um editor de texto para revisar seu conteúdo. Cada frase de gatilho aparece em uma linha separada.

Desenhar um percurso de conversa sobre tópicos

Quando cria um tópico, um nó Acionador aparece automaticamente na tela de criação. Em seguida, você pode adicionar diferentes tipos de nós para alcançar o caminho de conversa desejado para o seu tópico.

Para adicionar um nó após outro nó ou entre dois nós na sua tela de criação de tópicos:

1. Selecione o ícone Adicionar nó por baixo do nó sob o qual deseja adicionar um novo nó.

2. Selecione o tipo de nó desejado na lista apresentada.

   

Excluir um nó

Selecione o ícone Mais(...) do nó que pretende eliminar e, em seguida, selecione Eliminar.

Controles para edição de nós na tela

Você pode usar controles na barra de ferramentas para cortar, copiar, colar e excluir o nó selecionado ou os nós adjacentes selecionados.

A barra de ferramentas também tem um controle para desfazer edições. Selecione o ícone Desfazer e escolha:

• Desfazer para desfazer a alteração mais recente
• Desfazer a última gravação para reverter todas as ações para a última gravação
• Refazer para refazer a ação anterior

Colar nós

Depois de usar as ferramentas Cortar ou Copiar para colocar um ou mais nós na área de transferência, há duas maneiras de os colar na tela:

• Se selecionar um nó e, em seguida, selecionar Colar, os nós na área de transferência serão inseridos após o nó selecionado.

• Se selecionar o "+" para ver o menu Adicionar nó e, em seguida, selecionar Colar, o nó na área de transferência será inserido nessa localização

Adicionar parâmetros de entrada e saída para um tópico

Os tópicos podem ter parâmetros de entrada e saída. Quando um tópico redireciona para outro tópico, você pode usar esses parâmetros para passar informações entre os tópicos.

Além disso, se o agente usar o modo generativo, ele poderá preencher automaticamente as entradas de tópicos do contexto da conversa ou depois de gerar perguntas para coletar valores dos usuários. Este comportamento é semelhante ao modo como o preenchimento de blocos generativos funciona para ações.

Para saber mais sobre parâmetros de entrada e saída para tópicos, consulte Gerenciar entradas e saídas de tópicos.

Editar tópicos com o editor de código

O editor de código mostra o tópico em YAML, uma linguagem de marcação fácil de ler e entender. Use o editor de código para copiar e colar tópicos de outros bots, mesmo aqueles criados por outros autores.

Importante

Não há suporte total para criar um tópico no editor de código e colar tópicos complexos.

Neste exemplo, você copia e cola o YAML no editor de códigos para adicionar rapidamente um tópico que solicita informações de envio ao cliente.

1. Na página Tópicos , selecione Adicionar um tópico>em branco.

2. No canto superior direito da tela de criação, selecione Mais e, em seguida, selecione Abrir editor de código.

   

3. Selecione e exclua o conteúdo do editor de código. Em seguida, copie e cole o seguinte código YAML:

   kind: AdaptiveDialog
   beginDialog:
     kind: OnRecognizedIntent
     id: main
     intent:
       displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
       triggerQueries:
         - Buy items
         - Buy online
         - Buy product
         - Purchase item
         - Order product
   
     actions:
       - kind: SendMessage
         id: Sjghab
         message: I am happy to help you place your order.
   
       - kind: Question
         id: eRH3BJ
         alwaysPrompt: false
         variable: init:Topic.State
         prompt: To what state will you be shipping?
         entity: StatePrebuiltEntity
   
       - kind: ConditionGroup
         id: sEzulE
         conditions:
           - id: pbR5LO
             condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"
   
         elseActions:
           - kind: SendMessage
             id: X7BFUC
             message: There will be an additional shipping charge of $27.50.
   
           - kind: Question
             id: 6lyBi8
             alwaysPrompt: false
             variable: init:Topic.ShippingRateAccepted
             prompt: Is that acceptable?
             entity: BooleanPrebuiltEntity
   
           - kind: ConditionGroup
             id: 9BR57P
             conditions:
               - id: BW47C4
                 condition: =Topic.ShippingRateAccepted = true
   
             elseActions:
               - kind: SendMessage
                 id: LMwySU
                 message: Thank you and please come again.
   

4. Selecione Salvar e, em seguida, selecione Fechar editor de código. Observe a lógica condicional que segue alguns dos nós da pergunta .

   

Teste e publique seu agente

Teste o agente quando efetuar alterações aos seus tópicos, para assegurar que tudo funciona conforme esperado.

Quando estiver satisfeito, publique o seu agente nos canais desejados.

Clássico/Equipas

Quando você cria um bot, vários tópicos são criados para você. Estes tópicos criados automaticamente enquadram-se nestas categorias:

• Os tópicos da lição ajudam você a entender maneiras simples e complexas de usar nós para criar conversas de bot.

  Você pode editar tópicos de aula ou excluí-los completamente.

• Os tópicos do sistema são tópicos que você provavelmente precisará durante uma conversa de bot.

  Não é possível excluir ou desativar tópicos do sistema ou editar suas frases de gatilho. No entanto, pode personalizar os nós na tela de criação. Recomendamos que você não personalize esses tópicos até que se sinta confortável em criar uma conversa de bot de ponta a ponta.

Observação

Tópicos sugeridos (legado)

Em um chatbot para o qual o recurso de sugestão de tópico agora preterido foi usado, os tópicos sugeridos ainda podem estar pendentes de revisão. Pode ver estes tópicos, numa aba separada Tópicos sugeridos, na lista Tópicos do seu agente. Você pode revisá-los e adicioná-los ao seu chatbot, se desejar.

Criar um tópico

1. Vá para a lista Tópicos do seu chatbot.

2. Selecione Novo tópico>A partir do zero. O Copilot Studio insere automaticamente um nó Acionador e nó Mensagem em branco. O painel Frases de gatilho é exibido.

3. Adicione as frases de gatilho desejadas para o seu tópico.

   

   Você pode especificar mais de uma frase de gatilho para um tópico, usando uma nova linha para cada frase. Você pode incluir pontuação em uma frase de gatilho, mas é melhor usar frases curtas em vez de frases longas.

4. Insira a mensagem desejada e adicione mais nós conforme desejado.

5. Na barra superior, edite o título do tópico para lhe dar um nome.

6. Selecione o ícone Detalhes . Aqui você pode, alternativamente, editar o Nome e adicionar um Nome para exibição e uma Descrição.

   • O Nome para exibição informa ao bot sobre qual tópico a pessoa está perguntando.
   • A Descrição descreve o propósito do tópico para você e outros criadores de bots. Esta descrição não é mostrada aos utilizadores.

7. Selecione Salvar para adicionar o tópico à lista de tópicos.

Editar um tópico

1. Na lista Tópicos do seu chatbot, selecione o tópico que deseja editar. Vê as expressões de acionador do tópico. Aqui você define o caminho de conversa entre um cliente e o agente.

   Os tópicos têm alguns nós que são criados automaticamente. Você pode editar esses nós da mesma forma que editaria outros nós.

2. Para adicionar um nó, selecione o ícone Adicionar nó abaixo do nó sob o qual você deseja adicionar um novo nó e selecione a opção desejada:

   • Faça uma pergunta.
   • Adicionar uma condição — apenas possível em tópicos onde as variáveis estão disponíveis
   • Chamar uma ferramenta
   • Mostrar uma mensagem
   • Redirecionar para outro tópico
   • Terminar a conversa — apenas possível na parte inferior de um caminho de conversação

3. Para excluir um nó, selecione o ícone de menu (⋮) do nó que deseja excluir e selecione Excluir.

4. Para alterar os caminhos entre nós, arraste o pequeno círculo na parte superior do nó (a sua âncora de nó) para uma nova localização na tela. A linha pontilhada representa o caminho original.

Fazer uma pergunta

Depois de selecionar Fazer uma pergunta no menu Adicionar nó , um novo nó Pergunta será exibido.

1. Insira a pergunta desejada.

   Por exemplo, se o usuário quiser saber o horário da loja, o chatbot pode perguntar "Qual local da loja você precisa?"

2. Em Identificar, selecione uma opção para a resposta do usuário, como Opções de múltipla escolha.

   Essa opção determina o que o bot deve ouvir quando o usuário responde. Para obter mais informações, consulte Usar entidades em uma conversa.

3. Em Opções para o usuário, insira as respostas esperadas à pergunta do bot.

   Por exemplo, se você escolher Opções de múltipla escolha em Identificar, as opções podem incluir locais de lojas como Seattle, Bellevue ou Kirkland.

   

   O Copilot Studio cria automaticamente um caminho condicional para cada opção. Você pode adicionar nós à lógica de ramificação e especificar como o bot deve responder para cada caminho ou valor.

   Durante uma conversa, cada opção aparece como um botão no chat, mas os usuários também podem digitar sua resposta.

4. (Opcional) renomeie a variável que contém a resposta do usuário e configure suas propriedades. Para obter mais informações, consulte Trabalhar com variáveis.

Adicionar uma condição

Em tópicos onde as variáveis estão disponíveis, você pode adicionar lógica de ramificação com base em valores de variáveis. Por exemplo, se você configurar a autenticação do usuário, talvez queira que seu chatbot mostre uma mensagem diferente se o usuário estiver conectado.

Depois de selecionar Adicionar uma condição no menu Adicionar nó , será apresentado um menu.

• Para adicionar um caminho com base em um valor de variável específico, selecione Ramificação com base em uma condição e configure a condição desejada.
• Para adicionar o caminho que abrange todos os outros valores, selecione Ramo para todas as outras condições.

Chamar uma ferramenta

Para chamar fluxos do Power Automate ou inserir nós de autenticação, selecione Chamar uma ferramenta no menu Adicionar nó e selecione a ferramenta desejada ou crie uma nova.

Se o seu bot tiver recursos baseados em voz, mais ferramentas estarão disponíveis.

Mostrar uma mensagem

Depois de selecionar Mostrar uma mensagem no menu Adicionar nó , um novo nó Mensagem será exibido.

Digite a mensagem que você deseja que o bot diga na caixa de texto. Você pode aplicar algumas formatações básicas, como negrito, itálico, listas ordenadas e não ordenadas e hiperlinks. Você também pode usar variáveis que você define em outro lugar na conversa do bot.

Redirecionar para outro tópico

Depois de selecionar Redirecionar para outro tópico no menu Adicionar nó , uma lista de tópicos será exibida.

Selecione o tópico para o qual o bot deve desviar. Por exemplo, você pode enviar o usuário para um tópico sobre o fechamento de uma loja se ele perguntar sobre o horário da loja.

É apresentado um nó Redirecionar.

Você pode considerar o tópico redirecionado como um subtópico. Pode inserir mais nós sob o nó Redirecionar. Quando o caminho de conversa para o subtópico estiver concluído, o bot retornará ao tópico original. O bot, em seguida, segue os nós que estão sob o nó do subtópico.

No entanto, se você redirecionar para qualquer um dos seguintes tópicos do sistema, toda a conversa terminará:

• Fim da conversa
• Sucesso confirmado
• Falha confirmada
• Adeus;
• Escalar
• Recomeçar (também redefine quaisquer variáveis globais)

Terminar a conversa

Quando a conversa terminar, você pode fazer com que uma pesquisa pergunte ao usuário se sua pergunta ou problema foi respondido ou resolvido. A resposta é coletada na página de análise de satisfação do cliente.

Você também pode ter a conversa entregue a um agente ao vivo se estiver usando um portal de atendimento ao cliente adequado, como o Omnichannel for Customer Service.

No final de um caminho de conversação que resolve um problema ou responde a uma pergunta, depois de selecionar Terminar a conversação no menu Adicionar nó, é apresentado um menu:

• Para terminar com uma pesquisa de satisfação do cliente, selecione Terminar com a pesquisa.

• Para inserir um nó de entrega que é associado ao seu produto de entrega configurado, selecione Transferir para agente. Opcionalmente, insira uma mensagem privada para o representante de atendimento ao cliente.

Teste e publique seu bot

Sempre que você fizer alterações em seus tópicos, teste seu bot para garantir que tudo funcione conforme o esperado.

Quando estiver satisfeito, publique-o nos canais desejados.