Compartilhar via


Criar e editar tópicos

No Copilot Studio, um tópico define como se desenvolve uma conversa do agente.

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 uma linha de conversa entre um usuário e um agente. Você define e trabalha com tópicos em uma tela de criação. Um tópico contém um ou mais nós de conversa 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 informações sobre os limites de tópico e do agente, consulte: Cotas, limites, registro de aplicativo, certificados e valores de configuração.

Pré-requisitos

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

Para determinar como responder aos usuários, os agentes usam a orquestração generativa ou a 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 a gatilhos de eventos. Cada tópico tem uma descrição que informa o agente de sua finalidade. Saiba mais sobre como criar descrições.

Nos agentes configurados para usar a 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 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 horário da loja pode ter a frase de gatilho "consultar horário da loja". Se um cliente digitar "ver horário de funcionamento da loja", essa frase acionará o tópico Horário da loja. Saiba mais sobre criação de frases de gatilho.

Tópicos no Copilot Studio

Tipos de tópicos

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

  • Os tópicos do sistema oferecem suporte a comportamentos essenciais, como uma solicitação personalizada para falar com uma pessoa ou encerrar a conversa. Alguns tópicos do sistema têm frases de gatilho, que você pode personalizar para atender às necessidades do seu agente.

    • Você não pode criar tópicos do sistema.
    • Você não pode excluir tópicos do sistema, mas eles podem ser desativados.
    • Você pode fazer alterações nos tópicos do sistema. No entanto, até que você se sinta à vontade para criar experiências completas de agentes, não recomendamos editar os tópicos do sistema.

    Para obter mais informações, consulte Usar tópicos do 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 completamente do seu agente.
    • Todos os tópicos que você cria são tópicos personalizados.

Tipo de nó

Os seguintes tipos de nó estão disponíveis:

Tipo de nó Description
Nó da Mensagem Envie uma mensagem ao cliente.
Nó de Pergunta Faz uma pergunta ao cliente.
Nó do Cartão Adaptável Crie um snippet JSON para trocar com outros aplicativos.
Nós de Condição Ramifica sua conversa com base em uma condição.
Nós de Gerenciamento 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).
Gerenciamento de tópicos Redirecionar a conversa, transferir o usuário ou encerrar o tópico ou a conversa.
Nós Chamar uma ferramenta Chame um fluxo como o Power Automate ou Excel Online ou use um conector ou outro tipo de ferramenta.
Avançado Envie respostas generativas, solicitações HTTP, eventos e muito mais.

Dica

Renomeie os nós para torná-los mais fáceis de identificar. Select 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ódigo.

Não é possível renomear os nós de Gatilho e os nós Ir para etapa.

Os nomes do nó podem ter até 500 caracteres.

Criar um tópico

  1. Acesse 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 escolha Em branco.

    Um nó de Gatilho é exibido em uma tela da criação de tópicos em branco.

  3. Selecione o ícone Mais (...) do nó Gatilho e selecione Propriedades. O painel Em Propriedades de Intenção Reconhecida será exibido.

  4. Na 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 seu tópico.

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

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

    Você pode incluir a 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 no agente, por esse nome.
    • Se desejar, insira um nome de exibição para mostrar ao cliente quando o agente não puder determinar qual tópico corresponde à mensagem do cliente.
    • Se quiser, use o campo Descrição para descrever o objetivo do tópico para você e para outros criadores de agentes da sua equipe. 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 um de seus tópicos.

Carregar frases de gatilho para um tópico

No painel Frases do nó de Gatilho de um tópico, você pode adicionar ou substituir o conjunto de frases de gatilho associadas ao tópico.

  1. Prepare um arquivo de texto (máximo de 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 ao seu tópico, selecione Acrescentar.
    • Para substituir todas as frases de gatilho existentes pela lista do arquivo, selecione Substituir.
  4. Solte o arquivo na janela. Como alternativa, selecione clique para procurar, navegue até o arquivo e selecione-o.

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

  6. Salve o tópico.

Baixar frases de gatilho para um tópico

No painel Frases do nó de Gatilho de um tópico, você pode baixar o conjunto de frases de gatilho associadas ao tópico.

  1. Em Adicionar frases, selecione baixar.

  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.

Projetar um caminho da conversa do tópico

Quando você cria um tópico, um nó Gatilho é exibido automaticamente na tela de criação. Você pode adicionar diferentes tipos de nós para obter o caminho de conversa desejado para seu tópico.

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

  1. Selecione o ícone Adicionar nó abaixo do nó sob o qual você deseja adicionar um novo nó.

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

    Captura de tela das opções disponíveis para seleção para inserir um nó após um nó Gatilho.

Exclui um nó

Selecione o ícone Mais () do nó que deseja excluir, em seguida, selecione Excluir.

Controles para editar 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.

Captura de tela dos controles da barra de ferramentas para editar nós na tela de criação.

A barra de ferramentas também possui um controle para desfazer uma edição. Abra o menu Desfazer para reverter todas as ações para o último salvamento ou para refazer a ação anterior.

Captura de tela do menu Desfazer.

Colar os 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 para colá-los na tela:

  • Se você selecionar um nó e depois escolher Colar, os nós da área de transferência serão adicionados após o nó selecionado.

  • Se você selecionar "+" para ver o menu Adicionar nó e selecione Colar, o nó na área de transferência é inserido nesse local.

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 seu agente usar modo gerativo, ele poderá preencher automaticamente as entradas de tópico a partir do contexto da conversa ou depois de gerar perguntas para coletar valores dos usuários. Esse comportamento é semelhante à maneira como o preenchimento de slot generativo 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ópico.

Editar tópicos com o editor de códigos

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

Importante

Projetar um tópico inteiramente no editor de códigos e colar tópicos complexos não é totalmente suportado.

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

  1. Na página Tópicos, selecione Criar>Em branco.

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

    Captura de tela de como abrir o editor de códigos de um tópico.

  3. Selecione e exclua o conteúdo do editor de códigos. 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 Fechar editor de códigos. O nó Pergunta agora tem muitas condições para a pergunta sobre envio.

    Captura de tela de uma conversa criada a partir de YAML no editor de código do Copilot Studio.

Testar e publicar seu agente

Teste seu agente ao fazer alterações nos seus tópicos para garantir que tudo esteja funcionando conforme o esperado.

Depois de projetar e testar seu agente, publique-o na Web, em aplicativos móveis ou nativos ou em canais do Microsoft Bot Framework.