Tutorial: Criar uma função para integrar no Azure Logic Apps

  • Artigo

As Funções do Azure integram-se com o Azure Logic Apps no Estruturador de Aplicações Lógicas. Esta integração permite-lhe utilizar o poder de computação das Funções em orquestrações com outros serviços do Azure e de terceiros.

Este tutorial mostra-lhe como criar um fluxo de trabalho para analisar a atividade do Twitter. À medida que os tweets são avaliados, o fluxo de trabalho envia notificações quando são detetados sentimentos positivos.

Neste tutorial, irá aprender a:

  • Criar um Recurso de API dos serviços de IA do Azure.
  • Criar uma função que categoriza sentimentos de tweet.
  • Criar uma aplicação lógica que se liga ao Twitter.
  • Adicionar a deteção de sentimento à aplicação lógica.
  • Ligar a aplicação lógica à função.
  • Enviar um e-mail com base na resposta da função.

Pré-requisitos

Nota

Se quiser utilizar o conector do Gmail, apenas as contas empresariais do G-Suite podem utilizar este conector sem restrições nas aplicações lógicas. Se tiver uma conta de consumidor do Gmail, pode utilizar o conector do Gmail apenas com aplicações e serviços aprovados pelo Google específicos ou pode criar uma aplicação cliente Google para utilizar para autenticação no seu conector do Gmail.

Para obter mais informações, veja Políticas de privacidade e segurança de dados para conectores do Google no Azure Logic Apps.

Criar Análise de Texto recurso

As APIs dos serviços de IA do Azure estão disponíveis no Azure como recursos individuais. Utilize a API Análise de Texto para detetar o sentimento dos tweets publicados.

  1. Inicie sessão no portal do Azure.

  2. Selecione Criar um recurso no canto superior esquerdo do portal do Azure.

  3. Em Categorias, selecione IA + Machine Learning

  4. Em Análise de Texto, selecione Criar.

  5. Introduza os seguintes valores no ecrã Criar Análise de Texto.

    Definição Valor Observações
    Subscrição O nome da subscrição do Azure
    Grupo de recursos Criar um novo grupo de recursos com o nome tweet-sentiment-tutorial Mais tarde, irá eliminar este grupo de recursos para remover todos os recursos criados durante este tutorial.
    Região Selecione a região mais próxima de si
    Name TweetSentimentApp
    Escalão de preço Selecione F0 Gratuito

  6. Selecione Rever + criar.

  7. Selecione Criar.

  8. Assim que a implementação estiver concluída, selecione Ir para Recurso.

Obter definições de Análise de Texto

Com o recurso Análise de Texto criado, irá copiar algumas definições e guardá-las para utilização posterior.

  1. Selecione Chaves e Ponto Final.

  2. Copie a Chave 1 clicando no ícone no final da caixa de entrada.

  3. Cole o valor num editor de texto.

  4. Copie o Ponto Final clicando no ícone no final da caixa de entrada.

  5. Cole o valor num editor de texto.

Criar a aplicação de funções

  1. Na caixa de pesquisa superior, procure e selecione Aplicação de funções.

  2. Selecione Criar.

  3. Introduza os seguintes valores.

    Definições Valor sugerido Observações
    Subscrição O nome da subscrição do Azure
    Grupo de recursos tweet-sentiment-tutorial Utilize o mesmo nome do grupo de recursos ao longo deste tutorial.
    Nome da Aplicação de Funções TweetSentimentAPI + um sufixo exclusivo Os nomes das aplicações de funções são globalmente exclusivos. Os carateres válidos são a-z (não sensível a maiúsculas e minúsculas), 0-9 e -.
    Publicar Código
    Pilha de runtime .NET O código de função fornecido está em C#.
    Versão Selecione o número da versão mais recente
    Região Selecione a região mais próxima de si

  4. Selecione Rever + criar.

  5. Selecione Criar.

  6. Assim que a implementação estiver concluída, selecione Ir para Recurso.

Criar uma função acionada por HTTP

  1. No menu esquerdo da janela Funções , selecione Funções.

  2. Selecione Adicionar no menu superior e introduza os seguintes valores.

    Definição Valor Observações
    Ambiente de programação Desenvolver no portal
    Modelo Acionador HTTP
    Nova Função TweetSentimentFunction Este é o nome da sua função.
    Nível de autorização Function

  3. Selecione o botão Adicionar .

  4. Selecione o botão Código + Teste .

  5. Cole o seguinte código na janela do editor de código.

    #r "Newtonsoft.Json"

