Öğretici: Azure Logic Apps ile tümleştirmek için işlev oluşturma

  • Makale

Azure İşlevleri, Logic Apps Tasarımcısı'nda Azure Logic Apps ile tümleşir. Bu tümleştirme, İşlevlerin bilgi işlem gücünü diğer Azure ve üçüncü taraf hizmetleriyle düzenlemelerde kullanmanıza olanak tanır.

Bu öğreticide Twitter etkinliğini analiz etmek için iş akışı oluşturma gösterilmektedir. Tweetler değerlendirildikçe, pozitif yaklaşımlar algılandığında iş akışı bildirim gönderir.

Bu öğreticide şunların nasıl yapıldığını öğrenirsiniz:

  • Azure AI hizmetleri API Kaynağı oluşturma.
  • Tweet duyarlılığını kategorilere ayıran bir işlev oluşturun.
  • Twitter’a bağlanan bir mantıksal uygulama oluşturun.
  • Mantıksal uygulamaya duyarlılık algılama özelliğini ekleyin.
  • Mantıksal uygulamayı işleve bağlayın.
  • İşlevden alınan yanıta göre bir e-posta gönderin.

Önkoşullar

Not

Gmail bağlayıcısını kullanmak istiyorsanız bu bağlayıcıyı mantıksal uygulamalarda kısıtlama olmadan yalnızca G-Suite iş hesapları kullanabilir. Gmail tüketici hesabınız varsa, Gmail bağlayıcısını yalnızca Belirli Google onaylı uygulamalar ve hizmetlerle kullanabilir veya Gmail bağlayıcınızda kimlik doğrulaması için kullanılacak bir Google istemci uygulaması oluşturabilirsiniz.

Daha fazla bilgi için bkz. Azure Logic Apps'te Google bağlayıcıları için veri güvenliği ve gizlilik ilkeleri.

Metin Analizi kaynağı oluşturma

Azure AI hizmetleri API'leri Azure'da tek tek kaynaklar olarak kullanılabilir. Gönderilen tweetlerin yaklaşımını algılamak için Metin Analizi API'sini kullanın.

  1. Azure Portal oturum açın.

  2. Azure portalının sol üst köşesinde bulunan Kaynak oluştur öğesini seçin.

  3. Kategoriler'in altında AI + Machine Learning'i seçin

  4. Metin Analizi'nin altında Oluştur'u seçin.

  5. Metin Analizi Oluştur ekranına aşağıdaki değerleri girin.

    Ayar Değer Açıklamalar
    Abonelik Azure aboneliğinizin adı
    Kaynak grubu tweet-sentiment-tutorial adlı yeni bir kaynak grubu oluşturma Daha sonra, bu öğretici sırasında oluşturulan tüm kaynakları kaldırmak için bu kaynak grubunu silebilirsiniz.
    Region Size en yakın bölgeyi seçin
    Name TweetSentimentApp
    Fiyatlandırma katmanı Ücretsiz F0'ı seçin

  6. Gözden geçir ve oluştur’u seçin.

  7. Oluştur’u seçin.

  8. Dağıtım tamamlandıktan sonra Kaynağa Git'i seçin.

Metin Analizi ayarlarını alma

Metin Analizi kaynağı oluşturulduktan sonra birkaç ayarı kopyalayıp daha sonra kullanmak üzere bir kenara koyacaksınız.

  1. Anahtarlar ve Uç Nokta'ya tıklayın.

  2. Giriş kutusunun sonundaki simgeye tıklayarak Tuş 1'i kopyalayın.

  3. Değeri bir metin düzenleyicisine yapıştırın.

  4. Giriş kutusunun sonundaki simgeye tıklayarak Uç Nokta'yı kopyalayın.

  5. Değeri bir metin düzenleyicisine yapıştırın.

İşlev uygulaması oluşturma

  1. Üstteki arama kutusunda İşlev uygulaması'nı arayın ve seçin.

  2. Oluştur’u seçin.

  3. Aşağıdaki değerleri girin.

    Ayar Önerilen Değer Açıklamalar
    Abonelik Azure aboneliğinizin adı
    Kaynak grubu tweet-sentiment-tutorial Bu öğretici boyunca aynı kaynak grubu adını kullanın.
    İşlev Uygulamasının adı TweetSentimentAPI + benzersiz bir sonek İşlev uygulaması adları genel olarak benzersizdir. Geçerli karakterler şunlardır: a-z (büyük/küçük harf duyarsız), 0-9 ve -.
    Yayımlama Kod
    Çalışma zamanı yığını .NET Sizin için sağlanan işlev kodu C# dilindedir.
    Sürüm En son sürüm numarasını seçin
    Region Size en yakın bölgeyi seçin

  4. Gözden geçir ve oluştur’u seçin.

  5. Oluştur’u seçin.

  6. Dağıtım tamamlandıktan sonra Kaynağa Git'i seçin.

