Zelfstudie: Een functie maken om te integreren met Azure Logic Apps

  • Artikel

Azure Functions integreert met Azure Logic Apps in de Logic Apps Designer. Met deze integratie kunt u de rekenkracht van Functions gebruiken in indelingen met andere Azure-services en services van derden.

In deze zelfstudie ziet u hoe u een werkstroom maakt om Twitter-activiteiten te analyseren. Wanneer tweets worden geëvalueerd, verzendt de werkstroom meldingen wanneer positieve gevoelens worden gedetecteerd.

In deze zelfstudie leert u het volgende:

  • Maak een API-resource voor Azure AI-services.
  • Een functie maken die tweetgevoelens categoriseert.
  • Een logische app maken die verbinding maakt met Twitter.
  • Detectie van gevoelens toevoegen aan de logische app.
  • De logische app verbinden met de functie.
  • Een e-mail versturen op basis van de reactie van de functie.

Vereisten

Notitie

Als u de Gmail-connector wilt gebruiken, kunnen alleen bedrijfsaccounts van G Suite deze connector zonder beperkingen in logische apps gebruiken. Als u een Gmail-consumentenaccount hebt, kunt u de Gmail-connector alleen gebruiken met specifieke door Google goedgekeurde apps en services, of u kunt een Google-client-app maken voor verificatie in uw Gmail-connector.

Zie Beleid voor gegevensbeveiliging en privacybeleid voor Google-connectors in Azure Logic Apps voor meer informatie.

Text Analytics resource maken

De API's voor Azure AI-services zijn beschikbaar in Azure als afzonderlijke resources. Gebruik de Text Analytics-API om het gevoel van geplaatste tweets te detecteren.

  1. Meld u aan bij de Azure-portal.

  2. Selecteer in de linkerbovenhoek van Azure Portal Een resource maken.

  3. Selecteer onder Categorieënde optie AI + Machine Learning

  4. Selecteer maken onder Text Analytics.

  5. Voer de volgende waarden in het scherm Text Analytics maken in.

    Instelling Waarde Opmerkingen
    Abonnement De naam van uw Azure-abonnement
    Resourcegroep Een nieuwe resourcegroep maken met de naam tweet-sentiment-tutorial Later verwijdert u deze resourcegroep om alle resources te verwijderen die tijdens deze zelfstudie zijn gemaakt.
    Regio Selecteer de regio het dichtst bij u in de buurt
    Naam TweetSentimentApp
    Prijscategorie Selecteer Gratis F0

  6. Selecteer Controleren + maken.

  7. Selecteer Maken.

  8. Zodra de implementatie is voltooid, selecteert u Ga naar resource.

Instellingen voor Text Analytics ophalen

Nu de Text Analytics resource is gemaakt, kopieert u enkele instellingen en zet u deze opzij voor later gebruik.

  1. Selecteer Sleutels en eindpunt.

  2. Kopieer Sleutel 1 door op het pictogram aan het einde van het invoervak te klikken.

  3. Plak de waarde in een teksteditor.

  4. Kopieer het eindpunt door op het pictogram aan het einde van het invoervak te klikken.

  5. Plak de waarde in een teksteditor.

De functie-app maken

  1. Zoek en selecteer functie-app in het bovenste zoekvak.

  2. Selecteer Maken.

  3. Voer de volgende waarden in.

    Instelling Voorgestelde waarde Opmerkingen
    Abonnement De naam van uw Azure-abonnement
    Resourcegroep tweet-sentiment-tutorial Gebruik in deze zelfstudie dezelfde resourcegroepnaam.
    Functions App-naam TweetSentimentAPI + een uniek achtervoegsel Namen van functietoepassingen zijn wereldwijd uniek. Geldige tekens zijn a-z (hoofdlettergevoelig), 0-9 en -.
    Publiceren Code
    Runtimestack .NET De functiecode die u hebt opgegeven, staat in C#.
    Versie Selecteer het meest recente versienummer
    Regio Selecteer de regio het dichtst bij u in de buurt

  4. Selecteer Controleren + maken.

  5. Selecteer Maken.

  6. Zodra de implementatie is voltooid, selecteert u Ga naar resource.

