Udostępnij za pośrednictwem

Samouczek: tworzenie funkcji do integracji z usługą Azure Logic Apps

  • Artykuł

Usługa Azure Functions integruje się z usługą Azure Logic Apps w Projektancie aplikacji usługi Logic Apps. Ta integracja umożliwia korzystanie z mocy obliczeniowej usługi Functions w aranżacjach z innymi usługami platformy Azure i innych firm.

W tym samouczku pokazano, jak utworzyć przepływ pracy do analizowania działania X. W miarę oceniania tweetów przepływ pracy wysyła powiadomienia po wykryciu pozytywnych tonacji.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

  • Utwórz zasób interfejsu API usług AI platformy Azure.
  • Tworzenie funkcji kategoryzującej tonację w tweetach.
  • Utwórz aplikację logiki, która łączy się z platformą X.
  • Dodawanie wykrywania tonacji do aplikacji logiki.
  • Łączenie aplikacji logiki z funkcją.
  • Wysyłanie wiadomości e-mail na podstawie odpowiedzi z funkcji.

Wymagania wstępne

Uwaga

Jeśli chcesz używać łącznika Gmail, tylko konta biznesowe usługi G-Suite mogą używać tego łącznika bez ograniczeń w aplikacjach logiki. Jeśli masz konto użytkownika Gmail, możesz użyć łącznika Gmail tylko z określonymi aplikacjami i usługami zatwierdzonymi przez firmę Google lub utworzyć aplikację kliencką Google do użycia do uwierzytelniania w łączniku gmaila.

Aby uzyskać więcej informacji, zobacz Zasady zabezpieczeń i prywatności danych dla łączników Google w usłudze Azure Logic Apps.

Tworzenie zasobu analiza tekstu

Interfejsy API usług AI platformy Azure są dostępne na platformie Azure jako poszczególne zasoby. Użyj interfejsu API analiza tekstu, aby wykryć tonację opublikowanych tweetów.

  1. Zaloguj się w witrynie Azure Portal.

  2. W lewym górnym rogu witryny Azure Portal wybierz pozycję Utwórz zasób.

  3. W obszarze Kategorie wybierz pozycję Sztuczna inteligencja i uczenie maszynowe

  4. W obszarze analiza tekstu wybierz pozycję Utwórz.

  5. Wprowadź następujące wartości na ekranie Tworzenie analiza tekstu.

    Ustawienie Wartość Uwagi
    Subskrypcja Nazwa subskrypcji platformy Azure
    Grupa zasobów Tworzenie nowej grupy zasobów o nazwie tweet-sentiment-tutorial Później usuniesz tę grupę zasobów, aby usunąć wszystkie zasoby utworzone w tym samouczku.
    Region (Region) Wybierz region znajdujący się najbliżej Ciebie
    Nazwisko TweetSentimentApp
    Warstwa cenowa Wybierz pozycję Bezpłatna F0

  6. Wybierz pozycję Przejrzyj i utwórz.

  7. Wybierz pozycję Utwórz.

  8. Po zakończeniu wdrażania wybierz pozycję Przejdź do zasobu.

Pobieranie ustawień analiza tekstu

Po utworzeniu zasobu analiza tekstu skopiujesz kilka ustawień i odłożysz je do późniejszego użycia.

  1. Wybierz pozycję Klucze i punkt końcowy.

  2. Skopiuj klucz 1 , klikając ikonę na końcu pola wejściowego.

  3. Wklej wartość do edytora tekstów.

  4. Skopiuj punkt końcowy, klikając ikonę na końcu pola wejściowego.

  5. Wklej wartość do edytora tekstów.

Tworzenie aplikacji funkcji

  1. W górnym polu wyszukiwania wyszukaj i wybierz pozycję Aplikacja funkcji.

  2. Wybierz pozycję Utwórz.

  3. Wprowadź następujące wartości.

    Ustawienie Sugerowana wartość Uwagi
    Subskrypcja Nazwa subskrypcji platformy Azure
    Grupa zasobów tweet-sentiment-tutorial W tym samouczku użyj tej samej nazwy grupy zasobów.
    Nazwa aplikacji funkcji TweetSentimentAPI + unikatowy sufiks Nazwy aplikacji funkcji są globalnie unikatowe. Prawidłowe znaki to a-z (bez uwzględniania wielkości liter), 0-9i -.
    Publikowanie Kod
    Stos środowiska uruchomieniowego .NET Podany dla Ciebie kod funkcji znajduje się w języku C#.
    Wersja Wybierz najnowszy numer wersji
    Region (Region) Wybierz region znajdujący się najbliżej Ciebie

  4. Wybierz pozycję Przejrzyj i utwórz.

  5. Wybierz pozycję Utwórz.

  6. Po zakończeniu wdrażania wybierz pozycję Przejdź do zasobu.