HTTP ile tetiklenen işlev oluşturma

  1. İşlevler penceresinin sol menüsünden İşlevler'i seçin.

  2. Üstteki menüden Ekle'yi seçin ve aşağıdaki değerleri girin.

    Ayar Değer Açıklamalar
    Geliştirme ortamı Portalda geliştirme
    Şablon HTTP Tetikleyicisi
    Yeni İşlev TweetSentimentFunction Bu, işlevinizin adıdır.
    Yetkilendirme düzeyi İşlev

  3. Ekle düğmesini seçin.

  4. Kod + Test düğmesini seçin.

  5. Aşağıdaki kodu kod düzenleyicisi penceresine yapıştırın.

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

    yaklaşım puanı işleve geçirilir ve değer için bir kategori adı döndürür.

  6. Değişikliklerinizi kaydetmek için araç çubuğundaki Kaydet düğmesini seçin.

    Not

    İşlevi test etmek için üstteki menüden Test/Çalıştır'ı seçin. Giriş sekmesinde, Gövde giriş kutusuna değerini 0.9 girin ve çalıştır'ı seçin. Çıkış bölümündeki HTTP yanıtı içerik kutusunda Pozitif değerinin döndürüldüğünü doğrulayın.

Ardından Azure İşlevleri, Twitter ve Azure AI hizmetleri API'siyle tümleşen bir mantıksal uygulama oluşturun.

Mantıksal uygulama oluşturma

  1. Üstteki arama kutusunda Logic Apps'i arayın ve seçin.

  2. Add (Ekle) seçeneğini belirleyin.

  3. Tüketim'i seçin ve aşağıdaki değerleri girin.

    Ayar Önerilen Değer
    Abonelik Azure aboneliğinizin adı
    Kaynak grubu tweet-sentiment-tutorial
    Mantıksal uygulama adı TweetSentimentApp
    Region Tercihen önceki adımlarda seçtiğiniz bölge olmak üzere size en yakın bölgeyi seçin.

    Diğer tüm ayarlar için varsayılan değerleri kabul edin.

  4. Gözden geçir ve oluştur’u seçin.

  5. Oluştur’u seçin.

  6. Dağıtım tamamlandıktan sonra Kaynağa Git'i seçin.

  7. Boş Mantıksal Uygulama düğmesini seçin.

    Boş Mantıksal Uygulama düğmesi

  8. İlerlemenizi kaydetmek için araç çubuğundaki Kaydet düğmesini seçin.

Artık Logic Apps Tasarım Aracı kullanarak uygulamanıza hizmet ve tetikleyici ekleyebilirsiniz.

Twitter’a Bağlanma

Uygulamanızın yeni tweetleri yoklamasını sağlamak için Twitter bağlantısı oluşturun.

  1. Üstteki arama kutusunda Twitter'da arama yapın.

  2. Twitter simgesini seçin.

  3. Yeni bir tweet gönderildiğinde tetikleyicisini seçin.

  4. Bağlantıyı ayarlamak için aşağıdaki değerleri girin.

    Ayar Değer
    Bağlantı adı MyTwitterConnection
    Kimlik Doğrulama Türü Varsayılan paylaşılan uygulamayı kullanma

  5. Oturum aç'ı seçin.

  6. Twitter'da oturum açmayı tamamlamak için açılır penceredeki istemleri izleyin.

  7. Ardından, Yeni bir tweet gönderildiğinde kutusuna aşağıdaki değerleri girin.

    Ayar Değer
    Arama metni #my-twitter-tutorial
    Öğeleri ne sıklıkta denetlemek istiyorsunuz? metin kutusunda 1 ve
    Açılan listede bir saat. Farklı değerler girebilirsiniz, ancak Twitter bağlayıcısının geçerli sınırlamalarını gözden geçirmeyi unutmayın.

  8. İlerlemenizi kaydetmek için araç çubuğundaki Kaydet düğmesini seçin.

Ardından, toplanan tweetlerin yaklaşımını algılamak için metin analizine bağlanın.

