Exercício: criar e gerenciar tópicos

Concluído

Aqui, você cria o fluxo de conversa para seu agente.

Criar um tópico usando o Microsoft 365 Copilot

Os tópicos podem ser criados e editados usando linguagem natural.

  1. Navegue até Microsoft Copilot Studio.

    Importante

    Verifique se está no ambiente correto.

  2. Selecione seu agente no painel Agentes no lado esquerdo da tela.

  3. Selecione a guia Tópicos.

  4. Selecione Adicionar um tópico e Criar da descrição com o Copilot.

    Captura de tela de criação conforme a descrição com a opção de agente.

  5. Uma nova janela é exibida, solicitando a você Nomear seu tópico e fornecer uma descrição no campo de texto Criar um tópico para...

  6. No campo Nomeie seu tópico, insira o seguinte texto:

    Customer Details

  7. No campo Criar um tópico para, insira o seguinte texto:

    Ask the customer for their name and email address

  8. Selecione Criar.

  9. Um novo tópico é exibido com as frases de gatilho e nós de pergunta gerados.

    Observação

    Lembre-se de que seu conteúdo gerado pode parecer diferente daquele mostrado neste laboratório.

  10. Selecione Salvar.

Atualizar nós com linguagem natural

  1. Se o painel Editar com copiloto não for mostrado no lado direito da tela, selecione o ícone Microsoft 365 Copilot na parte superior da tela de criação.

  2. Selecione o segundo nó de pergunta Qual é seu endereço de email?

  3. No painel Editar com o Copilot, no campo O que você deseja fazer?, insira o seguinte texto:

    Update the message in this question node to say thank you to the Name variable from the previous node and then proceed to ask the email address question

  4. Selecione Atualizar.

    Observação

    A mensagem deve ser atualizada para incluir a variável Nome do nó da mensagem antes dela.

  5. Selecione Salvar.

Adicionar nós com linguagem natural

Além de adicionar nós atualizados, você pode usar o Microsoft 365 Copilot para adicionar novos.

  1. Verifique se nenhum nó está selecionado clicando no espaço vazio ao redor dos nós.

  2. No painel Editar com o Copilot, no campo O que você deseja fazer?, insira o seguinte texto:

    Summarize the information collected in an adaptive card

  3. Selecione Atualizar.

  4. Um nó de mensagem com um cartão adaptável é adicionado ao final do tópico.

    Captura de tela do nó da mensagem com um cartão adaptável.

  5. Selecione o cartão adaptável. As propriedades do cartão adaptável devem aparecer à direita da tela.

    Captura de tela das propriedades do cartão adaptável.

    A fórmula do Cartão Adaptável deve ser semelhante à da imagem anterior. Caso contrário, você pode copiar e colar a fórmula abaixo:

     {
     type: "AdaptiveCard", 
         body: 
         [
             {
                 type: "TextBlock",
                 size: "Medium",
                 weight: "Bolder",
                 text: "Summary"    
             },
             {
                 type: "FactSet",
                 facts: 
                 [
                     {
                         title: "Full Name",
                         value: Text(Topic.Name)
                     },
                     {
                         title: "Email Address",
                         value: Text(Topic.EmailAddress)
                     }
                 ]
             },
             {
                 type: "TextBlock",
                 text: "Thank you for providing the information."
             }
         ]
     }
    
  6. Abrir as propriedades do cartão adaptável fecha o painel Editar com o Copilot; portanto, você precisa selecionar o ícone para reabri-lo.

  7. Verifique se nenhum nó está selecionado clicando no espaço vazio ao redor dos nós.

  8. No painel O que você deseja fazer?, insira o seguinte texto:

    Add a new multiple choice question to prompt the user if the details are correct with two options Yes or No

  9. Selecione Atualizar.

  10. Um novo nó de pergunta é adicionado ao final do tópico com opções para o usuário selecionar.

  11. Selecione Salvar.