Tworzenie funkcji wyzwalanej przez protokół HTTP

  1. W menu po lewej stronie okna Funkcje wybierz pozycję Funkcje.

  2. Wybierz pozycję Dodaj w górnym menu i wprowadź następujące wartości.

    Ustawienie Wartość Uwagi
    Środowisko projektowe Programowanie w portalu
    Template Wyzwalacz HTTP
    Nowa funkcja TweetSentimentFunction Jest to nazwa funkcji.
    Poziom autoryzacji Funkcja

  3. Kliknij przycisk Dodaj.

  4. Wybierz przycisk Kod i testowanie.

  5. Wklej następujący kod w oknie edytora kodu.

    #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.");
}

    Wynik tonacji jest przekazywany do funkcji, która zwraca nazwę kategorii dla wartości.

  6. Wybierz przycisk Zapisz na pasku narzędzi, aby zapisać zmiany.

    Uwaga

    Aby przetestować funkcję, wybierz pozycję Test/Uruchom w górnym menu. Na karcie Dane wejściowe wprowadź wartość 0.9 w polu Wprowadzanie treści, a następnie wybierz pozycję Uruchom. Sprawdź, czy wartość Dodatnia jest zwracana w polu zawartość odpowiedzi HTTP w sekcji Dane wyjściowe .

Następnie utwórz aplikację logiki, która integruje się z usługami Azure Functions, X i interfejsem API usług Azure AI.

Tworzenie aplikacji logiki

  1. W górnym polu wyszukiwania wyszukaj i wybierz pozycję Logic Apps.

  2. Wybierz Dodaj.

  3. Wybierz pozycję Zużycie i wprowadź następujące wartości.

    Ustawienie Sugerowana wartość
    Subskrypcja Nazwa subskrypcji platformy Azure
    Grupa zasobów tweet-sentiment-tutorial
    Nazwa aplikacji logiki TweetSentimentApp
    Region (Region) Wybierz region najbliżej Ciebie, najlepiej ten sam region, który został wybrany w poprzednich krokach.

    Zaakceptuj wartości domyślne dla wszystkich innych ustawień.

  4. Wybierz pozycję Przejrzyj i utwórz.

  5. Wybierz pozycję Utwórz.

  6. Po zakończeniu wdrażania wybierz pozycję Przejdź do zasobu.

  7. Wybierz przycisk Pusta aplikacja logiki.

    Przycisk Pusta aplikacja logiki

  8. Wybierz przycisk Zapisz na pasku narzędzi, aby zapisać postęp.

Teraz możesz użyć Projektanta aplikacji usługi Logic Apps, aby dodać usługi i wyzwalacze do aplikacji.

Nawiązywanie połączenia z platformą X

Utwórz połączenie z platformą X, aby aplikacja mogła sondować nowe tweety.

  1. Wyszukaj ciąg X w górnym polu wyszukiwania.

  2. Wybierz ikonę X .

  3. Wybierz wyzwalacz Po wysłaniu nowego tweetu.

  4. Wprowadź następujące wartości, aby skonfigurować połączenie.

    Ustawienie Wartość
    Nazwa połączenia MyXConnection
    Typ uwierzytelniania Użyj domyślnej aplikacji udostępnionej

  5. Wybierz Zaloguj.

  6. Postępuj zgodnie z monitami w oknie podręcznym, aby ukończyć logowanie do aplikacji X.

  7. Następnie wprowadź następujące wartości w polu Po opublikowaniu nowego tweetu.

    Ustawienie Wartość
    Wyszukaj tekst #my-x-tutorial
    Jak często chcesz sprawdzać dostępność elementów? 1 w polu tekstowym i
    Godzina na liście rozwijanej. Możesz wprowadzić różne wartości, ale pamiętaj, aby zapoznać się z bieżącymi ograniczeniami łącznika X.

  8. Wybierz przycisk Zapisz na pasku narzędzi, aby zapisać postęp.

Następnie połącz się z analizą tekstu, aby wykryć tonację zebranych tweetów.

Dodawanie wykrywania tonacji analiza tekstu

  1. Wybierz pozycję Nowy krok.

  2. Wyszukaj analiza tekstu w polu wyszukiwania.

  3. Wybierz ikonę analiza tekstu.

  4. Wybierz pozycję Wykryj tonację i wprowadź następujące wartości.

    Ustawienie Wartość
    Nazwa połączenia TextAnalyticsConnection
    Klucz konta Wklej wcześniej klucz konta analiza tekstu.
    Adres URL witryny Wklej wcześniej analiza tekstu punkt końcowy.

  5. Wybierz pozycję Utwórz.

  6. Kliknij wewnątrz pola Dodaj nowy parametr i zaznacz pole wyboru obok dokumentów wyświetlanych w wyskakującym okienku.

  7. Kliknij wewnątrz pola tekstowego Identyfikator dokumentów — 1 , aby otworzyć wyskakujące okienko zawartości dynamicznej.

  8. W polu wyszukiwania zawartości dynamicznej wyszukaj identyfikator i kliknij pozycję Identyfikator tweetu.

  9. Kliknij wewnątrz pola tekstowego Tekst — 1 , aby otworzyć wyskakujące okienko zawartości dynamicznej.

  10. W polu wyszukiwania zawartości dynamicznej wyszukaj tekst i kliknij pozycję Tekst tweetu.

  11. W obszarze Wybierz akcję wpisz Analiza tekstu, a następnie kliknij akcję Wykryj tonację.

  12. Wybierz przycisk Zapisz na pasku narzędzi, aby zapisać postęp.