Een met HTTP geactiveerde functie maken

  1. Selecteer functies in het linkermenu van het venster Functies.

  2. Selecteer Toevoegen in het bovenste menu en voer de volgende waarden in.

    Instelling Waarde Opmerkingen
    Ontwikkelomgeving Ontwikkelen in portal
    Template HTTP-trigger
    Nieuwe functie TweetSentimentFunction Dit is de naam van uw functie.
    Autorisatieniveau Functie

  3. Selecteer de knop Add.

  4. Selecteer de knop Code + Test .

  5. Plak de volgende code in het code-editorvenster.

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

    Er wordt een gevoelsscore doorgegeven aan de functie, die een categorienaam voor de waarde retourneert.

  6. Selecteer de knop Opslaan op de werkbalk om uw wijzigingen op te slaan.

    Notitie

    Als u de functie wilt testen, selecteert u Testen/uitvoeren in het bovenste menu. Voer op het tabblad Invoer een waarde in van 0.9 in het invoervak Hoofdteksten selecteer uitvoeren. Controleer of de waarde Positief wordt geretourneerd in het vak HTTP-antwoordinhoud in de sectie Uitvoer .

Maak vervolgens een logische app die kan worden geïntegreerd met Azure Functions, Twitter en de API voor Azure AI-services.

Een logische app maken

  1. Zoek en selecteer Logic Apps in het bovenste zoekvak.

  2. Selecteer Toevoegen.

  3. Selecteer Verbruik en voer de volgende waarden in.

    Instelling Voorgestelde waarde
    Abonnement De naam van uw Azure-abonnement
    Resourcegroep tweet-sentiment-tutorial
    Naam van logische app TweetSentimentApp
    Region Selecteer de regio die het dichtst bij u in de buurt ligt, bij voorkeur dezelfde regio die u in de vorige stappen hebt geselecteerd.

    Accepteer standaardwaarden voor alle andere instellingen.

  4. Selecteer Controleren + maken.

  5. Selecteer Maken.

  6. Nadat de implementatie is voltooid, selecteert u Ga naar resource.

  7. Selecteer de knop Lege logische app .

    Knop Lege logische app

  8. Selecteer de knop Opslaan op de werkbalk om uw voortgang op te slaan.

U kunt nu de Logic Apps-Designer gebruiken om services en triggers toe te voegen aan uw toepassing.

Verbinding maken met Twitter

Maak een verbinding met Twitter, zodat uw app kan peilen naar nieuwe tweets.

  1. Zoek naar Twitter in het bovenste zoekvak.

  2. Selecteer het Twitter-pictogram .

  3. Selecteer de trigger Wanneer een nieuwe tweet word geplaatst.

  4. Voer de volgende waarden in om de verbinding in te stellen.

    Instelling Waarde
    Verbindingsnaam MyTwitterConnection
    Verificatietype Standaard gedeelde toepassing gebruiken

  5. Selecteer Aanmelden.

  6. Volg de aanwijzingen in het pop-upvenster om het aanmelden bij Twitter te voltooien.

  7. Voer vervolgens de volgende waarden in het vak Wanneer een nieuwe tweet wordt geplaatst in.

    Instelling Waarde
    Zoektekst #my-twitter-tutorial
    Hoe vaak wilt u controleren op items? 1 in het tekstvak en
    Uur in de vervolgkeuzelijst. U kunt verschillende waarden invoeren, maar zorg ervoor dat u de huidige beperkingen van de Twitter-connector doornemen.

  8. Selecteer de knop Opslaan op de werkbalk om uw voortgang op te slaan.

Maak vervolgens verbinding met tekstanalyse om het gevoel van verzamelde tweets te detecteren.

Detectie van Text Analytics gevoel toevoegen

  1. Selecteer Nieuwe stap.

  2. Zoek Text Analytics in het zoekvak.

  3. Selecteer het pictogram Text Analytics.

  4. Selecteer Gevoel detecteren en voer de volgende waarden in.

    Instelling Waarde
    Verbindingsnaam TextAnalyticsConnection
    Accountsleutel Plak de Text Analytics accountsleutel die u eerder hebt gereserveerd.
    Site-URL Plak het Text Analytics eindpunt dat u eerder hebt gereserveerd.

  5. Selecteer Maken.

  6. Klik in het vak Nieuwe parameter toevoegen en schakel het selectievakje in naast documenten die in het pop-upvenster worden weergegeven.

  7. Klik in het tekstvak Document-id - 1 om het pop-upvenster voor dynamische inhoud te openen.

  8. Zoek in het zoekvak voor dynamische inhoud naar id en klik op Tweet-id.

  9. Klik in het tekstvak Tekst - 1 van het document om het pop-upvenster voor dynamische inhoud te openen.

  10. Zoek in het zoekvak voor dynamische inhoud naar tekst en klik op Tekst tweeten.

  11. Typ Tekstanalyse in Een actie kiezen en klik vervolgens op de actie Gevoel detecteren.

  12. Selecteer de knop Opslaan op de werkbalk om uw voortgang op te slaan.