Metin Analizi yaklaşım algılaması ekleme

  1. Yeni adım'ı seçin.

  2. Arama kutusunda Metin Analizi'ni arayın.

  3. Metin Analizi simgesini seçin.

  4. Yaklaşımı Algıla'ya tıklayın ve aşağıdaki değerleri girin.

    Ayar Değer
    Bağlantı adı TextAnalyticsConnection
    Hesap Anahtarı Daha önce ayırdığınız Metin Analizi hesap anahtarını yapıştırın.
    Site URL'si Daha önce ayırdığınız Metin Analizi uç noktasını yapıştırın.

  5. Oluştur’u seçin.

  6. Yeni parametre ekle kutusunun içine tıklayın ve açılır pencerede görüntülenen belgelerin yanındaki kutuyu işaretleyin.

  7. Dinamik içerik açılır penceresini açmak için belge kimliği - 1 metin kutusunun içine tıklayın.

  8. Dinamik içerik arama kutusunda kimliği arayın ve Tweet kimliği'ne tıklayın.

  9. Dinamik içerik açılır penceresini açmak için belgelerin içine Metin - 1 metin kutusu tıklayın.

  10. Dinamik içerik arama kutusunda metin arayın ve Tweet metni'ne tıklayın.

  11. Eylem seçin alanına Metin Analizi yazın ve sonra Duyarlılığı algıla eylemine tıklayın.

  12. İlerlemenizi kaydetmek için araç çubuğundaki Kaydet düğmesini seçin.

Yaklaşımı Algıla kutusu aşağıdaki ekran görüntüsü gibi görünmelidir.

Yaklaşım ayarlarını algılama

Yaklaşım çıkışını işlev uç noktasına bağlama

  1. Yeni adım'ı seçin.

  2. Arama kutusunda Azure İşlevleri'ni arayın.

  3. Azure İşlevleri simgesini seçin.

  4. Arama kutusunda işlev adınızı arayın. Yukarıdaki yönergeleri izlediyseniz işlev adınız TweetSentimentAPI ile başlar.

  5. İşlev simgesini seçin.

  6. TweetSentimentFunction öğesini seçin.

  7. İstek Gövdesi kutusunun içine tıklayın ve açılır pencereden Yaklaşım puanınıalgıla öğesini seçin.

  8. İlerlemenizi kaydetmek için araç çubuğundaki Kaydet düğmesini seçin.

Koşullu adım ekleme

  1. Eylem ekle düğmesini seçin.

  2. Denetim kutusunun içine tıklayın ve açılır pencerede Denetim'i arayın ve seçin.

  3. Koşul'u seçin.

  4. Değer seçin kutusunun içine tıklayın ve açılır pencereden TweetSentimentFunctionBody öğesini seçin.

  5. Değer seçin kutusuna Pozitif yazın.

  6. İlerlemenizi kaydetmek için araç çubuğundaki Kaydet düğmesini seçin.

E-posta bildirimleri ekleme

  1. Doğru kutusunun altında Eylem ekle düğmesini seçin.

  2. Metin kutusunda Outlook Office 365 u arayın ve seçin.

  3. Gönder'i arayın ve metin kutusunda E-posta gönder'i seçin.

  4. Oturum aç düğmesini seçin.

  5. Office 365 Outlook'ta oturum açmayı tamamlamak için açılır penceredeki istemleri izleyin.

  6. E-posta adresinizi Son kutusuna girin.

  7. Konu kutusunun içine tıklayın ve TweetSentimentFunction altındaki Gövde öğesine tıklayın. Gövde öğesi listede gösterilmiyorsa, Seçenekler listesini genişletmek için Daha fazla göster bağlantısına tıklayın.

  8. Konu'dakiGövde öğesinden sonra Tweet at: metnini girin.

  9. Tweet at: metninden sonra kutuya yeniden tıklayın ve Yeni tweet gönderildiğinde seçenekler listesinden Kullanıcı adı'nı seçin.

  10. Gövde kutusunun içine tıklayın ve Yeni tweet gönderildiğinde seçenekler listesinin altında Tweet metni'ni seçin. Tweet metin öğesi listede gösterilmiyorsa Seçenekler listesini genişletmek için Daha fazla göster bağlantısına tıklayın.

  11. İlerlemenizi kaydetmek için araç çubuğundaki Kaydet düğmesini seçin.

E-posta kutusu artık bu ekran görüntüsüne benzemelidir.

E-posta ile bildirim

İş akışını çalıştırma

  1. Twitter hesabınızdan şu metni tweetleyin: #my-twitter-tutorial'den keyif alıyorum.

  2. Logic Apps Tasarım Aracı dönün ve Çalıştır düğmesini seçin.

  3. E-postanızda iş akışından bir ileti olup olmadığını denetleyin.

Kaynakları temizleme

Bu öğretici sırasında oluşturulan tüm Azure hizmetlerini ve hesaplarını temizlemek için kaynak grubunu silin.

  1. Üstteki arama kutusunda Kaynak grupları için arama yapın.

  2. tweet-sentiment-tutorial öğesini seçin.

  3. Kaynak grubunu sil'i seçin

  4. Metin kutusuna tweet-sentiment-tutorial yazın.

  5. Sil düğmesini seçin.

İsteğe bağlı olarak, Twitter hesabınıza geri dönmek ve test tweet'lerini akışınızdan silmek isteyebilirsiniz.

Sonraki adımlar

Azure İşlevleri'ni kullanarak sunucusuz bir API oluşturma