Criar e editar tópicos

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

• Os tópicos do sistema suportam comportamentos essenciais, como um pedido personalizado para falar com uma pessoa ou terminar a conversação. 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.
  • Não é possível excluir tópicos do sistema, mas você pode desativá-los.
    • Você pode fazer alterações nos tópicos do sistema. No entanto, você deve esperar até se sentir confortável em criar experiências completas de agente antes de começar a editar 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.

Quando você cria um bot, o Copilot Studio gera vários tópicos para você. Os 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.

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

  Não pode eliminar ou desativar tópicos de sistema nem editar as suas expressões acionadoras. No entanto, pode personalizar os nós no ambiente de edição. Não personalize esses tópicos até que você se sinta confortável em criar uma conversa de bot de ponta a ponta.

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

2. Selecione Adicionar um tópico e, em seguida, selecione De branco.

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

3. Selecione os três pontos (...) do nó Trigger , depois 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.

   O seu agente precisa de 5 a 10 expressões acionadoras para treinar a IA a compreender as respostas dos 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 ao 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 no seu agente por 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.

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 ficheiro de texto (máximo de 3 MB) com uma lista de todas as expressões acionadoras que pretende adicionar ao seu tópico, com cada expressão numa 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. Largue o seu ficheiro 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. Guarde o 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. Guarde o ficheiro de texto resultante ou abra-o num editor de texto para rever o seu conteúdo. Cada expressão acionadora aparece numa linha separada.

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. Adiciona as frases gatilho que quiseres para o teu tema.

   

   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. Introduza a mensagem que deseja 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.

Quando cria um tópico, um nó Acionador aparece automaticamente na tela de criação. Pode então adicionar diferentes tipos de nós para alcançar o caminho de conversação pretendido 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ó sob o nó após o qual você deseja adicionar um novo nó.

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

Eliminar um nó

Selecione os três pontos (...) do nó que quer apagar, depois selecione Eliminar.

Controles para edição de nós no painel

Use os controlos na barra de ferramentas para cortar, copiar, colar e eliminar o nó selecionado ou os nós adjacentes selecionados.

A barra de ferramentas também tem um controlo 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 Recortar ou Copiar para colocar um ou mais nós na área de transferência, você pode colá-los na tela de duas maneiras:

• 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. Utilize o editor de código para copiar e colar tópicos de outros bots — mesmo os criados por outros autores.

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 elimine 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 Pergunta .

   

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

Os tópicos têm alguns nós que são criados automaticamente. Pode editar estes nós tal como editaria outros nós.

• Para adicionar um nó, selecione o ícone Adicionar nó sob o nó após o qual você deseja adicionar um novo nó e selecione o tipo de nó desejado na lista exibida.

• Para eliminar um nó, selecione os três pontos (...) do nó que quer eliminar e selecione Eliminar.

• 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

Quando você seleciona Fazer uma pergunta no menu Adicionar nó , um novo nó Pergunta é exibido.

1. Introduza a pergunta que quer fazer.

   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.

   Esta opção determina o que o bot deve ouvir quando o utilizador 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) Mude o nome da variável que contém a resposta do utilizador e configure as 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.

Quando você seleciona Adicionar uma condição no menu Adicionar nó , um menu é exibido.

• 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

Quando você seleciona Mostrar uma mensagem no menu Adicionar nó , um novo nó Mensagem é 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

Quando você seleciona Redirecionar para outro tópico no menu Adicionar nó , uma lista de tópicos é exibida.

Selecione o tópico para onde o bot deve desviar a conversa. 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 da conversação para o subtópico termina, o bot regressa 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ção
• Sucesso confirmado
• Falha confirmada
• Adeus;
• Escalonar
• Recomeçar (também redefine quaisquer variáveis globais)

Terminar a conversação

Quando a conversação termina, pode adicionar um inquérito que pergunta ao utilizador se a sua pergunta ou problema foi respondido ou resolvido. A resposta é coletada na página de análise de satisfação do cliente.

Se estiver a usar um portal de atendimento ao cliente adequado, como o Omnichannel for Customer Service, também pode passar a conversa a um agente em direto.

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

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.