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

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 de Funções em orquestrações com outros serviços Azure e 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 Cognitivos.
  • 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 de negócios da G-Suite podem utilizar este conector sem restrições em aplicações lógicas. Se tiver uma conta de consumo do Gmail, pode utilizar o conector do Gmail apenas com aplicações e serviços específicos aprovados pela Google, ou pode criar uma aplicação de cliente da Google para utilizar para autenticação no seu conector Gmail.

Para obter mais informações, consulte as políticas de segurança de dados e privacidade para conectores google em Azure Logic Apps.

Criar recurso de Análise de Texto

As APIs dos Serviços Cognitivos estão disponíveis no Azure como recursos individuais. Utilize a API de 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 Analítica de Texto.

    Definição Valor Observações
    Subscrição O seu nome de subscrição Azure
    Grupo de recursos Criar um novo grupo de recursos chamado tweet-sentiment-tutorial Mais tarde, elimina 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 grátis
  6. Selecione Rever + criar.

  7. Selecione Criar.

  8. Uma vez concluída a implementação, selecione Ir para o Recurso.

Obtenha definições de Análise de Texto

Com o recurso Text Analytics criado, irá copiar algumas definições e reserve-as para utilização posterior.

  1. Selecione Chaves e Ponto final.

  2. Copiar a tecla 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. A partir da caixa de pesquisa superior, procure e selecione a aplicação Função.

  2. Selecione Criar.

  3. Introduza os seguintes valores.

    Definição Valor sugerido Observações
    Subscrição O seu nome de subscrição Azure
    Grupo de recursos tweet-sentiment-tutorial Utilize o mesmo nome de grupo de recursos durante este tutorial.
    Nome da Aplicação de Funções TweetSentimentAPI + um sufixo único Os nomes das aplicações de funções são globalmente únicos. 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 previsto para si 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. Uma vez concluída a implementação, selecione Ir para o Recurso.

Criar uma função acionada por HTTP

  1. A partir do menu esquerdo da janela Funções, selecione Funções.

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

    Definição Valor Observações
    Ambiente de programação Desenvolver em portal
    Modelo HTTP Trigger
    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.");
    }
    

    Uma pontuação de sentimento é passada 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 Teste/Executar a partir do menu superior. No separador Entrada, introduza um valor na caixa de 0.9 entrada do Corpo e, em seguida, selecione Executar. Verifique se o valor positivo é devolvido na caixa de conteúdo de resposta HTTP na secção Saída.

Em seguida, crie uma app lógica que se integre com Azure Functions, Twitter e a API de Serviços Cognitivos.

Criar uma aplicação lógica

  1. A partir da caixa de pesquisa superior, procure e selecione Aplicações Lógicas.

  2. Selecione Adicionar.

  3. Selecione Consumo e introduza os seguintes valores.

    Definição Valor sugerido
    Subscrição O seu nome de subscrição Azure
    Grupo de recursos tweet-sentiment-tutorial
    Nome de aplicativo lógico TweetSentimentApp
    Region Selecione a região mais próxima, de preferência a mesma região que selecionou em etapas anteriores.

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

  4. Selecione Rever + criar.

  5. Selecione Criar.

  6. Uma vez concluída a implementação, selecione Ir para o Recurso.

  7. Selecione o botão Blank Logic App.

    Botão de aplicativo de lógica em branco

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

Agora pode utilizar o Design de Aplicações Lógicas para adicionar serviços e gatilhos à sua aplicação.

Ligar ao Twitter

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

  1. Procure no 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 Utilize a aplicação partilhada padrão
  5. Selecione Iniciar sessão.

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

  7. Em seguida, insira os seguintes valores na caixa de tweet quando um novo tweet é publicado.

    Definição Valor
    Texto da pesquisa #my-twitter-tutorial
    Como o forno quer verificar se há itens? 1 na caixa de texto, e
    Hora no dropdown. Pode introduzir valores diferentes, mas certifique-se de rever as limitações atuais do conector do Twitter.
  8. Selecione o botão Guardar na barra de ferramentas para evitar o seu progresso.

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

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

  1. Selecione Novo passo.

  2. Procure por Text Analytics na caixa de pesquisa.

  3. Selecione o ícone Text Analytics.

  4. Selecione Detetar Sentimento e introduza os seguintes valores.

    Definição Valor
    Nome da ligação TextAnalyticsConnection
    Chave de conta Cole na chave da conta Text Analytics que tenha reservado anteriormente.
    Site URL Cole no ponto final text Analytics que tenha reservado anteriormente.
  5. Selecione Criar.

  6. Clique dentro da caixa de parâmetros Novo Add e verifique a caixa ao lado de 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 dinâmica de conteúdos, procure o id e clique no id do Tweet.

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

  10. Na caixa de pesquisa dinâmica de conteúdos, procure por texto e clique no 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 evitar o seu progresso.

A caixa deteto sentimento deve parecer a seguinte imagem.

Detetar definições de sentimento

Conecte a saída do sentimento ao ponto final da função

  1. Selecione Novo passo.

  2. Procure funções Azure na caixa de pesquisa.

  3. Selecione o ícone Azure Functions.

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

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

  6. Selecione o item TweetSentimentFunction.

  7. Clique dentro da caixa ''Escolha's Feeling e selecione o item deteção de sentimento a partir da janela pop-up.

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

Adicionar passo condicional

  1. Selecione o botão Adicionar um botão de ação.

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

  3. Selecione Condição.

  4. Clique dentro da caixa de valor Escolha e selecione o item TweetSentimentFunction Body a partir da janela pop-up.

  5. Introduza Positivo na Caixa de Valor Escolher.

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

Adicionar notificações por e-mail

  1. Sob a caixa True, selecione o botão de ação Adicionar.

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

  3. Procurar por enviar e selecionar Enviar por email o artigo Texto( S.A. ' Pesse) para enviar e selecionar Enviar por email o artigo Texto( S.A. ' Pes

  4. Selecione o botão Iniciar sção.

  5. Siga as indicações na janela pop-up para concluir a sessão no Office 365 Outlook.

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

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

  8. Depois do artigo do Corpo no Sujeito, introduza o texto Tweet a partir de:.

  9. Depois do Tweet a partir de: texto, clique novamente na caixa e selecione o nome de utilizador da lista de opções quando um novo tweet é publicado.

  10. Clique dentro da caixa Body e selecione o texto tweet sob a lista de opções quando um novo tweet é publicado lista de opções. Se o item de texto do Tweet não estiver na lista, clique no link Ver mais para expandir a lista de opções.

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

A caixa de e-mail deve agora parecer com esta imagem.

Notificação por e-mail

Executar o fluxo de trabalho

  1. Na sua conta de Twitter, tweet o seguinte texto: Estou a gostar de #my-twitter-tutorial.

  2. Volte ao Designer de Aplicações Lógicas e selecione o botão Executar.

  3. Consulte o seu e-mail para obter uma mensagem do fluxo de trabalho.

Limpar os recursos

Para limpar todos os serviços e contas da 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. Insira tweet-sentiment-tutorial na caixa de texto.

  5. Selecione o botão Eliminar.

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

Passos seguintes