Partilhar via


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

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 X. À 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.
  • Crie um aplicativo lógico que se conecte ao X.
  • 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 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.

  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 AI + Machine Learning

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

  5. 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
  6. Selecione Rever + criar.

  7. Selecione Criar.

  8. 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.

  1. Selecione Chaves e Ponto de extremidade.

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

  3. Cole o valor em um editor de texto.

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

  5. Cole o valor em um editor de texto.

Criar a aplicação de funções

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

  2. Selecione Criar.

  3. 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
  4. Selecione Rever + criar.

  5. Selecione Criar.

  6. Quando a implantaçã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 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
  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 é passada 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.

    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, X e à API de serviços de IA do Azure.

Criar uma aplicação lógica

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

  2. Selecione Adicionar.

  3. 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.

  4. Selecione Rever + criar.

  5. Selecione Criar.

  6. Quando a implantação estiver concluída, selecione Ir para 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 seu progresso.

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

Ligar ao X

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

  1. Procure X na caixa de pesquisa superior.

  2. Selecione o ícone X.

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

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

    Definição Value
    Nome da ligação MyXConnection
    Tipo de Autenticação Usar aplicativo compartilhado padrão
  5. Selecione Iniciar sessão.

  6. Siga as instruções na janela pop-up para concluir o login no X.

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

    Definição Value
    Texto da pesquisa #my-x-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 X.
  8. 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

  1. Selecione Novo passo.

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

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

  4. 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.
  5. Selecione Criar.

  6. Clique dentro da caixa Adicionar novo parâmetro e marque a caixa ao lado dos documentos que aparecem no pop-up.

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

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

  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 Tweetar texto.

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

  12. 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.

Detetar configurações de sentimento

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

  1. Selecione Novo passo.

  2. Procure o Azure Functions na caixa de pesquisa.

  3. Selecione o ícone Azure Functions .

  4. 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.

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

  6. Selecione o item TweetSentimentFunction .

  7. Clique dentro da caixa Corpo da solicitação e selecione o item de pontuação Detetar sentimento na janela pop-up.

  8. Selecione o botão Salvar na barra de ferramentas para salvar seu 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. Selecione Condição.

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

  5. Insira Positivo na caixa Escolha um valor.

  6. Selecione o botão Salvar na barra de ferramentas para salvar 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 Entrar .

  5. Siga as instruções na janela pop-up para concluir a entrada 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 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 publicado .

  10. 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.

  11. 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.

Notificação por e-mail

Executar o fluxo de trabalho

  1. A partir da sua conta X, tweet o seguinte texto: Estou gostando de #my-x-tutorial.

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

  3. 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.

  1. Pesquisar grupos de recursos na caixa de pesquisa superior.

  2. Selecione o tweet-sentiment-tutorial.

  3. Selecione Excluir grupo de recursos

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

  5. Selecione o botão Eliminar.

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

Próximos passos