Configurar o escopo das variáveis

  1. Selecione Variáveis para abrir o painel Variáveis.

    Captura de tela do painel de variáveis.

  2. Marque as caixas de seleção à direita para as variáveis de tópico.

  3. Selecione Salvar.

Criar tópicos manualmente

Os tópicos podem ser criados manualmente adicionando nós e frases de gatilho.

Criar um tópico do zero

  1. Selecione a guia Tópicos.

  2. Selecione Adicionar um tópico e Do zero.

  3. Selecione Detalhes para abrir a caixa de diálogo Detalhes do tópico.

    Captura de tela da caixa de diálogo de detalhes do tópico.

  4. No campo Nome, insira o seguinte texto:

    Book a Real Estate Showing

  5. No campo Nome de exibição, insira o seguinte texto:

    Book

  6. No campo Descrição, insira o seguinte texto:

    Select the property and requested date and create a booking request

  7. Selecione Salvar.

  8. Selecione Detalhes para fechar a caixa de diálogo Detalhes do tópico.

Adicionar frases de gatilho

  1. Selecione Editar em Frases no Gatilho.

    Captura de tela do painel de frases de gatilho do tópico.

  2. Insira I want to book a real estate showing em Adicionar Frases e selecione o ícone +.

  3. Insira Schedule a real estate showing em Adicionar Frases e selecione o ícone +.

  4. Insira Arrange the viewing for a real estate property em Adicionar Frases e selecione o ícone +.

  5. Insira Set up an appointment to view a house em Adicionar Frases e selecione o ícone +.

  6. Insira Plan a property viewing em Adicionar Frases e selecione o ícone +.

  7. Selecione Salvar.

Adicionar um nó de mensagem

  1. Selecione o ícone + no nó Gatilho e selecione Enviar uma mensagem.

    Captura de tela da adição de um nó.

  2. No campo Digite uma mensagem, insira o seguinte texto:

    Hi, I can help you with booking a real estate property showing.

  3. Selecione Salvar.

Adicionar um nó de gerenciamento de tópicos

  1. Selecione o ícone + no nó enviar uma mensagem e selecione Adicionar uma condição.

  2. Selecione a variável DetailsCorrect.

  3. Selecione Gerenciamento de Tópicos > Ir para outro tópico e selecione o tópico Detalhes do Cliente.

  4. Selecione Salvar.

Adicionar nó de condição

  1. Selecione o ícone + no nó Redirecionamento e selecione Adicionar uma condição.

  2. Selecione DetailsCorrect para a variável.

  3. Selecionar é igual a

  4. Selecione Sim.

  5. Selecione Salvar.

Adicionar nós de pergunta

  1. Selecione o ícone + no nó de condição esquerdo e selecione Faça uma pergunta.

  2. No campo Digite uma mensagem, insira o seguinte texto:

    Which property do you want to see?

  3. Selecione Resposta completa do usuário para Identificar.

  4. Selecione a variável em Salvar resposta do usuário como e insira PropertyName em Nome da variável

  5. Selecione Salvar.

  6. Selecione o ícone + no nó da pergunta e selecione Faça uma pergunta.

  7. No campo Digite uma mensagem, insira o seguinte texto:

    What date and time do you want to see the property?

  8. Selecione Data e Hora para Identificar.

  9. Selecione a variável em Salvar resposta do usuário como e insira DateTime em Nome da variável

  10. Selecione Salvar.

