Oktatóanyag: Az Azure Logic Appsbe integrálható függvény létrehozása

  • Cikk

Az Azure Functions integrálható az Azure Logic Apps szolgáltatással a Logic Apps Designerben. Ez az integráció lehetővé teszi a Functions számítási erejét más Azure- és külső szolgáltatásokkal való vezénylésekben.

Ez az oktatóanyag bemutatja, hogyan hozhat létre munkafolyamatot a Twitter-tevékenységek elemzéséhez. A tweetek kiértékelése során a munkafolyamat értesítéseket küld, ha pozitív hangulatot észlel.

Eben az oktatóanyagban az alábbiakkal fog megismerkedni:

  • Hozzon létre egy Azure AI-szolgáltatások API-erőforrást.
  • Olyan függvény létrehozása, amely kategorizálja a tweetek hangulatát.
  • A Twitterhez csatlakozó logikai alkalmazás létrehozása.
  • A hangulatfelismerés hozzáadása a logikai alkalmazáshoz.
  • A logikai alkalmazás csatlakoztatása a függvényhez.
  • E-mail küldése a függvénytől érkező válasz alapján.

Előfeltételek

Megjegyzés

Ha a Gmail-összekötőt szeretné használni, csak a G-Suite üzleti fiókok használhatják ezt az összekötőt korlátozás nélkül a logikai alkalmazásokban. Ha gmailes fogyasztói fiókkal rendelkezik, a Gmail-összekötőt csak a Google által jóváhagyott alkalmazásokkal és szolgáltatásokkal használhatja, vagy létrehozhat egy Google-ügyfélalkalmazást a Gmail-összekötő hitelesítéséhez.

További információ: Adatbiztonsági és adatvédelmi szabályzatok a Google-összekötőkhöz az Azure Logic Appsben.

Text Analytics-erőforrás létrehozása

Az Azure AI-szolgáltatások API-k önálló erőforrásként érhetők el az Azure-ban. A közzétett tweetek hangulatának észleléséhez használja az Text Analytics API-t.

  1. Jelentkezzen be az Azure Portalra.

  2. Kattintson az Azure Portal bal felső sarkában található Erőforrás létrehozása gombra.

  3. A Kategóriák területen válassza az AI + Machine Learning lehetőséget

  4. A Text Analytics területen válassza a Létrehozás lehetőséget.

  5. Adja meg a következő értékeket a Create Text Analytics (Létrehozás Text Analytics) képernyőn.

    Beállítás Érték Megjegyzések
    Előfizetés Az Azure-előfizetés neve
    Erőforráscsoport Új erőforráscsoport létrehozása tweet-sentiment-tutorial néven Később törli ezt az erőforráscsoportot az oktatóanyag során létrehozott összes erőforrás eltávolításához.
    Region Válassza ki az Önhöz legközelebb eső régiót
    Name TweetSentimentApp
    Tarifacsomag Válassza az Ingyenes F0 lehetőséget

  6. Válassza a Felülvizsgálat és létrehozás lehetőséget.

  7. Válassza a Létrehozás lehetőséget.

  8. Az üzembe helyezés befejezése után válassza az Erőforrás megnyitása lehetőséget.

Text Analytics beállításainak lekérése

A Text Analytics erőforrás létrehozása után néhány beállítást másolni fog, és a későbbi használatra félreteheti őket.

  1. Válassza a Kulcsok és végpont lehetőséget.

  2. Másolja az 1. kulcsot a beviteli mező végén található ikonra kattintva.

  3. Illessze be az értéket egy szövegszerkesztőbe.

  4. Másolja ki a végpontot a beviteli mező végén található ikonra kattintva.

  5. Illessze be az értéket egy szövegszerkesztőbe.

A függvényalkalmazás létrehozása

  1. A felső keresőmezőben keresse meg és válassza a Függvényalkalmazás lehetőséget.

  2. Válassza a Létrehozás lehetőséget.

  3. Írja be a következő értékeket.

    Beállítás Ajánlott érték Megjegyzések
    Előfizetés Az Azure-előfizetés neve
    Erőforráscsoport tweet-sentiment-tutorial Használja ugyanazt az erőforráscsoport-nevet az oktatóanyag során.
    Függvényalkalmazás neve TweetSentimentAPI + egy egyedi utótag A függvényalkalmazások nevei globálisan egyediek. Az érvényes karakterek az a-z (kis- és nagybetűk megkülönböztetése nélkül) 0-9és az -.
    Közzététel Kód
    Futtatókörnyezet verme .NET A megadott függvénykód C#-ban található.
    Verzió Válassza ki a legújabb verziószámot
    Region Válassza ki az Önhöz legközelebb eső régiót

  4. Válassza a Felülvizsgálat és létrehozás lehetőséget.

  5. Válassza a Létrehozás lehetőséget.

  6. Az üzembe helyezés befejezése után válassza az Erőforrás megnyitása lehetőséget.