using System;
using System.Net;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Primitives;
using Newtonsoft.Json;

public static async Task<IActionResult> Run(HttpRequest req, ILogger log)
{

    string requestBody = String.Empty;
    using (StreamReader streamReader =  new  StreamReader(req.Body))
    {
        requestBody = await streamReader.ReadToEndAsync();
    }

    dynamic score = JsonConvert.DeserializeObject(requestBody);
    string value = "Positive";

    if(score < .3)
    {
        value = "Negative";
    }
    else if (score < .6) 
    {
        value = "Neutral";
    }

    return requestBody != null
        ? (ActionResult)new OkObjectResult(value)
       : new BadRequestObjectResult("Pass a sentiment score in the request body.");
}

    É transmitida uma classificação de sentimento para a função, que devolve um nome de categoria para o valor.

  6. Selecione o botão Guardar na barra de ferramentas para guardar as alterações.

    Nota

    Para testar a função, selecione Testar/Executar no menu superior. No separador Entrada , introduza um valor de 0.9 na caixa Entrada do corpo e, em seguida, selecione Executar. Verifique se é devolvido um valor de Positivo na caixa de conteúdo de resposta HTTP na secção Saída .

Em seguida, crie uma aplicação lógica que se integra com Funções do Azure, Twitter e a API de serviços de IA do Azure.

Criar uma aplicação lógica

  1. Na caixa de pesquisa superior, procure e selecione Logic Apps.

  2. Selecione Adicionar.

  3. Selecione Consumo e introduza os seguintes valores.

    Definições Valor sugerido
    Subscrição O nome da subscrição do Azure
    Grupo de recursos tweet-sentiment-tutorial
    Nome da aplicação lógica TweetSentimentApp
    Region Selecione a região mais próxima de si, de preferência a mesma região que selecionou nos passos anteriores.

    Aceitar valores predefinidos para todas as outras definições.

  4. Selecione Rever + criar.

  5. Selecione Criar.

  6. Quando a implementação estiver concluída, selecione Ir para Recurso.

  7. Selecione o botão Aplicação Lógica em Branco .

    Botão Aplicação Lógica em Branco

  8. Selecione o botão Guardar na barra de ferramentas para guardar o seu progresso.

Agora, pode utilizar a Designer do Logic Apps para adicionar serviços e acionadores à sua aplicação.

Ligar ao Twitter

Crie uma ligação ao Twitter para que a sua aplicação possa consultar novos tweets.

  1. Procure Twitter na caixa de pesquisa superior.

  2. Selecione o ícone do Twitter .

  3. Selecione o acionador Quando um novo tweet é publicado.

  4. Introduza os seguintes valores para configurar a ligação.

    Definição Valor
    Nome da ligação MyTwitterConnection
    Tipo de Autenticação Utilizar a aplicação partilhada predefinida

  5. Selecione Iniciar sessão.

  6. Siga as instruções na janela de pop-up para concluir o início de sessão no Twitter.

  7. Em seguida, introduza os seguintes valores na caixa Quando um novo tweet é publicado .

    Definição Valor
    Texto da pesquisa #my-twitter-tutorial
    Com que frequência pretende procurar itens? 1 na caixa de texto e
    Hora na lista pendente. Pode introduzir valores diferentes, mas não se esqueça de rever as limitações atuais do conector do Twitter.

  8. Selecione o botão Guardar na barra de ferramentas para guardar o seu progresso.

Em seguida, ligue-se à análise de texto para detetar o sentimento dos tweets recolhidos.