Testar o agente

  1. Selecione o botão Testar no canto superior direito da tela para abrir o painel de teste.

  2. Selecione os três pontos na parte superior do painel de teste no canto superior direito da tela.

  3. Selecione Rastrear entre tópicos.

  4. Selecione o ícone Iniciar uma nova conversa na parte superior do painel de teste.

  5. Quando a mensagem de Início de Conversa for exibida, seu agente iniciará uma conversa. Em resposta, insira uma frase de gatilho para o tópico que você criou:

    I want to book a real estate showing

  6. O agente responde com a pergunta "Qual é o seu nome?".

  7. Insira as seguintes informações:

    Name: <Your name>
    Email address: <Your email address>
    
  8. Após você fornecer as informações, um cartão adaptável exibe as informações inseridas, uma pergunta indagando se as informações estão corretas e opções para selecionar Sim ou Não.

  9. Selecione Sim.

  10. Insira 555 Oak Lane, Denver, CO 80203 para o prompt Qual propriedade você deseja ver?.

  11. Insira Tomorrow 10:00 AM para o prompt Em que data e horário deseja ver o imóvel?.

Usar entidades para melhorar o agente

O Microsoft Copilot Studio usa entidades para entender a intenção do usuário. Há muitas entidades predefinidas incluídas para informações comumente usadas. Você pode criar entidades personalizadas para sua finalidade específica.

Exibir entidades predefinidas

  1. Selecione Configurações no canto superior direito da tela.

  2. Selecione a guia Entidades.

Criar a entidade do tipo de propriedade

  1. Selecione + Adicionar uma entidade e + Nova entidade.

  2. Selecione o bloco Lista fechada.

  3. Insira Property Type no campo Nome.

  4. Insira Apartment no campo Inserir item e selecione Adicionar.

  5. Insira House no campo Inserir item e selecione Adicionar.

  6. Insira Condominium no campo Inserir item e selecione Adicionar.

  7. Insira Duplex no campo Inserir item e selecione Adicionar.

  8. Selecione + Sinônimos para Apartment, insira Flat, selecione o ícone + e Concluído.

  9. Selecione + Sinônimos para House, insira Single-family home, selecione o ícone + e Concluído.

  10. Selecione + Sinônimos para Condominium, insira Townhouse, selecione o ícone + e Concluído.

  11. Selecione Salvar.

  12. Selecione Fechar.

Criar entidade de número de quartos

  1. Selecione + Adicionar uma entidade e + Nova entidade.

  2. Selecione o bloco Expressão regular (Regex).

  3. Insira Number of Bedrooms no campo Nome.

  4. Insira [1-5] no campo Padrão.

  5. Selecione Salvar.

  6. Selecione Fechar.

Usar entidades

  1. Selecione seu agente no painel Agentes no lado esquerdo da tela para retornar à guia Visão geral.

  2. Selecione a guia Tópicos.

  3. Selecione o tópico Book a Real Estate Showing.

  4. Selecione o ícone + acima do nó da pergunta da propriedade e selecione Fazer uma pergunta.

  5. No campo Digite uma mensagem, insira o seguinte texto:

    What type of property do you want to see?

  6. Selecione Property Type para Identificar.

  7. Selecione Selecionar opções para o usuário e marque a opção Exibir para todos os valores da lista.

  8. Selecione a variável em Salvar resposta do usuário como e insira PropertyType em Nome da variável

  9. Selecione o ícone + abaixo do novo nó de pergunta e selecione Fazer uma pergunta.

  10. No campo Digite uma mensagem, insira o seguinte texto:

    How many bedrooms do you need?

  11. Selecione Number of Bedrooms para Identificar.

  12. Selecione a variável em Salvar resposta do usuário como e insira NumberofBedrooms para Nome da variável

  13. Selecione Salvar.

Criar ações do agente

O Microsoft Copilot Studio pode acessar dados no Microsoft Dataverse usando fluxos da nuvem do Power Automate

