Eğitim: Azure Logic Apps ile entegre olacak bir işlev oluşturma

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

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

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

  • Bir Döküm Araçları API Kaynağı oluşturun.
  • Tweet duyarlılığını kategorilere ayıran bir işlev oluşturun.
  • X'e 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

  • Etkin bir X hesabı.
  • Bir Outlook.com hesabı (bildirim göndermek için).

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 kullanmak üzere bir Google istemci uygulaması oluşturabilirsiniz.

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

Text Analytics kaynağı oluşturma

Foundry Araçları API'leri, Azure'da tek tek kaynaklar olarak kullanılabilir. Gönderilen tweetlerin yaklaşımını algılamak için Text Analytics API'sini kullanın.

  1. Azure portalında oturum açın.

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

  3. Categories altında AI + Machine Learning

  4. Text Analytics altında Oluştur öğesini seçin.

  5. Create Text Analytics ekranına aşağıdaki değerleri girin.

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

  6. Seçin, gözden geçir ve oluştur.

  7. Oluştur'i seçin.

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

Text Analytics ayarlarını alma

Text Analytics kaynağı oluşturulduğunda, birkaç ayarı kopyalayıp daha sonra kullanmak üzere ayıracaksınız.

  1. Anahtarlar ve Uç Nokta'yı seçin.

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

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

  4. Giriş kutusunun sonundaki simgeye tıklayarak Uç Noktayı 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'i seçin.

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

    Ayarlar Önerilen Değer Açıklamalar
    Abonelik Azure aboneliğinizin adı
    Kaynak grubu tweet-sentiment-tutorial Bu kılavuz boyunca aynı kaynak grup adını kullanın.
    İşlev Uygulamasının adı TweetSentimentAPI + benzersiz bir ek İş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
    Bölge Size en yakın bölgeyi seçin

  4. Seçin, gözden geçir ve oluştur.

  5. Oluştur'i 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. Üst menüden Ekle'yi seçin ve aşağıdaki değerleri girin.

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

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

    İşleve duygu puanı geçirilir, bu da 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, 0.9 giriş kutusuna değerini girin ve çalıştır'ı seçin. Çıktı bölümündeki HTTP yanıt içeriği kutusunda Pozitif değerinin döndürüldüğünü doğrulayın.

Ardından Azure Functions, X ve Döküm Araçları 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.

    Ayarlar Önerilen Değer
    Abonelik Azure aboneliğinizin adı
    Kaynak grubu tweet-sentiment-tutorial
    Mantıksal uygulama adı TweetSentimentApp
    Bölge Size en yakın bölgeyi( tercihen önceki adımlarda seçtiğiniz bölgeyi) seçin.

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

  4. Seçin, gözden geçir ve oluştur.

  5. Oluştur'i seçin.

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

  7. Boş Logic App düğmesini seçin.

    Boş Logic App düğmesi

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

Artık Logic Apps Tasarımcısı'nı kullanarak uygulamanıza hizmet ve tetikleyici ekleyebilirsiniz.

X'e bağlan

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

  1. Üstteki arama kutusunda X araması yapın.

  2. X 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.

    Ayarlar Değer
    Bağlantı adı MyXConnection
    Kimlik Doğrulaması Türü Varsayılan paylaşılan uygulamayı kullanma

  5. Oturum aç'ı seçin.

  6. X'te 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.

    Ayarlar Değer
    Arama yazısı #my-x-rehberi
    Öğeleri ne sıklıkta denetlemek istiyorsunuz? metin kutusunda 1 ve
    Açılan listede saat. Farklı değerler girebilirsiniz, ancak X 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.

Text Analytics duygu analizi ekle

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

  2. Arama kutusunda Text Analytics arayın.

  3. Text Analytics simgesini seçin.

  4. Algıyı Tespit Et seçeneğine tıklayın ve aşağıdaki değerleri girin.

    Ayarlar Değer
    Bağlantı adı TextAnalyticsConnection
    Hesap Anahtarı Daha önce ayırdığınız Text Analytics hesap anahtarını yapıştırın.
    Site URL’si Daha önce ayırdığınız Text Analytics uç noktasını buraya yapıştırın.

  5. Oluştur'i 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 id arayın ve Tweet id'e tıklayın.

  9. documents Text - 1 metin kutusunun içine tıklayarak dinamik içerik açılır penceresini açın.

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

  11. Eylem seçinText Analytics yazın ve Detect sentiment eylemine tıklayın.

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

Duygusal Algıla kutusu aşağıdaki ekran görüntüsüne benzer olmalıdır.

Duygu Analizi Ayarlarını Algılama

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

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

  2. Arama kutusunda Azure Functions arayın.

  3. Azure Functions 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 Duygu Algılapuanı öğ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 pencerede TweetSentimentFunctionBody öğesini seçin.

  5. Değer seçin kutusuna Pozitif girin.

  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 Office 365 Outlook 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 oturum açma işlemini 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. Gövde öğesinin ardından Konu'da, Tweet from: metnini girin.

  9. Tweet kaynağı: 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ındaki 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 bildirimi

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

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

  2. Logic Apps Tasarımcısı'na dönün ve Çalıştır düğmesini seçin.

  3. İş akışından gelen bir ileti için e-postanızı 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, X hesabınıza dönmek ve akışınızdan test tweet'lerini silmek isteyebilirsiniz.

Sonraki adımlar

Azure Functions

  • Last updated on