Pole Wykryj tonację powinno wyglądać podobnie jak na poniższym zrzucie ekranu.

Wykrywanie ustawień tonacji

Łączenie danych wyjściowych tonacji z punktem końcowym funkcji

  1. Wybierz pozycję Nowy krok.

  2. Wyszukaj usługę Azure Functions w polu wyszukiwania.

  3. Wybierz ikonę usługi Azure Functions .

  4. Wyszukaj nazwę funkcji w polu wyszukiwania. Jeśli wykonano powyższe wskazówki, nazwa funkcji zaczyna się od tweetSentimentAPI.

  5. Wybierz ikonę funkcji.

  6. Wybierz element TweetSentimentFunction.

  7. Kliknij wewnątrz pola Treść żądania i wybierz element Wykryj ocenę tonacji w oknie podręcznym.

  8. Wybierz przycisk Zapisz na pasku narzędzi, aby zapisać postęp.

Dodawanie kroku warunkowego

  1. Wybierz przycisk Dodaj akcję.

  2. Kliknij wewnątrz pola Kontrolka, a następnie wyszukaj i wybierz pozycję Kontrolka w oknie podręcznym.

  3. Wybierz pozycję Warunek.

  4. Kliknij wewnątrz pola Wybierz wartość, a następnie wybierz element Treść TweetSentimentFunction w oknie podręcznym.

  5. Wprowadź wartość dodatnią w polu Wybierz wartość .

  6. Wybierz przycisk Zapisz na pasku narzędzi, aby zapisać postęp.

Dodawanie powiadomień w wiadomościach e-mail

  1. W polu True (Prawda) wybierz przycisk Dodaj akcję.

  2. Wyszukaj i wybierz pozycję Office 365 Outlook w polu tekstowym.

  3. Wyszukaj pozycję Wyślij i wybierz pozycję Wyślij wiadomość e-mail w polu tekstowym.

  4. Wybierz przycisk Zaloguj się.

  5. Postępuj zgodnie z monitami w oknie podręcznym, aby ukończyć logowanie do usługi Office 365 Outlook.

  6. Wprowadź swój adres e-mail w polu Do .

  7. Kliknij wewnątrz pola Temat i kliknij element Treść w obszarze TweetSentimentFunction. Jeśli element Treść nie jest wyświetlany na liście, kliknij link Zobacz więcej, aby rozwinąć listę opcji.

  8. Po elemencie Treść w temacie wprowadź tekst Tweet from:.

  9. Po tekście Tweet from: kliknij ponownie pole i wybierz pozycję Nazwa użytkownika z listy Opcji Po opublikowaniu nowego tweetu.

  10. Kliknij wewnątrz pola Treść i wybierz pozycję Tekst tweetu w obszarze Listy opcji Po opublikowaniu nowego tweetu. Jeśli element tekstowy Tweet nie jest wyświetlany na liście, kliknij link Zobacz więcej, aby rozwinąć listę opcji.

  11. Wybierz przycisk Zapisz na pasku narzędzi, aby zapisać postęp.

Pole wiadomości e-mail powinno teraz wyglądać podobnie do tego zrzutu ekranu.

Powiadomienie e-mail

Uruchom przepływ pracy

  1. Na swoim koncie X tweetuj następujący tekst: Lubię #my-x-tutorial.

  2. Wróć do Projektanta aplikacji usługi Logic Apps i wybierz przycisk Uruchom .

  3. Sprawdź wiadomość e-mail z przepływu pracy.

Czyszczenie zasobów

Aby wyczyścić wszystkie usługi i konta platformy Azure utworzone podczas tego samouczka, usuń grupę zasobów.

  1. Wyszukaj pozycję Grupy zasobów w górnym polu wyszukiwania.

  2. Wybierz samouczek tweet-sentiment-tutorial.

  3. Wybierz pozycję Usuń grupę zasobów

  4. Wprowadź tweet-sentiment-tutorial w polu tekstowym.

  5. Wybierz przycisk Usuń.

Opcjonalnie możesz chcieć wrócić do konta X i usunąć wszelkie tweety testowe ze swojego kanału informacyjnego.

Następne kroki

Tworzenie bezserwerowego interfejsu API za pomocą usługi Azure Functions