Criar fluxo do Power Automate para recuperar uma propriedade

  1. Selecione seu agente no painel Agentes no lado esquerdo da tela para retornar à guia Visão geral.

  2. Selecione a guia Ações.

  3. Selecione + Adicionar uma ação.

  4. Role para baixo e selecione Criar um novo fluxo.

  5. Entre no Power Automate, se solicitado.

  6. Selecione Executar um fluxo do Copilot no canto superior esquerdo da tela e insira Get Property como o nome do fluxo.

  7. Selecione a etapa do gatilho Executar um fluxo do Copilot e selecione + Adicionar uma entrada.

  8. Selecione Texto.

  9. Insira Bedrooms para Entrada e Number of Bedrooms para Insira sua entrada.

  10. Selecione o ícone + entre as duas etapas do fluxo e selecione Adicionar uma ação.

  11. Insira Dataverse no campo Pesquisar e selecione Ver mais para o conector do Dataverse.

  12. Selecione a ação Listar linhas.

  13. Se for solicitada autenticação, selecione OAuth e Entrar.

  14. Selecione Real Estate Properties para o nome da tabela.

  15. Selecione Mostrar tudo.

  16. Insira contoso_bedrooms eq no campo Filtrar Linhas.

  17. Use Conteúdo dinâmico para selecionar o parâmetro Bedrooms e selecione Adicionar.

  18. Selecione a ação Responder ao Copilot e selecione + Adicionar uma saída.

  19. Selecione Texto.

  20. Insira PropertyId para Insira um nome, clique no campo Insira um valor para responder e selecione Inserir Expressão.

  21. Insira a seguinte expressão:

    first(outputs('List_rows')?['body/value'])['contoso_realestatepropertyid']
    
  22. Selecione Adicionar.

  23. Selecione + Adicionar uma saída.

  24. Selecione Texto.

  25. Insira PropertyName para Insira um nome, clique no campo Insira um valor para responder e selecione Inserir Expressão.

  26. Insira a seguinte expressão:

    first(outputs('List_rows')?['body/value'])['contoso_propertyname']
    
  27. Selecione Adicionar.

  28. Selecione Configurações.

  29. Verifique se a Resposta Assíncrona está definida como Desativada.

  30. Selecione Salvar rascunho.

  31. Selecione Publicar.

  32. Feche a guia Power Automate.

Adicionar uma ação do agente para recuperar uma propriedade

  1. Selecione Atualizar.

  2. Selecione o fluxo Get Property.

  3. Selecione Avançar.

  4. Selecione Avançar.

  5. Selecione Concluir.

  6. Selecione a guia Tópicos.

  7. Selecione o tópico Book a Real Estate Showing.

  8. Selecione o ícone + abaixo da pergunta De quantos quartos você precisa? nó e selecione Chamar uma ação.

  9. Selecione o fluxo Get Property.

  10. Selecione a variável NumberofBedrooms para o parâmetro de entrada Bedrooms.

  11. Selecione os três pontos em Qual propriedade você deseja ver? nó de pergunta e selecione Excluir.

  12. Selecione o ícone + no nó de ação e selecione Enviar uma mensagem.

  13. No campo Digite uma mensagem, insira o seguinte texto:

    Property

  14. Selecione o ícone Inserir variável e selecione a variável PropertyName.

  15. Selecione Salvar.

  16. Selecione Publicar e Publicar.

