Esercitazione: Creare una funzione da integrare con App per la logica di Azure

  • Articolo

Funzioni di Azure si integra con App per la logica di Azure in Progettazione app per la logica. Questa integrazione consente di usare la potenza di calcolo di Funzioni nelle orchestrazioni con altri servizi di Azure e di terze parti.

Questa esercitazione illustra come creare un flusso di lavoro per analizzare l'attività twitter. Quando vengono valutati i tweet, il flusso di lavoro invia notifiche quando vengono rilevati sentimenti positivi.

In questa esercitazione si apprenderà come:

  • Creare una risorsa API dei servizi di Intelligenza artificiale di Azure.
  • Creare una funzione che classifica i sentiment nei tweet.
  • Creare un'app per la logica che si connette a Twitter.
  • Aggiungere il rilevamento dei sentiment all'app per la logica.
  • Connettere l'app per la logica alla funzione.
  • Inviare un messaggio di posta elettronica in base alla risposta dalla funzione.

Prerequisiti

Nota

Se si vuole usare il connettore Gmail, solo gli account G Suite Business possono usare questo connettore senza restrizioni nelle app per la logica. Se si dispone di un account Gmail consumer, è possibile usare il connettore Gmail solo con app e servizi approvati da Google specifici oppure è possibile creare un'app client Google da usare per l'autenticazione nel connettore Gmail.

Per altre informazioni, vedere Informative sulla privacy e sulla sicurezza dei dati per i connettori Google in App per la logica di Azure.

Creare Analisi del testo risorsa

Le API dei servizi di Intelligenza artificiale di Azure sono disponibili in Azure come singole risorse. Usare l'API Analisi del testo per rilevare il sentiment dei tweet pubblicati.

  1. Accedere al portale di Azure.

  2. Selezionare Crea risorsa nell'angolo superiore sinistro del portale di Azure.

  3. In Categorie selezionare Intelligenza artificiale + Machine Learning

  4. In Analisi del testo selezionare Crea.

  5. Immettere i valori seguenti nella schermata Crea Analisi del testo.

    Impostazione Valore Commenti
    Subscription Il nome della sottoscrizione di Azure
    Resource group Creare un nuovo gruppo di risorse denominato tweet-sentiment-tutorial In seguito, si elimina questo gruppo di risorse per rimuovere tutte le risorse create durante questa esercitazione.
    Region Selezionare l'area più vicina
    Nome TweetSentimentApp
    Piano tariffario Selezionare Free F0

  6. Selezionare Rivedi e crea.

  7. Selezionare Crea.

  8. Al termine della distribuzione, selezionare Vai a Risorsa.

Ottenere le impostazioni di Analisi del testo

Con la risorsa Analisi del testo creata, si copiano alcune impostazioni e vengono impostate a parte per un uso successivo.

  1. Selezionare Chiavi ed Endpoint.

  2. Copiare chiave 1 facendo clic sull'icona alla fine della casella di input.

  3. Incollare il valore in un editor di testo.

  4. Copiare l'endpoint facendo clic sull'icona alla fine della casella di input.

  5. Incollare il valore in un editor di testo.

Creare l'app per le funzioni

  1. Nella casella di ricerca superiore cercare e selezionare App per le funzioni.

  2. Selezionare Crea.

  3. Immettere i valori seguenti.

    Impostazione Valore consigliato Commenti
    Subscription Il nome della sottoscrizione di Azure
    Resource group tweet-sentiment-tutorial Usare lo stesso nome del gruppo di risorse in questa esercitazione.
    Nome dell'app per le funzioni TweetSentimentAPI + suffisso univoco I nomi delle applicazioni di funzione sono univoci a livello globale. I caratteri validi sono a-z (senza distinzione tra maiuscole e minuscole), 0-9 e -.
    Pubblica Codice
    Stack di runtime .NET Il codice della funzione fornito è in C#.
    Versione Selezionare il numero di versione più recente
    Region Selezionare l'area più vicina

  4. Selezionare Rivedi e crea.

  5. Selezionare Crea.

  6. Al termine della distribuzione, selezionare Vai a Risorsa.

