Chamar uma ação para efetuar pull nos dados do Dataverse for Teams
Com o nó Chamar uma ação, os agentes podem interagir com fluxos do Power Automate. Você pode usar esses fluxos para disparar processos automatizados ou estabelecer conexão com dados do Dataverse for Teams, Listas da Microsoft ou outras fontes de dados.
Por exemplo, o agente Event Contacts pode fornecer uma tabela do Dataverse for Teams aos membros da equipe de Sales Project. Em vez de editar o agente quando são feitas alterações nessa equipe, você pode atualizar a tabela.
Etapa 1: Criar uma tabela do Dataverse for Teams
Para criar uma tabela do Dataverse for Teams, siga estas etapas:
Crie uma tabela do Dataverse for Teams na mesma equipe do agente. Lembre-se de que você precisa criá-la usando o Power Apps para Teams. No Power Apps para Teams, selecione a guia Criar e selecione sua equipe.
Selecione Ver todos abaixo de Itens criados para [nome de sua equipe] para abrir a lista de Soluções de Equipe. A lista Soluções de Equipe inclui todos os aplicativos, agentes, Fluxos da nuvem, tabelas etc. que foram criados no Dataverse for Teams para a equipe selecionada. Se tiver selecionado a mesma equipe na qual criou seu agente de Event Contacts, você a verá na lista de Soluções.
Na faixa de opções Soluções de Equipe na parte superior, selecione Novo>Tabela.
Nomeie a nova tabela como Sales Project Team e selecione Salvar. Veja a seguir as colunas e os tipos de dados que serão usados:
| Coluna | Tipo de dados |
|---|---|
| Nome | Texto |
| Endereço de Email |
Você precisará adicionar a coluna Endereço de Email à tabela antes de prosseguir para a próxima etapa.
Adicione novas linhas para cada um dos quatro contatos.
Nome Endereço de Email Joseph Price JosephP@contoso.com Nathan Rigby NathanR@contoso.com Amber Rodriguez AmberR@contoso.com Monica Thomson MonicaT@contoso.com Ao concluir, retorne ao Microsoft Copilot Studio para Teams.
Etapa 2: criar um tópico de agente com uma etapa de Ação
Para adicionar uma ação, siga estas etapas:
No Microsoft Copilot Studio para Teams, selecione a guia Agentes na faixa de opções e localize/selecione o agente Event Contacts para abri-lo.
Vá para a lista de Tópicos.
Crie um novo tópico selecionando Novo tópico>Em branco na faixa de opções Tópicos. Para nomear o tópico, selecione Detalhes na faixa de opções. Digite "Sales Project Team" no campo Nome.
Selecione Frases de gatilho, insira cada uma das seguintes opções e pressione + após cada entrada:
sales project teamsales project infosales team infosales project memberssales project infoNa tela de criação no nó Mensagem, insira:
Let me look up the Sales Project Team!
Agora, selecione o botão Salvar na faixa de opções para salvar seu tópico. Quaisquer alterações que você não tenha salvo no momento poderão ser perdidas quando você alternar para o Power Automate a fim de criar o fluxo.
Adicione um novo nó depois do nó de Mensagem e selecione Chamar uma ação > Criar um fluxo. O Copilot Studio pode apresentar uma caixa de opção para lembrá-lo de salvar seu tópico antes de sair. Se você já o salvou, selecione Sair. Essa ação abre o Power Automate Studio no Copilot Studio.
Há alguns modelos comuns disponíveis para escolha imediata. Cada modelo permite que as informações sejam passadas para o fluxo quando ele é disparado. À medida que o fluxo termina, ele pode repassar informações ao agente. Se quiser ver mais algumas opções de modelos, você poderá selecionar Ver mais modelos. Veja a seguir os modelos mais relevantes:
Modelo de Fluxo do Copilot Studio: esse modelo só tem as etapas para receber e enviar informações ao agente.
Enviar uma mensagem para um canal do Teams: dispara uma mensagem do Teams pelo agente.
Enviar um cartão adaptável a um canal do Teams: dispara um cartão adaptável para fornecer informações a um canal do Teams.
Selecione aquele chamado Modelo de Fluxo do Copilot Studio. Ao fazer isso, seu gatilho será Copilot Studio, e você terá uma etapa abaixo chamada Valor(es) de retorno para Copilot Studio.
Renomeie o fluxo como Get Sales Team Members.
Crie uma variável para conter as informações que você deseja fornecer de volta para o agente. Entre o gatilho e a etapa do valor de retorno, mova o cursor até a seta, selecione o ícone Inserir nova etapa que é exibido ao passar o mouse nesse espaço e selecione Adicionar uma ação.
Na caixa de pesquisa, insira "variável" e depois, em Ações, selecione Inicializar variável.
Insira "varContactInfo" como Nome e selecione Cadeia de Caracteres como tipo. Deixe o Valor em branco.
Agora precisamos de uma etapa para acessar os dados do Dataverse pelo Teams. Na nova etapa Inicializar variável, selecione o ícone Inserir nova etapa e selecione Adicionar uma ação. Procure o conector do Microsoft Dataverse e selecione Listar Linhas como o gatilho.
Para Nome da tabela, selecione Sales Project Team no menu suspenso. (Você pode inserir "sales" no campo de entrada para filtrar rapidamente a lista.)
A ação Listar linhas efetua pull de todas as linhas da tabela para uma matriz. Uma matriz é uma tabela. Para adicionar dados à variável string, você precisa passar por cada linha da tabela e adicionar cada linha de dados à variável varContactInfo. É assim que passaremos esses dados de volta ao Microsoft Copilot Studio.
Selecione o ícone Inserir nova etapa depois de Listar linhas. Selecione Adicionar uma ação.
Na caixa de pesquisa, insira Controle e depois, em Ações, selecione Aplicar a cada.
No campo Selecionar uma saída de etapas anteriores, selecione-a para adicionar Conteúdo dinâmico. Em seguida, selecione o valor na ação Linhas da lista do Dataverse.
Selecione Adicionar uma ação em Aplicar a cada etapa para continuar.
Na caixa de pesquisa Escolher e operação, insira variável e, em Ações, selecione Acrescentar à variável de cadeia de caracteres.
Na etapa Anexar à variável de matriz, selecione varContactInfo para o Nome.
Para o Valor, vamos criar uma lista com marcadores multilinhas (como dados de cadeia de caracteres) com o nome e email de cada pessoa. O Power Automate usa a sintaxe do Markdown ao formatar texto. Para indicar uma lista com marcadores no Markdown, você usará o caractere asterisco * no início da linha. (Para saber mais sobre o Markdown, consulte a seção Resumo no final deste módulo.)
Na caixa de texto Valor:
Insira um asterisco * e adicione um espaço.
No conteúdo dinâmico Listar linhas, selecione Nome e adicione um espaço.
No conteúdo dinâmico Listar linhas, selecione Endereço de Email.
Pressione Enter para começar uma nova linha.
Concluímos esta etapa.
Selecione a etapa Retornar valores para o Microsoft Copilot Studio na parte inferior do fluxo e selecione + Adicionar uma saída.
Selecione Texto como o tipo de saída.
Na caixa de texto Inserir Título, insira ContactData.
Para o campo Insira o valor para responder, selecione o campo de entrada e selecione varContactInfo na seção Variáveis.
Agora o fluxo deve ser semelhante à imagem a seguir:
Selecione Salvar na faixa de opções do Power Automate para concluir a edição do fluxo. O Power Automate executa automaticamente o Verificador de Fluxo para conferir se há problemas. Você pode ver um aviso sobre "...consultas de filtro OData...", mas pode ignorá-lo. Você pode usar filtros OData para limitar os dados que a etapa Listar linhas recupera, mas há apenas algumas linhas em nossa fonte de dados; portanto, um filtro é desnecessário. Selecione Fechar para sair do Power Automate e retornar ao editor do agente.
De volta ao editor do agente, observe a etapa de Ação. Você deverá ver o fluxo que acabou de criar: Get Sales Team Members como a ação e a variável de cadeia de caracteres ContactData que você criou listada como uma saída.
Adicione uma etapa Mostrar uma mensagem após o nó Ação.
Clique dentro da caixa de texto para exibir o menu. Selecione ContactData em Inserir variável {X}.
Selecione Salvar na faixa de opções de edição de tópico e aguarde até o tópico ser salvo. Se o painel Bot de teste não estiver visível, selecione a opção de menu Testar chatbot.
Na parte superior do painel Testar chatbot, verifique se a opção Rastreamento entre tópicos está ativada.
Insira uma das frases de gatilho para testar o agente da Sales Project Team. Seu agente de teste fornecerá uma lista com marcadores dos quatro nomes e endereços de email de sua Sales Project Team.
Parabéns. Agora você criou uma modo de o agente obter informações de tabelas de dados por meio de um fluxo integrado do Power Automate.