Tutorial: Criar uma função para integrar com os Aplicativos Lógicos do Azure

Artigo
07/03/2024

As Funções do Azure integram-se com o Azure Logic Apps no Estruturador de Aplicações Lógicas. Essa integração permite que você use o poder de computação do Functions em orquestrações com outros serviços do Azure e de terceiros.

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 sentimentos positivos são detetados.

Neste tutorial, irá aprender a:

Crie um Recurso de API de 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

Uma conta do Twitter ativa.
Uma conta do Outlook.com (para o envio de notificações).

Nota

Se você quiser usar o conector do Gmail, apenas as contas comerciais do G-Suite podem usar esse conector sem restrições em aplicativos lógicos. Se tiver uma conta de consumidor 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 cliente Google para utilizar para autenticação no conector do Gmail.

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

Criar recurso de Análise de Texto

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

Inicie sessão no portal do Azure.
Selecione Criar um recurso no canto superior esquerdo do portal do Azure.
Em Categorias, selecione AI + Machine Learning
Em Análise de Texto, selecione Criar.

Insira os seguintes valores na tela Criar análise de texto.

Definição	Value	Observações
Subscrição	Seu nome de assinatura do Azure
Grupo de recursos	Crie um novo grupo de recursos chamado tweet-sentiment-tutorial	Mais tarde, exclua esse grupo de recursos para remover todos os recursos criados durante este tutorial.
País/Região	Selecione a região mais próxima de si
Nome	TweetSentimentApp
Escalão de preço	Selecione F0 Grátis

Selecione Rever + criar.
Selecione Criar.
Quando a implantação estiver concluída, selecione Ir para Recurso.

Obter configurações da Análise de Texto

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

Selecione Chaves e Ponto de extremidade.
Copie a tecla 1 clicando no ícone no final da caixa de entrada.
Cole o valor em um editor de texto.
Copie o Endpoint clicando no ícone no final da caixa de entrada.
Cole o valor em um editor de texto.

Criar a aplicação de funções

Na caixa de pesquisa superior, procure e selecione Aplicativo de função.
Selecione Criar.

Introduza os seguintes valores.

Definição	Valor sugerido	Observações
Subscrição	Seu nome de assinatura do Azure
Grupo de recursos	tweet-sentimento-tutorial	Use o mesmo nome de grupo de recursos ao longo deste tutorial.
Nome da Aplicação de Funções	TweetSentimentAPI + um sufixo exclusivo	Os nomes de aplicativos de função 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 da função fornecido para você está em C#.
Versão	Selecione o número da versão mais recente
País/Região	Selecione a região mais próxima de si

Selecione Rever + criar.
Selecione Criar.
Quando a implantação estiver concluída, selecione Ir para Recurso.

Criar uma função acionada por HTTP

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

Selecione Adicionar no menu superior e insira os seguintes valores.

Definição	Value	Observações
Ambiente de desenvolvimento	Desenvolver no portal
Template	Gatilho HTTP
Nova Função	Função TweetSentimentFunction	Este é o nome da sua função.
Nível de autorização	Função

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

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 é passada para a função, que retorna um nome de categoria para o valor.

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

Nota

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

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

Criar uma aplicação lógica

Na caixa de pesquisa superior, procure e selecione Aplicativos lógicos.
Selecione Adicionar.

Selecione Consumo e insira os seguintes valores.

Definição	Valor sugerido
Subscrição	Seu nome de assinatura do Azure
Grupo de recursos	tweet-sentimento-tutorial
Nome do aplicativo lógico	TweetSentimentApp
País/Região	Selecione a região mais próxima de você, de preferência a mesma região que você selecionou nas etapas anteriores.

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

Selecione Rever + criar.
Selecione Criar.
Quando a implantação estiver concluída, selecione Ir para Recurso.
Selecione o botão Aplicativo lógico em branco.
Selecione o botão Salvar na barra de ferramentas para salvar seu progresso.

Agora você pode usar o Logic Apps Designer para adicionar serviços e gatilhos ao seu aplicativo.

Ligar ao Twitter

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

Procure Twitter na caixa de pesquisa superior.
Selecione o ícone do Twitter .
Selecione o acionador Quando um novo tweet é publicado.
Insira os seguintes valores para configurar a conexão.

Definição Value

Nome da ligação MyTwitterConnection

Tipo de Autenticação Usar aplicativo compartilhado padrão
Selecione Iniciar sessão.
Siga as instruções na janela pop-up para concluir o login no Twitter.

