Tutorial: Criar uma função que se integra aos Aplicativos Lógicos do Azure

  • Artigo

O Azure Functions integra-se aos Aplicativos Lógicos do Azure no Designer de Aplicativos Lógicos. Essa integração permite que você use o poder da computação do Functions em orquestrações com outros serviços de terceiros e do Azure.

Este tutorial mostra 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 detectados sentimentos positivos.

Neste tutorial, você aprenderá a:

  • Criar um recurso de API dos serviços de IA do Azure.
  • Crie uma função que categorize o sentimento do tweet.
  • Crie um aplicativo lógico que se conecte ao Twitter.
  • Adicione a detecção de sentimento ao aplicativo lógico.
  • Conecte o aplicativo lógico à função.
  • Envie um email com base na resposta da função.

Pré-requisitos

Observação

Se você quiser usar o conector do Gmail, somente as contas comerciais do G Suite poderão usar esse conector sem restrições nos aplicativos lógicos. Se você tiver uma conta de consumidor do Gmail, poderá usar o conector do Gmail somente com serviços e aplicativos específicos do Google aprovados ou poderá criar um aplicativo cliente do Google para usar para autenticação no conector do Gmail.

Para obter mais informações, confira Políticas de privacidade e segurança de dados para os conectores do Google nos Aplicativos Lógicos do Azure.

Criar um recurso da Análise de Texto

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

  1. Entre 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, escolha Criar.

  5. Insira os valores a seguir na tela Criar Análise de Texto.

    Configuração Valor Comentários
    Subscription Seu nome da assinatura do Azure
    Grupo de recursos Crie um grupo de recursos chamado tweet-sentiment-tutorial Posteriormente, você excluirá esse grupo de recursos para remover todos os recursos criados durante este tutorial.
    Região Selecione a região mais próxima de você
    Nome TweetSentimentApp
    Tipo de preço Selecione Gratuito F0

  6. Selecione Examinar + criar.

  7. Selecione Criar.

  8. Após a conclusão da implantação, selecione Ir para o Recurso.

Obter as configurações da Análise de Texto

Com o recurso da Análise de Texto criado, você copiará algumas configurações e as deixará de lado para uso posterior.

  1. Selecione Chaves e Ponto de Extremidade.

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

  3. Cole o valor no editor de texto.

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

  5. Cole o valor no editor de texto.

Crie o aplicativo de funções

  1. Na caixa de pesquisa superior, procure e selecione Aplicativo de funções.

  2. Selecione Criar.

  3. Insira os valores a seguir.

    Configuração Valor sugerido Comentários
    Subscription Seu nome da assinatura do Azure
    Grupo de recursos tweet-sentiment-tutorial Use o mesmo nome de grupo de recursos durante este tutorial.
    Nome do aplicativo de funções TweetSentimentAPI + um sufixo exclusivo Os nomes dos aplicativos de funções são globalmente exclusivos. Os caracteres válidos são a-z (não diferencia maiúsculas de minúsculas), 0-9 e -.
    Publicação Código
    Pilha de runtime .NET O código de função fornecido para você está em C#.
    Versão Selecione o número da última versão
    Região Selecione a região mais próxima de você

  4. Selecione Examinar + criar.

  5. Selecione Criar.

  6. Após a conclusão da implantação, selecione Ir para o Recurso.

Criar uma função disparada por HTTP

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

  2. Selecione Adicionar no menu superior e insira os valores a seguir.

    Configuração Valor Comentários
    Ambiente de desenvolvimento Desenvolvimento no portal
    Modelo Gatilho HTTP
    Nova função TweetSentimentFunction Esse é o nome da sua política.
    Nível de autorização Função

  3. Selecione o botão Adicionar.

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

  5. Cole o código a seguir 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 é transmitida para a função, que retorna um nome de categoria para o valor.

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

    Observação

    Para testar a função, selecione Testar/Executar no menu superior. Na guia Entrada, insira um valor igual a 0.9 na caixa de entrada Corpo e selecione Executar. Verifique se um valor igual a Positivo é retornado na caixa Conteúdo da resposta HTTP na seção Saída.

Em seguida, crie um aplicativo lógico que se integra ao Azure Functions, ao Twitter e à API de serviços de IA do Azure.

Criar um aplicativo lógico

  1. Na caixa de pesquisa superior, procure e selecione Aplicativos Lógicos.

  2. Selecione Adicionar.

  3. Selecione Consumo e insira os valores a seguir.

    Configuração Valor sugerido
    Subscription Seu nome da assinatura do Azure
    Grupo de recursos tweet-sentiment-tutorial
    Nome do aplicativo lógico TweetSentimentApp
    Região Selecione a região mais próxima de você, preferivelmente, a mesma região que você selecionou nas etapas anteriores.

    Aceite os valores padrão para todas as outras configurações.

  4. Selecione Examinar + criar.

  5. Selecione Criar.

  6. Após a conclusão da implantação, selecione Ir para o Recurso.

  7. Selecione o botão Aplicativo Lógico em Branco.

    Botão Aplicativo Lógico em Branco

  8. Selecione o botão Salvar na barra de ferramentas para salvar o progresso.