Adicionar Análise de Texto deteção de sentimentos

  1. Selecione Novo passo.

  2. Procure Análise de Texto na caixa de pesquisa.

  3. Selecione o ícone Análise de Texto.

  4. Selecione Detetar Sentimento e introduza os seguintes valores.

    Definição Valor
    Nome da ligação TextAnalyticsConnection
    Chave de Conta Cole a chave de conta Análise de Texto que reservou anteriormente.
    Site URL Cole no ponto final Análise de Texto que reservou anteriormente.

  5. Selecione Criar.

  6. Clique no interior da caixa Adicionar novo parâmetro e selecione a caixa junto a documentos que aparecem no pop-up.

  7. Clique no ID dos documentos - 1 caixa de texto para abrir o pop-up de conteúdo dinâmico.

  8. Na caixa de pesquisa de conteúdo dinâmico , procure id e clique em ID do Tweet.

  9. Clique dentro da caixa de texto Texto - 1 dos documentos para abrir o pop-up de conteúdo dinâmico.

  10. Na caixa de pesquisa de conteúdo dinâmico , procure texto e clique em Texto do tweet.

  11. Em Escolher uma ação, escreva Análise de Texto e clique na ação Detetar sentimento.

  12. Selecione o botão Guardar na barra de ferramentas para guardar o seu progresso.

A caixa Detetar Sentimento deve ser semelhante à seguinte captura de ecrã.

Detetar definições de Sentimento

Ligar a saída de sentimento ao ponto final de função

  1. Selecione Novo passo.

  2. Procure Funções do Azure na caixa de pesquisa.

  3. Selecione o ícone Funções do Azure.

  4. Procure o nome da função na caixa de pesquisa. Se seguiu a documentação de orientação acima, o nome da função começa com TweetSentimentAPI.

  5. Selecione o ícone de função.

  6. Selecione o item TweetSentimentFunction .

  7. Clique dentro da caixa Corpo do Pedido e selecione o item de classificaçãoDetetar Sentimento na janela de pop-up.

  8. Selecione o botão Guardar na barra de ferramentas para guardar o seu progresso.

Adicionar passo condicional

  1. Selecione o botão Adicionar uma ação .

  2. Clique dentro da caixa Controlo e procure e selecione Controlo na janela de pop-up.

  3. Selecione Condição.

  4. Clique dentro da caixa Escolher um valor e selecione o item TweetSentimentFunctionBody na janela de pop-up.

  5. Introduza Positivo na caixa Escolher um valor .

  6. Selecione o botão Guardar na barra de ferramentas para guardar o seu progresso.

Adicionar notificações por e-mail

  1. Na caixa Verdadeiro , selecione o botão Adicionar uma ação .

  2. Procure e selecione Office 365 Outlook na caixa de texto.

  3. Procure enviar e selecione Enviar um e-mail na caixa de texto.

  4. Selecione o botão Iniciar sessão .

  5. Siga as instruções na janela de pop-up para concluir o início de sessão no Office 365 Outlook.

  6. Introduza o seu endereço de e-mail na caixa Para .

  7. Clique dentro da caixa Assunto e clique no item Corpo em TweetSentimentFunction. Se o item Corpo não for apresentado na lista, clique na ligação Ver mais para expandir a lista de opções.

  8. Depois do item Corpo no Assunto, introduza o texto Tweet de:.

  9. Após o tweet de: texto, clique novamente na caixa e selecione Nome de utilizador na lista de opções Quando um novo tweet é publicado .

  10. Clique dentro da caixa Corpo e selecione Texto do tweet na lista de opções Quando um novo tweet é publicado . Se o item de texto do Tweet não for apresentado na lista, clique na ligação Ver mais para expandir a lista de opções.

  11. Selecione o botão Guardar na barra de ferramentas para guardar o seu progresso.

A caixa de e-mail deverá ter agora o aspeto desta captura de ecrã.

Notificação por e-mail

Executar o fluxo de trabalho

  1. A partir da sua conta do Twitter, tweete o seguinte texto: Estou a gostar de #my-twitter-tutorial.

  2. Regresse à Designer do Logic Apps e selecione o botão Executar.

  3. Verifique se existe uma mensagem do fluxo de trabalho no seu e-mail.

Limpar os recursos

Para limpar todos os serviços e contas do Azure criados durante este tutorial, elimine o grupo de recursos.

  1. Procure Grupos de recursos na caixa de pesquisa superior.

  2. Selecione o tweet-sentiment-tutorial.

  3. Selecione Eliminar grupo de recursos

  4. Introduza tweet-sentiment-tutorial na caixa de texto.

  5. Selecione o botão Eliminar.

Opcionalmente, poderá querer voltar à sua conta do Twitter e eliminar quaisquer tweets de teste do seu feed.

Passos seguintes

Criar uma API sem servidor com as Funções do Azure