Creare una funzione attivata da HTTP

  1. Dal menu a sinistra della finestra Funzioni selezionare Funzioni.

  2. Selezionare Aggiungi dal menu in alto e immettere i valori seguenti.

    Impostazione Valore Commenti
    Ambiente di sviluppo Sviluppare nel portale
    Modello HTTP Trigger
    Nuova funzione TweetSentimentFunction Si tratta del nome della funzione.
    Livello di autorizzazione Funzione

  3. Fare clic sul pulsante Aggiungi.

  4. Selezionare il pulsante Codice + Test .

  5. Incollare il codice seguente nella finestra dell'editor di codice.

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

    Un punteggio di sentiment viene passato alla funzione, che restituisce un nome di categoria per il valore.

  6. Selezionare il pulsante Salva sulla barra degli strumenti per salvare le modifiche.

    Nota

    Per testare la funzione, selezionare Test/Esegui dal menu in alto. Nella scheda Input immettere un valore 0.9 nella casella di input Corpo e quindi selezionare Esegui. Verificare che un valore di Positive venga restituito nella casella contenuto della risposta HTTP nella sezione Output .

Creare quindi un'app per la logica che si integra con Funzioni di Azure, Twitter e l'API dei servizi di intelligenza artificiale di Azure.

Creare un'app per la logica

  1. Nella casella di ricerca superiore cercare e selezionare App per la logica.

  2. Selezionare Aggiungi.

  3. Selezionare Consumo e immettere i valori seguenti.

    Impostazione Valore consigliato
    Subscription Il nome della sottoscrizione di Azure
    Resource group tweet-sentiment-tutorial
    Nome dell'app per la logica TweetSentimentApp
    Region Selezionare l'area più vicina all'utente, preferibilmente la stessa area selezionata nei passaggi precedenti.

    Accettare i valori predefiniti per tutte le altre impostazioni.

  4. Selezionare Rivedi e crea.

  5. Selezionare Crea.

  6. Al termine della distribuzione, selezionare Vai a Risorsa.

  7. Selezionare il pulsante App per la logica vuota .

    Pulsante App per la logica vuota

  8. Selezionare il pulsante Salva sulla barra degli strumenti per salvare lo stato di avanzamento.

È ora possibile usare le app per la logica Designer per aggiungere servizi e trigger all'applicazione.

Connettersi a Twitter

Creare una connessione a Twitter in modo che l'app possa eseguire il polling di nuovi tweet.

  1. Cercare Twitter nella casella di ricerca superiore.

  2. Selezionare l'icona Twitter .

  3. Selezionare il trigger Quando viene pubblicato un nuovo tweet.

  4. Immettere i valori seguenti per configurare la connessione.

    Impostazione Valore
    Nome connessione MyTwitterConnection
    Tipo di autenticazione Usa l'applicazione condivisa predefinita

  5. Fare clic su Accedi.

  6. Seguire le istruzioni nella finestra popup per completare l'accesso a Twitter.

  7. Immettere quindi i valori seguenti nella casella Quando viene pubblicato un nuovo tweet .

    Impostazione Valore
    Testo di ricerca #my-twitter-tutorial
    Specificare la frequenza in base a cui verificare gli elementi. 1 nella casella di testo e
    Ora nell'elenco a discesa. È possibile immettere valori diversi, ma assicurarsi di esaminare le limitazioni correnti del connettore Twitter.

  8. Selezionare il pulsante Salva sulla barra degli strumenti per salvare lo stato di avanzamento.

Connettersi quindi all'analisi del testo per rilevare il sentiment dei tweet raccolti.

Aggiungere Analisi del testo rilevamento dei sentiment

  1. Selezionare Nuovo passaggio.

  2. Cercare Analisi del testo nella casella di ricerca.

  3. Selezionare l'icona Analisi del testo.

  4. Selezionare Rileva sentiment e immettere i valori seguenti.

    Impostazione Valore
    Nome connessione TextAnalyticsConnection
    Chiave account Incollare la chiave dell'account Analisi del testo impostata in precedenza.
    Site URL Incollare l'endpoint Analisi del testo impostato in precedenza.

  5. Selezionare Crea.

  6. Fare clic all'interno della casella Aggiungi nuovo parametro e selezionare la casella accanto ai documenti visualizzati nel popup.

  7. Fare clic all'interno della casella di testo ID documenti - 1 per aprire il popup del contenuto dinamico.

  8. Nella casella di ricerca contenuto dinamico cercare ID e fare clic su Id tweet.

  9. Fare clic all'interno della casella di testo documenti - 1 per aprire il popup del contenuto dinamico.

  10. Nella casella di ricerca contenuto dinamico cercare testo e fare clic su Testo tweet.

  11. In Scegliere un'azione digitare Analisi del testo e quindi scegliere l'azione Rileva sentiment.

  12. Selezionare il pulsante Salva sulla barra degli strumenti per salvare lo stato di avanzamento.

