Condividi tramite

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à X. Quando vengono valutati i tweet, il flusso di lavoro invia notifiche quando vengono rilevati sentiment positivi.

Questa esercitazione apprendi 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 X.
  • 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 e Machine Learning

  4. In Analisi del testo selezionare Crea.

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

    Impostazione Valore Osservazioni:
    Abbonamento Il nome della sottoscrizione di Azure
    Gruppo di risorse Creare un nuovo gruppo di risorse denominato tweet-sentiment-tutorial Successivamente, si elimina questo gruppo di risorse per rimuovere tutte le risorse create durante questa esercitazione.
    Paese Selezionare l'area più vicina
    Nome TweetSentimentApp
    Piano tariffario Selezionare F0 gratuito

  6. Selezionare Rivedi e crea.

  7. Seleziona Crea.

  8. Al termine della distribuzione, selezionare Vai alla risorsa.

Ottenere le impostazioni di Analisi del testo

Dopo aver creato la risorsa Analisi del testo, verranno copiate alcune impostazioni e verranno messe da parte per usarle in un secondo momento.

  1. Selezionare Chiavi ed Endpoint.

  2. Copiare la 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. Seleziona Crea.

  3. Immettere i valori seguenti.

    Impostazione Valore consigliato Osservazioni:
    Abbonamento Il nome della sottoscrizione di Azure
    Gruppo di risorse 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 -.
    Pubblicazione Codice
    Stack di runtime .NET Il codice della funzione fornito è in C#.
    Versione Selezionare il numero di versione più recente
    Paese Selezionare l'area più vicina

  4. Selezionare Rivedi e crea.

  5. Seleziona Crea.

  6. Al termine della distribuzione, selezionare Vai alla risorsa.

Creare una funzione attivata da HTTP

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

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

    Impostazione Valore Osservazioni:
    Ambiente di sviluppo Sviluppare nel portale
    Modello HTTP Trigger
    Nuova funzione TweetSentimentFunction Questo è il nome della funzione.
    Livello di autorizzazione Funzione

  3. Seleziona il pulsante Aggiungi.

  4. Selezionare il pulsante Codice e 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 valutazione 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 nella 0.9 casella di input Corpo e quindi selezionare Esegui. Verificare che nella casella contenuto della risposta HTTP della sezione Output venga restituito un valore positivo.

Creare quindi un'app per la logica che si integra con Funzioni di Azure, X 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
    Abbonamento Il nome della sottoscrizione di Azure
    Gruppo di risorse tweet-sentiment-tutorial
    Nome dell'app per la logica TweetSentimentApp
    Paese Selezionare l'area più vicina, preferibilmente la stessa area selezionata nei passaggi precedenti.

    Accettare i valori predefiniti per tutte le altre impostazioni.

  4. Selezionare Rivedi e crea.

  5. Seleziona Crea.

  6. Al termine della distribuzione, selezionare Vai alla risorsa.

  7. Selezionare il pulsante App per la logica vuota.

    Pulsante App per la logica vuoto

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

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

Connettersi a X

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

  1. Cercare X nella casella di ricerca superiore.

  2. Selezionare l'icona X.

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

  4. Immettere i valori seguenti per configurare la connessione.

    Impostazione Valore
    Nome connessione MyXConnection
    Tipo di autenticazione Usare l'applicazione condivisa predefinita

  5. Fare clic su Accedi.

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

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

    Impostazione Valore
    Testo di ricerca #my-x-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 X.

  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 del sentiment

  1. Seleziona 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 dell'account Incollare la chiave dell'account Analisi del testo impostata in precedenza.
    URL sito Incollare l'endpoint Analisi del testo impostato in precedenza.

  5. Seleziona Crea.

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

  7. Fare clic all'interno della casella di testo ID - 1 documenti per aprire il popup 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 Testo - 1 dei documenti per aprire il popup 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 funzione

  1. Seleziona 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 della 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 un 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 TweetSentimentFunction Body nella finestra popup.

  5. Immettere Positivo 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 Invia 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 A .

  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 Corpo nell'oggetto, immettere il testo Tweet from:.

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

  10. Fare clic all'interno della casella Corpo e selezionare Testo tweet nell'elenco Delle opzioni 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 tramite email

Eseguire il flusso di lavoro

  1. Dal tuo account X, tweet il testo seguente: Mi piace #my-x-tutorial.

  2. Tornare a Progettazione app per la logica e selezionare il pulsante Esegui .

  3. Controllare la presenza di 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 tweet-sentiment-tutorial.

  3. Selezionare Elimina gruppo di risorse

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

  5. Seleziona il pulsante Elimina.

Facoltativamente, è possibile tornare all'account X ed eliminare eventuali tweet di test dal feed.

Passaggi successivi

Creare un'API senza server mediante Funzioni di Azure