Het vak Gevoel detecteren moet eruitzien zoals in de volgende schermopname.

Gevoelsinstellingen detecteren

Gevoelsuitvoer verbinden met functie-eindpunt

  1. Selecteer Nieuwe stap.

  2. Zoek Azure Functions in het zoekvak.

  3. Selecteer het pictogram Azure Functions.

  4. Zoek de naam van uw functie in het zoekvak. Als u de bovenstaande richtlijnen hebt gevolgd, begint uw functienaam met TweetSentimentAPI.

  5. Selecteer het functiepictogram.

  6. Selecteer het item TweetSentimentFunction .

  7. Klik in het vak Aanvraagtekst en selecteer het item Gevoelsscoredetecteren in het pop-upvenster.

  8. Selecteer de knop Opslaan op de werkbalk om uw voortgang op te slaan.

Voorwaardelijke stap toevoegen

  1. Selecteer de knop Een actie toevoegen .

  2. Klik in het vak Besturingselement en zoek en selecteer Besturingselement in het pop-upvenster.

  3. Selecteer Voorwaarde.

  4. Klik in het vak Kies een waarde en selecteer het item TweetSentimentFunctionBody in het pop-upvenster.

  5. Voer Positief in het vak Kies een waarde in.

  6. Selecteer de knop Opslaan op de werkbalk om uw voortgang op te slaan.

E-mailmeldingen toevoegen

  1. Selecteer onder het vak Waar de knop Een actie toevoegen .

  2. Zoek en selecteer Office 365 Outlook in het tekstvak.

  3. Zoek naar verzenden en selecteer Een e-mail verzenden in het tekstvak.

  4. Selecteer de knop Aanmelden .

  5. Volg de aanwijzingen in het pop-upvenster om het aanmelden bij Office 365 Outlook te voltooien.

  6. Voer uw e-mailadres in het vak Aan in.

  7. Klik in het vak Onderwerp en klik op het item Hoofdtekst onder TweetSentimentFunction. Als het item Hoofdtekst niet wordt weergegeven in de lijst, klikt u op de koppeling Meer weergeven om de lijst met opties uit te vouwen.

  8. Voer na het item Hoofdtekst in het onderwerp de tekst Tweet van: in.

  9. Klik na de tweet van: nogmaals op het vak en selecteer Gebruikersnaam in de optieslijst Wanneer een nieuwe tweet wordt geplaatst .

  10. Klik in het vak Hoofdtekst en selecteer Tekst tweeten onder de optieslijst Wanneer een nieuwe tweet wordt geplaatst . Als het tekstitem tweet niet wordt weergegeven in de lijst, klikt u op de koppeling Meer weergeven om de lijst met opties uit te vouwen.

  11. Selecteer de knop Opslaan op de werkbalk om uw voortgang op te slaan.

Het e-mailvak moet er nu uitzien als deze schermafbeelding.

E-mailmelding

De werkstroom uitvoeren

  1. Tweet vanuit uw Twitter-account de volgende tekst: Ik geniet van #my-twitter-tutorial.

  2. Ga terug naar de logic apps-Designer en selecteer de knop Uitvoeren.

  3. Controleer uw e-mail op een bericht uit de werkstroom.

Resources opschonen

Als u alle Azure-services en -accounts wilt opschonen die tijdens deze zelfstudie zijn gemaakt, verwijdert u de resourcegroep.

  1. Zoek naar Resourcegroepen in het bovenste zoekvak.

  2. Selecteer de tweet-sentiment-tutorial.

  3. Selecteer Resourcegroep verwijderen

  4. Typ tweet-sentiment-tutorial in het tekstvak.

  5. Selecteer de knop Verwijderen.

Desgewenst kunt u terugkeren naar uw Twitter-account en eventuele test-tweets uit uw feed verwijderen.

Volgende stappen

Een serverloze API maken met behulp van Azure Functions