Definição	Value
Nome da ligação	MyTwitterConnection
Tipo de Autenticação	Usar aplicativo compartilhado padrão

Em seguida, insira os seguintes valores na caixa Quando um novo tweet for publicado .

Definição	Value
Texto da pesquisa	#my-twitter-tutorial
Com que frequência pretende verificar os itens?	1 na caixa de texto, e Hora no menu suspenso. Você pode inserir valores diferentes, mas certifique-se de revisar as limitações atuais do conector do Twitter.

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

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

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

Selecione Novo passo.
Pesquise Análise de Texto na caixa de pesquisa.
Selecione o ícone Análise de texto.

Selecione Detetar sentimento e insira os seguintes valores.

Definição	Value
Nome da ligação	TextAnalyticsConnection
Chave de Conta	Cole a chave da conta do Text Analytics que você reservou anteriormente.
URL do site	Cole no ponto de extremidade da Análise de Texto que você reservou anteriormente.

Selecione Criar.
Clique dentro da caixa Adicionar novo parâmetro e marque a caixa ao lado dos documentos que aparecem no pop-up.
Clique dentro da caixa de texto Id - 1 dos documentos para abrir o pop-up de conteúdo dinâmico.
Na caixa de pesquisa de conteúdo dinâmico, procure por id e clique em Tweet id.
Clique dentro da caixa de texto Texto - 1 dos documentos para abrir o pop-up de conteúdo dinâmico.
Na caixa de pesquisa de conteúdo dinâmico, procure texto e clique em Tweetar texto.
Em Escolher uma ação, escreva Análise de Texto e clique na ação Detetar sentimento.
Selecione o botão Salvar na barra de ferramentas para salvar seu progresso.

A caixa Detetar sentimento deve se parecer com a captura de tela a seguir.

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

Selecione Novo passo.
Procure o Azure Functions na caixa de pesquisa.
Selecione o ícone Azure Functions .
Procure o nome da sua função na caixa de pesquisa. Se você seguiu as orientações acima, o nome da função começa com TweetSentimentAPI.
Selecione o ícone de função.
Selecione o item TweetSentimentFunction .
Clique dentro da caixa Corpo da solicitação e selecione o item de pontuação Detetar sentimento na janela pop-up.
Selecione o botão Salvar na barra de ferramentas para salvar seu progresso.

Adicionar etapa condicional

Selecione o botão Adicionar uma ação .
Clique dentro da caixa Controle e procure e selecione Controle na janela pop-up.
Selecione Condição.
Clique dentro da caixa Escolha um valor e selecione o item Corpo TweetSentimentFunction na janela pop-up.
Insira Positivo na caixa Escolha um valor.
Selecione o botão Salvar na barra de ferramentas para salvar seu progresso.

Adicionar notificações por e-mail

Na caixa Verdadeiro, selecione o botão Adicionar uma ação.
Procure e selecione Office 365 Outlook na caixa de texto.
Procure enviar e selecione Enviar um e-mail na caixa de texto.
Selecione o botão Entrar .
Siga as instruções na janela pop-up para concluir a entrada no Office 365 Outlook.
Introduza o seu endereço de e-mail na caixa Para .
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.
Após o item Corpo no Assunto, insira o texto Tweet de:.
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 publicado .
Clique dentro da caixa Corpo e selecione Tweetar texto na lista de opções Quando um novo tweet é publicado . Se o item de texto Tweetar não for mostrado na lista, clique no link Ver mais para expandir a lista de opções.
Selecione o botão Salvar na barra de ferramentas para salvar seu progresso.

A caixa de e-mail agora deve se parecer com esta captura de tela.

Executar o fluxo de trabalho

A partir da sua conta do Twitter, tweet o seguinte texto: Estou gostando de #my-twitter-tutorial.
Retorne ao Designer de Aplicativos Lógicos e selecione o botão Executar .
Verifique se há uma mensagem do fluxo de trabalho no seu e-mail.

Clean up resources (Limpar recursos)

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

Pesquisar grupos de recursos na caixa de pesquisa superior.
Selecione o tweet-sentiment-tutorial.
Selecione Excluir grupo de recursos
Digite tweet-sentiment-tutorial na caixa de texto.
Selecione o botão Eliminar.

Opcionalmente, você pode querer retornar à sua conta do Twitter e excluir todos os tweets de teste do seu feed.

Próximos passos

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

Partilhar via