Agora você pode usar o Designer de Aplicativos Lógicos para adicionar serviços e gatilhos ao aplicativo.

Conectar-se ao Twitter

Crie uma conexão com o Twitter para que o seu aplicativo possa sondar novos tweets.

  1. Procure Twitter na caixa de pesquisa superior.

  2. Selecione o ícone do Twitter.

  3. Selecione o gatilho Quando um novo Tweet é postado.

  4. Insira os valores a seguir para configurar a conexão.

    Configuração Valor
    Nome da conexão MyTwitterConnection
    Tipo de autenticação Usar um aplicativo compartilhado padrão

  5. Selecione Entrar.

  6. Siga os prompts na janela pop-up para concluir a entrada no Twitter.

  7. Depois, insira os valores a seguir na caixa Quando um novo tweet for postado.

    Configuração Valor
    Texto da pesquisa #my-twitter-tutorial
    Com que frequência você deseja verificar os itens? 1 na caixa de texto e
    Hora na lista suspensa. Você pode inserir valores diferentes, mas lembre-se de examinar as limitações atuais do conector do Twitter.

  8. Selecione o botão Salvar na barra de ferramentas para salvar o progresso.

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

Adicionar detecção de sentimento da Análise de Texto

  1. Selecione Nova etapa.

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

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

  4. Escolha Detectar Sentimento e insira os valores a seguir.

    Configuração Valor
    Nome da conexão TextAnalyticsConnection
    Chave de conta Cole a chave de conta da Análise de Texto reservada anteriormente.
    URL do site Cole o ponto de extremidade da Análise de Texto reservado anteriormente.

  5. Selecione Criar.

  6. Clique dentro da caixa Adicionar novo parâmetro e marque a caixa ao lado de Documentos exibida no pop-up.

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

  8. Na caixa de pesquisa Conteúdo dinâmico, pesquise por ID e clique na ID do tweet.

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

  10. Na caixa de pesquisa Conteúdo dinâmico, pesquise Texto e clique na Texto do tweet.

  11. Em Escolher uma ação, digite Análise de Textoe clique na ação Detectar sentimento.

  12. Selecione o botão Salvar na barra de ferramentas para salvar o progresso.

A caixa Detectar Sentimento será semelhante à captura de tela a seguir.

Configurações da caixa Detectar Sentimento

Conectar a saída de sentimento ao ponto de extremidade da função

  1. Selecione Nova etapa.

  2. Procure Azure Functions na caixa de pesquisa.

  3. Selecione o ícone do Azure Functions.

  4. Procure o nome da função na caixa de pesquisa. Se você seguiu as diretrizes acima, o nome da função começa com TweetSentimentAPI.

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

  6. Escolha o item TweetSentimentFunction.

  7. Clique dentro da caixa Corpo da Solicitação e selecione o item pontuação de Detectar Sentimento na janela pop-up.

  8. Selecione o botão Salvar na barra de ferramentas para salvar o progresso.

Adicionar etapa condicional

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

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

  3. Escolha Condição.

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

  5. Insira Positivo na caixa Escolher um valor.

  6. Selecione o botão Salvar na barra de ferramentas para salvar o progresso.

Adicionar notificações por email

  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 email na caixa de texto.

  4. Selecione o botão Entrar.

  5. Siga os prompts na janela pop-up para concluir a entrada no Office 365 Outlook.

  6. Insira seu endereço de email na caixa Para.

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

  8. Após o item Corpo no Assunto, insira o texto Tweet de: .

  9. Após o texto Tweet de: , clique na caixa novamente e selecione Nome de usuário na lista de opções Quando um novo tweet for postado.

  10. Clique dentro da caixa Corpo e selecione Texto do tweet na lista de opções Quando um novo tweet for postado. Se o item Texto do tweet não for mostrado na lista, clique no link Ver mais para expandir a lista de opções.

  11. Selecione o botão Salvar na barra de ferramentas para salvar o progresso.

A caixa de email agora será semelhante à esta captura de tela.

Notificação por email

Executar o fluxo de trabalho

  1. Na sua conta do Twitter, envie o seguinte tweet: Estou gostando do #my-twitter-tutorial.

  2. Volte ao Designer de Aplicativos Lógicos e selecione o botão Executar.

  3. Verifique no seu email se há uma mensagem do fluxo de trabalho.

Limpar os recursos

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

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

  2. Selecione tweet-sentiment-tutorial.

  3. Escolha Excluir grupo de recursos

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

  5. Selecione o botão Excluir.

Opcionalmente, o ideal é voltar à sua conta do Twitter e excluir todos os tweets de teste do feed.

Próximas etapas

Criar uma API sem servidor usando o Azure Functions