Criar fluxo do Power Automate para fazer uma reserva

  1. Selecione seu agente no painel Agentes no lado esquerdo da tela para retornar à guia Visão geral.

  2. Selecione a guia Ações.

  3. Selecione + Adicionar uma ação.

  4. Role para baixo e selecione Criar um novo fluxo.

  5. Selecione Executar um Fluxo do Copilot no canto superior esquerdo da tela e insira Create Booking Request como o nome do fluxo.

  6. Selecione a etapa do gatilho Executar um fluxo do Copilot e selecione + Adicionar uma entrada.

  7. Selecione Texto.

  8. Insira PropertyId para Entrada e Property para Insira sua entrada.

  9. Selecione + Adicionar uma entrada.

  10. Selecione Texto.

  11. Insira ViewerName para Entrada e Viewer Name para Insira sua entrada.

  12. Selecione + Adicionar uma entrada.

  13. Selecione Texto.

  14. Insira ViewerEmail para Entrada e Viewer Email para Insira sua entrada.

  15. Selecione o ícone + entre as duas etapas do fluxo e selecione Adicionar uma ação.

  16. Insira Dataverse no campo Pesquisar e selecione Ver mais para o conector do Dataverse.

  17. Selecione a ação Adicionar uma nova linha.

  18. Selecione Booking Requests para o nome da tabela.

  19. Selecione Mostrar tudo.

  20. Insira Agent booking no campo Booking Name.

  21. Insira contoso_bookingrequests() no campo Propriedade (Propriedades Imobiliárias), mova o cursor entre colchetes e use Conteúdo dinâmico para selecionar o parâmetro PropertyId.

  22. Use Conteúdo dinâmico para selecionar o parâmetro ViewerName para o campo Viewer Name.

  23. Use Conteúdo dinâmico para selecionar o parâmetro ViewerEmail para o campo Viewer Email.

  24. Selecione a ação Responder ao Copilot.

  25. Selecione Configurações.

  26. Verifique se a Resposta Assíncrona está definida como Desativada.

  27. Selecione Salvar rascunho.

  28. Selecione Publicar.

  29. Feche a guia Power Automate.

Adicionar uma ação do agente para criar uma solicitação de reserva

  1. Selecione Atualizar.

  2. Selecione o fluxo Create Booking Request.

  3. Selecione Avançar.

  4. Selecione Avançar.

  5. Selecione Concluir.

  6. Selecione a guia Tópicos.

  7. Selecione o tópico Book a Real Estate Showing.

  8. Selecione o ícone + abaixo do nó Em que data e horário deseja ver o imóvel? e selecione Chamar uma ação.

  9. Selecione o fluxo Create Booking Request.

  10. Selecione a variável PropertyId para o parâmetro de entrada PropertyId.

  11. Selecione a variável Name para o parâmetro de entrada ViewerName.

  12. Selecione a variável EmailAddress para o parâmetro de entrada ViewerEmail.

  13. Selecione o ícone + abaixo do nó de ação. Selecione Gerenciamento de tópicos, Acessar outro tópico e, depois, selecione Fim da conversa.

  14. Selecione Salvar.

  15. Selecione Publicar e Publicar.

Testar o agente e fazer uma ordem de reserva

  1. Selecione o botão Testar no canto superior direito da tela para abrir o painel de teste.

  2. Selecione os três pontos na parte superior do painel de teste no canto superior direito da tela.

  3. Selecione Rastrear entre tópicos.

  4. Selecione o ícone Iniciar uma nova conversa na parte superior do painel de teste.

  5. Quando a mensagem de Início de Conversa for exibida, seu agente iniciará uma conversa. Em resposta, insira uma frase de gatilho para o tópico que você criou:

    I want to book a real estate showing

  6. Insira as seguintes informações:

    Name: <Your name>
    Email address: <Your email address>
    
  7. Após você fornecer as informações, um cartão adaptável exibe as informações inseridas, uma pergunta indagando se as informações estão corretas e opções para selecionar Sim ou Não.

  8. Selecione Sim.

  9. Selecione Casa para o prompt do tipo de propriedade.

  10. Insira 2 para os prompts de número de quartos.

  11. Insira Tomorrow 2:00 PM para o prompt Em que data e horário deseja ver o imóvel?.

  12. Selecione Sim para o prompt Isso respondeu a sua pergunta?.

  13. Selecione qualquer classificação.

  14. Selecione Não para o prompt Posso ajudar com algo mais?.

Verificar a ordem de reserva

  1. Navegue até o Power Apps maker portal.

  2. No painel de navegação esquerdo, selecione Tabelas e Personalizado.

  3. Selecione a tabela Solicitação de Reserva.

  4. Em Colunas e dados de Booking Request, você verá que uma solicitação de reserva do agente foi criada.