Criar e editar tópicos

Um agente pode ter dois tipos de tópicos: tópicos de 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 de sistema têm expressões acionadoras, que pode personalizar para atender às necessidades do seu agente.

  • Não é possível criar tópicos de sistema.
  • Não pode eliminar tópicos de sistema, mas pode desativá-los.
    • Pode fazer alterações a tópicos de sistema. No entanto, deve esperar até se sentir à vontade para criar experiências de agente completas antes de começar a editar tópicos de sistema.

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

• Os tópicos personalizados predefinidos abrangem comportamentos comuns, como cumprimentar um cliente, terminar uma conversação ou reiniciar uma conversação.

  • Pode efetuar alterações aos tópicos personalizados predefinidos ou removê-los totalmente do seu agente.
  • Todos os tópicos que criar são tópicos personalizados.

Quando cria um bot, o Copilot Studio gera vários tópicos para si. Os tópicos criados automaticamente enquadram-se nestas categorias:

• Os Tópicos de lições ajudam a compreender formas simples e complexas de utilizar nós para criar conversações de bot.

  Pode editar tópicos de lições ou eliminá-los.

• Os Tópicos de sistema são tópicos de que necessita durante uma conversação 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 na tela de criação. Não personalize estes tópicos até se sentir confortável a criar uma conversação de bot ponto a ponto.

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

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

   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 Sobre propriedades de Intenção Reconhecida, selecione a área Expressões. O painel secundário Expressões é apresentado.

5. Em Adicionar expressões, introduza uma expressão acionadora 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 expressões acionadoras, pode:

   • Selecione o ícone Adicionar junto ao campo de texto e introduza a expressão pretendida.
   • Cole um conjunto de expressões acionadoras, cada uma numa linha separada, e selecione Enter.
   • Escreva um conjunto de expressões acionadoras, premindo Shift+Enter após cada uma para colocá-la numa linha separada, e selecione Enter.
   • Carregue um ficheiro com a lista das expressões acionadoras que pretende adicionar a este tópico.

   Pode incluir pontuação numa expressão acionadora, mas é melhor utilizar expressões curtas em vez de longas.

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

7. Adicione detalhes ao seu tópico:

   • Introduza um nome para identificar o tópico, como "Horário de funcionamento da loja". A página Tópicos lista todos os tópicos definidos no seu agente com este nome.
   • Se pretender, introduza um nome a apresentar para mostrar ao cliente quando o agente não conseguir determinar qual o tópico que corresponde à mensagem do cliente.
   • Se pretender, utilize o campo Descrição para descrever o propósito do tópico para si e para outros criadores de agentes da sua equipa. Os clientes nunca veem as descrições dos tópicos.

8. Selecione Guardar na barra de menus superior para guardar o tópico.

Carregar expressões acionadoras 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 expressões, selecione carregar um ficheiro.

3. Em Carregar um ficheiro, selecione a opção pretendida:

   • Se pretender adicionar novas expressões acionadoras ao seu tópico, selecione Acrescentar.
   • Para substituir todas as expressões acionadoras existentes pela lista do seu ficheiro, selecione Substituir.

4. Largue o seu ficheiro na janela. Alternativamente, selecione clicar para navegar, navegue até ao seu ficheiro e selecione-o.

5. Reveja as expressões acionadoras que aparecem e selecione Adicionar.

6. Guarde o seu tópico.

Transferir expressões acionadoras para um 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 expressões, selecione transferir.

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 de 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 Expressões acionadoras é apresentado.

3. Adicione as expressões acionadoras pretendidas ao seu tópico.

   

   Pode especificar mais de uma expressão acionadora para um tópico, utilizando uma nova linha para cada expressão. Pode incluir pontuação numa expressão acionadora, mas é melhor utilizar expressões curtas em vez de longas.

4. Introduza a mensagem pretendida e adicione mais nós conforme pretendido.

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

6. Selecione o ícone Detalhes. Aqui pode alternativamente editar o Nome e adicionar um Nome a apresentar e uma Descrição.

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

7. Selecione Guardar 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 quer 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 na tela

Pode utilizar os controlos da barra de ferramentas para cortar, copiar, colar e eliminar o nó selecionado ou 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 utilizar as ferramentas Cortar ou Copiar para colocar um ou mais nós na área de transferência, pode colá-los na tela de duas formas:

• 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 a um tópico

Os tópicos podem ter parâmetros de entrada e saída. Quando um tópico é redirecionado para outro tópico, pode utilizar estes parâmetros para transmitir informações entre os tópicos.

Além disso, se o seu agente utilizar o modo generativo, pode preencher automaticamente as entradas do tópico a partir do contexto da conversação ou depois de gerar perguntas para recolher valores dos utilizadores. 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 de tópicos, consulte Gerir 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 markup fácil de ler e compreender. Utilize o editor de código para copiar e colar tópicos de outros bots — mesmo os criados por outros autores.

Neste exemplo, copia e cola YAML no editor de código para adicionar rapidamente um tópico que pede ao cliente informações de envio.

1. Na página Tópicos, selecione Adicionar um tópico>A partir do zero.

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

   

3. Selecione e elimine o conteúdo do editor de código. Depois, 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 Guardar e, em seguida, selecione Fechar editor de código. Repare na lógica condicional que segue alguns dos nós de Pergunta.

   

Na lista de Tópicos do seu chatbot, selecione o tópico que quer editar. Vê as expressões de acionador 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 pretende adicionar um novo nó e selecione o tipo de nó pretendido na lista apresentada.

• 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 seleciona Fazer uma pergunta a partir do menu Adicionar nó, é apresentado um novo nó de Pergunta.

1. Introduza a pergunta que quer fazer.

   Por exemplo, se o utilizador quiser saber o horário da loja, o chatbot pode perguntar "De que localização de loja precisa?"

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

   Esta opção determina o que o bot deve ouvir quando o utilizador responde. Para obter mais informações, consulte Utilizar entidades numa conversa.

3. Em Opções para o utilizador, introduza as respostas esperadas à pergunta do bot.

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

   

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

   Durante uma conversação, cada escolha aparece como um botão no chat, mas os utilizadores também podem escrever a 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 em que estão disponíveis variáveis, pode adicionar lógica de ramificação com base nos valores das variáveis. Por exemplo, se configurar a autenticação de utilizador, pode querer que o seu chatbot mostre uma mensagem diferente se o utilizador tiver sessão iniciada.

Quando seleciona Adicionar uma condição a partir do menu Adicionar nó, é apresentado um menu.

• Para adicionar um caminho baseado num valor de variável específico, selecione Ramificar com base numa condição e configure a condição pretendida.
• 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 pretendida ou crie uma nova.

Se o seu bot tem capacidades baseadas em voz, há mais ferramentas disponíveis.

Mostrar uma mensagem

Quando seleciona Mostrar uma mensagem a partir do menu Adicionar nó, é apresentado um novo nó de Mensagem.

Introduza a mensagem que pretende que o bot diga na caixa de texto. Pode aplicar alguma formatação básica, como negrito, itálico, listas ordenadas e não ordenadas, e hiperligações. Também pode utilizar variáveis que definiu noutro lugar na sua conversação de bot.

Redirecionar para outro tópico

Quando seleciona Redirecionar para outro tópico a partir do menu Adicionar nó, é apresentada uma lista de tópicos.

Selecione o tópico para o qual o bot deve desviar a conversação. Por exemplo, poderá querer enviar o utilizador para um tópico específico sobre o fecho de uma loja, se a pergunta for sobre o horário da loja.

É apresentado um nó Redirecionar.

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 redirecionar para qualquer um dos seguintes tópicos de sistema, toda a conversação termina:

• Fim da conversação
• Êxito Confirmado
• Falha Confirmada
• Adeus
• Escalar
• Começar novamente (também repõe 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 é recolhida na página de análise de satisfação do cliente.

Também poderá fazer com que a conversação seja entregue a um agente em direto se estiver a utilizar um portal de suporte ao cliente adequado, como um Omnicanal para 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 um inquérito de satisfação do cliente, selecione Terminar com inquérito.

• Para inserir um nó de entrega que é associado ao seu produto de entrega configurado, selecione Transferir para agente. Opcionalmente, introduza uma mensagem privada para o representante de suporte 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 fizer alterações nos seus tópicos, teste o seu bot para garantir que tudo funciona como esperado.

Quando estiver satisfeito, publique-o nos canais pretendidos.