HTTP által indított függvény létrehozása

  1. A Függvények ablak bal oldali menüjében válassza a Függvények lehetőséget.

  2. A felső menüben válassza a Hozzáadás lehetőséget, és adja meg a következő értékeket.

    Beállítás Érték Megjegyzések
    Fejlesztési környezet Fejlesztés a portálon
    Sablon HTTP-eseményindító
    Új függvény TweetSentimentFunction Ez a függvény neve.
    Engedélyszint Függvény

  3. Válassza a Hozzáadás gombot.

  4. Válassza a Kód + Teszt gombot.

  5. Illessze be a következő kódot a kódszerkesztő ablakba.

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

    A függvény egy hangulatpontot ad át, amely az érték kategórianevét adja vissza.

  6. A módosítások mentéséhez kattintson az eszköztár Mentés gombjára.

    Megjegyzés

    A függvény teszteléséhez válassza a felső menü Tesztelés/Futtatás elemét. A Bemenet lapon adja meg a törzs beviteli0.9 mezőjének értékét, majd válassza a Futtatás lehetőséget. Ellenőrizze, hogy a Kimenet szakasz HTTP-válasz tartalmának mezőjében pozitív értéket ad-e vissza.

Ezután hozzon létre egy logikai alkalmazást, amely integrálható a Azure Functions, a Twitter és az Azure AI services API-val.

Logikai alkalmazás létrehozása

  1. A felső keresőmezőben keresse meg és válassza a Logic Apps elemet.

  2. Válassza a Hozzáadás lehetőséget.

  3. Válassza a Felhasználás lehetőséget, és adja meg a következő értékeket.

    Beállítás Ajánlott érték
    Előfizetés Az Azure-előfizetés neve
    Erőforráscsoport tweet-sentiment-tutorial
    Logikai alkalmazás neve TweetSentimentApp
    Region Válassza ki az Önhöz legközelebbi régiót, lehetőleg az előző lépésekben kiválasztott régiót.

    Fogadja el az összes többi beállítás alapértelmezett értékeit.

  4. Válassza a Felülvizsgálat és létrehozás lehetőséget.

  5. Válassza a Létrehozás lehetőséget.

  6. Az üzembe helyezés befejezése után válassza az Erőforrás megnyitása lehetőséget.

  7. Válassza az Üres logikai alkalmazás gombot.

    Üres logikai alkalmazás gomb

  8. A folyamat mentéséhez kattintson az eszköztár Mentés gombjára.

Mostantól a Logic Apps Tervező használatával szolgáltatásokat és eseményindítókat adhat hozzá az alkalmazáshoz.

Csatlakozás a Twitterhez

Hozzon létre egy kapcsolatot a Twitterhez, hogy az alkalmazás lekérdezhesse az új tweeteket.

  1. Keresse meg a Twittert a felső keresőmezőben.

  2. Válassza a Twitter ikont.

  3. Válassza az Új tweet közzétételekor eseményindítót.

  4. A kapcsolat beállításához adja meg az alábbi értékeket.

    Beállítás Érték
    Kapcsolat neve MyTwitterConnection
    Hitelesítés típusa Alapértelmezett megosztott alkalmazás használata

  5. Válassza a Bejelentkezés lehetőséget.

  6. Az előugró ablakban megjelenő utasításokat követve fejezze be a Twitterre való bejelentkezést.

  7. Ezután írja be a következő értékeket az Új tweet közzétételekor mezőbe.

    Beállítás Érték
    Keresett szöveg #my-twitter-tutorial
    Milyen gyakran szeretne elemeket keresni? 1 a szövegmezőben, és
    Egy óra a legördülő menüben. Előfordulhat, hogy különböző értékeket ad meg, de mindenképpen tekintse át a Twitter-összekötő jelenlegi korlátozásait .

  8. A folyamat mentéséhez kattintson az eszköztár Mentés gombjára.

Ezután csatlakozzon a szövegelemzéshez az összegyűjtött tweetek hangulatának észleléséhez.

Hangulatfelismerés hozzáadása Text Analytics

  1. Válassza az Új lépés lehetőséget.

  2. Keresse meg a Text Analytics a keresőmezőben.

  3. Válassza a Text Analytics ikont.

  4. Válassza a Hangulat észlelése lehetőséget, és adja meg a következő értékeket.

    Beállítás Érték
    Kapcsolat neve TextAnalyticsConnection
    Fiókkulcs Illessze be a korábban félretett Text Analytics fiókkulcsot.
    Webhely URL-címe Illessze be a korábban félretett Text Analytics végpontba.

  5. Válassza a Létrehozás lehetőséget.

  6. Kattintson az Új paraméter hozzáadása mezőbe, és jelölje be az előugró ablakban megjelenő dokumentumok melletti jelölőnégyzetet.

  7. A dinamikus tartalom előugró ablakának megnyitásához kattintson a Dokumentumok azonosítója – 1 szövegmezőbe.

  8. A dinamikus tartalom keresőmezőjében keressen rá az azonosítóra, és kattintson a Tweet-azonosító elemre.

  9. Kattintson a dokumentumok Szöveg – 1 szövegdoboz elemére a dinamikus tartalom előugró ablakának megnyitásához.

  10. A dinamikus tartalom keresőmezőjében keressen rá a szövegre, és kattintson a Tweet szövegére.

  11. A műveletek választására szolgáló területen írja be a Text Analytics kifejezést, majd kattintson a Hangulat felismerése műveletre.

  12. A folyamat mentéséhez kattintson az eszköztár Mentés gombjára.

