Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
- 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 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
Acesse a página Tópicos do seu agente. Para melhor visibilidade, feche o painel de teste por enquanto.
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.
Selecione o ícone Mais (...) do nó Gatilho e selecione Propriedades. O painel Em Propriedades de Intenção Reconhecida será exibido.
Na Propriedades de Intenção Reconhecida, selecione a área Frases. O painel secundário Frases é exibido.
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.
- Selecione o ícone Adicionar
Selecione Detalhes na barra de ferramentas para abrir o painel Detalhes do tópico.
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.
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.
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.
Em Adicionar frases, selecione carregar um arquivo.
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.
Solte o arquivo na janela. Como alternativa, selecione clique para procurar, navegue até o arquivo e selecione-o.
Revise as frases de gatilho exibidas e selecione Adicionar.
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.
Em Adicionar frases, selecione baixar.
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:
Selecione o ícone Adicionar nó
abaixo do nó sob o qual você deseja adicionar um novo nó.
Selecione o tipo de nó desejado na lista exibida.
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.
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.
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.
Na página Tópicos, selecione Criar>Em branco.
No canto superior direito da página da tela de criação, selecione Mais e, depois, selecione Abrir o editor de códigos.
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.
Selecione Salvar e Fechar editor de códigos. O nó Pergunta agora tem muitas condições para a pergunta sobre envio.
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.