La casella Rileva sentiment dovrebbe essere simile alla schermata seguente.

Rilevare le impostazioni del sentiment

Connettere l'output del sentiment all'endpoint della funzione

  1. Selezionare Nuovo passaggio.

  2. Cercare Funzioni di Azure nella casella di ricerca.

  3. Selezionare l'icona Funzioni di Azure.

  4. Cercare il nome della funzione nella casella di ricerca. Se sono state seguite le indicazioni precedenti, il nome della funzione inizia con TweetSentimentAPI.

  5. Selezionare l'icona della funzione.

  6. Selezionare l'elemento TweetSentimentFunction .

  7. Fare clic all'interno della casella Corpo richiesta e selezionare l'elemento Rileva punteggio sentiment dalla finestra popup.

  8. Selezionare il pulsante Salva sulla barra degli strumenti per salvare lo stato di avanzamento.

Aggiungere il passaggio condizionale

  1. Selezionare il pulsante Aggiungi un'azione .

  2. Fare clic all'interno della casella Controllo e cercare e selezionare Controllo nella finestra popup.

  3. Selezionare Condizione.

  4. Fare clic all'interno della casella Scegli un valore e selezionare l'elemento TweetSentimentFunctionBody dalla finestra popup.

  5. Immettere Positive nella casella Scegli un valore .

  6. Selezionare il pulsante Salva sulla barra degli strumenti per salvare lo stato di avanzamento.

Aggiungere le notifiche di posta elettronica

  1. Nella casella True selezionare il pulsante Aggiungi un'azione .

  2. Cercare e selezionare Office 365 Outlook nella casella di testo.

  3. Cercare l'invio e selezionare Invia un messaggio di posta elettronica nella casella di testo.

  4. Selezionare il pulsante Accedi .

  5. Seguire le istruzioni nella finestra popup per completare l'accesso a Office 365 Outlook.

  6. Immettere l'indirizzo di posta elettronica nella casella To .

  7. Fare clic all'interno della casella Oggetto e fare clic sull'elemento Corpo in TweetSentimentFunction. Se l'elemento Corpo non è visualizzato nell'elenco, fare clic sul collegamento Visualizza altro per espandere l'elenco delle opzioni.

  8. Dopo l'elemento Corponell'oggetto, immettere il testo Tweet from:.

  9. Dopo il tweet da: testo, fare clic di nuovo sulla casella e selezionare Nome utente dall'elenco Quando viene pubblicato un nuovo tweet .

  10. Fare clic all'interno della casella Corpo e selezionare Testo tweet nell'elenco Quando viene pubblicato un nuovo tweet . Se l'elemento di testo Tweet non è visualizzato nell'elenco, fare clic sul collegamento Visualizza altro per espandere l'elenco delle opzioni.

  11. Selezionare il pulsante Salva sulla barra degli strumenti per salvare lo stato di avanzamento.

La casella di posta elettronica dovrebbe ora essere simile a questa schermata.

Notifica con posta elettronica

Eseguire il flusso di lavoro

  1. Dall'account Twitter, tweet il testo seguente: mi piace #my-twitter-tutorial.

  2. Tornare alla Designer app per la logica e selezionare il pulsante Esegui.

  3. Controllare la posta elettronica per un messaggio dal flusso di lavoro.

Pulire le risorse

Per pulire tutti i servizi e gli account di Azure creati durante questa esercitazione, eliminare il gruppo di risorse.

  1. Cercare gruppi di risorse nella casella di ricerca superiore.

  2. Selezionare l'esercitazione su tweet-sentiment-tutorial.

  3. Selezionare Elimina gruppo di risorse

  4. Immettere tweet-sentiment-tutorial nella casella di testo.

  5. Selezionare il pulsante Elimina.

Facoltativamente, potresti voler tornare al tuo account Twitter ed eliminare eventuali tweet di test dal tuo feed.

Passaggi successivi

Creare un'API senza server mediante Funzioni di Azure