A Hangulat észlelése mezőnek az alábbi képernyőképhez hasonlóan kell kinéznie.

Hangulatbeállítások észlelése

Hangulatkimenet csatlakoztatása a függvényvégponthoz

  1. Válassza az Új lépés lehetőséget.

  2. Keresse meg a Azure Functions a keresőmezőben.

  3. Válassza a Azure Functions ikont.

  4. Keresse meg a függvény nevét a keresőmezőben. Ha követte a fenti útmutatást, a függvény neve TweetSentimentAPI-val kezdődik.

  5. Válassza a függvény ikonját.

  6. Válassza ki a TweetSentimentFunction elemet.

  7. Kattintson a Kérelem törzse mezőbe, és válassza a Hangulatpontszámészlelése elemet az előugró ablakban.

  8. A folyamat mentéséhez kattintson az eszköztár Mentés gombjára.

Feltételes lépés hozzáadása

  1. Válassza a Művelet hozzáadása gombot.

  2. Kattintson a Control (Vezérlő ) mezőbe, és keresse meg és válassza a Control (Vezérlő ) lehetőséget az előugró ablakban.

  3. Válassza a Feltétel lehetőséget.

  4. Kattintson az Érték kiválasztása mezőbe, és válassza ki a TweetSentimentFunctionTörzs elemet az előugró ablakban.

  5. Írja be a Pozitív értéket az Érték kiválasztása mezőbe.

  6. A folyamat mentéséhez kattintson az eszköztár Mentés gombjára.

E-mail-értesítések hozzáadása

  1. Az Igaz mezőben válassza a Művelet hozzáadása gombot.

  2. Keresse meg és válassza ki Office 365 Outlookot a szövegmezőben.

  3. Keressen rá a küldésre , és válassza az E-mail küldése lehetőséget a szövegmezőben.

  4. Válassza a Bejelentkezés gombot.

  5. Az előugró ablakban megjelenő utasításokat követve fejezze be a bejelentkezést Office 365 Outlookba.

  6. Írja be az e-mail-címét a Címzett mezőbe.

  7. Kattintson a Tárgy mezőbe, és kattintson a TweetSentimentFunction alatti Törzs elemre. Ha a Törzs elem nem jelenik meg a listában, a Továbbiak megtekintése hivatkozásra kattintva bontsa ki a beállítások listáját.

  8. A Tárgy törzseleme után írja be a Tweet következő szövegét:

  9. A Tweet innen: szöveg után kattintson ismét a mezőre, és válassza a Felhasználónév lehetőséget az Új tweet közzétételekor beállítási listából.

  10. Kattintson a Törzs mezőbe, és válassza a Tweet szövegét az Új tweet közzétételekor beállítási lista alatt. Ha a Tweet szövegelem nem jelenik meg a listában, a Továbbiak megtekintése hivatkozásra kattintva bontsa ki a beállítások listáját.

  11. A folyamat mentéséhez kattintson az eszköztár Mentés gombjára.

Az e-mail mezőnek most így kell kinéznie: ez a képernyőkép.

E-mailes értesítés

A munkafolyamat futtatása

  1. A Twitter-fiókjából tweetelje a következő szöveget: Élvezem #my-twitter-tutorial.

  2. Térjen vissza a Logic Apps Tervező, és válassza a Futtatás gombot.

  3. Ellenőrizze az e-mail-címét, hogy van-e üzenet a munkafolyamatból.

Az erőforrások eltávolítása

Az oktatóanyag során létrehozott összes Azure-szolgáltatás és fiók törléséhez törölje az erőforráscsoportot.

  1. Keressen rá az erőforráscsoportokra a felső keresőmezőben.

  2. Válassza ki a tweet-sentiment-tutorial lehetőséget.

  3. Válassza az Erőforráscsoport törlése lehetőséget

  4. Írja be a tweet-sentiment-tutorial kifejezést a szövegmezőbe.

  5. Válassza a Törlés gombot.

Előfordulhat, hogy vissza szeretne térni a Twitter-fiókjához, és törölnie kell a teszt tweeteket a hírcsatornából.

Következő lépések

Kiszolgáló nélküli API létrehozása az Azure Functions használatával