Tutorial: Membuat fungsi yang akan diintegrasikan dengan Azure Logic Apps

Azure Functions terintegrasi dengan Azure Logic Apps di Logic Apps Designer. Dengan integrasi ini, Anda dapat menggunakan kekuatan komputasi Fungsi dalam orkestrasi dengan Layanan Azure dan pihak ketiga lainnya.

Tutorial ini menunjukkan kepada Anda cara membuat alur kerja untuk menganalisis aktivitas Twitter. Saat tweet dievaluasi, alur kerja mengirimkan pemberitahuan saat sentimen positif terdeteksi.

Dalam tutorial ini, Anda mempelajari caranya:

  • Membuat Sumber Daya API layanan Azure AI.
  • Buat fungsi yang mengkategorikan sentimen tweet.
  • Buat aplikasi logika yang terhubung ke Twitter.
  • Tambahkan deteksi sentimen ke aplikasi logika.
  • Hubungkan aplikasi logika ke fungsi.
  • Kirim email berdasarkan respons dari fungsi tersebut.

Prasyarat

Catatan

Jika Anda ingin menggunakan konektor Gmail, hanya akun bisnis G-Suite yang dapat menggunakan konektor ini tanpa batasan di aplikasi logika. Jika Anda memiliki akun konsumen Gmail, Anda dapat menggunakan konektor Gmail hanya dengan aplikasi dan layanan tertentu yang disetujui Google, atau Anda dapat membuat aplikasi klien Google yang akan digunakan untuk autentikasi dengan konektor Gmail Anda.

Untuk informasi selengkapnya, lihat Kebijakan keamanan dan privasi data untuk konektor Google di Azure Logic Apps.

Membuat sumber daya Analitik Teks

API layanan Azure AI tersedia di Azure sebagai sumber daya individual. Gunakan API Analitik Teks untuk mendeteksi sentimen tweet yang diposting.

  1. Masuk ke portal Microsoft Azure.

  2. Pilih Buat sumber daya yang bisa ditemukan di sudut kiri atas portal Microsoft Azure.

  3. Di bagian Kategori, pilih AI + Machine Learning

  4. Di bagian Teks Analitik, pilih Buat.

  5. Masukkan nilai berikut di layar Buat Analitik Teks.

    Pengaturan Nilai Keterangan
    Langganan Nama langganan Azure Anda
    Grup sumber daya Membuat grup sumber daya baru bernama tweet-sentiment-tutorial Kemudian, Anda menghapus grup sumber daya ini serta menghapus semua sumber daya yang dibuat selama tutorial ini.
    Wilayah Pilih wilayah yang paling dekat dengan Anda
    Nama TweetSentimentApp
    Tingkat harga Pilih F0 Gratis
  6. Pilih Tinjau + buat.

  7. Pilih Buat.

  8. Setelah penyebarannya selesai, pilih Buka Sumber daya.

Dapatkan pengaturan Analitik Teks

Dengan pembuatan sumber daya Analitik Teks, Anda akan menyalin beberapa pengaturan dan menyisihkannya untuk digunakan nanti.

  1. Pilih Kunci dan Titik Akhir.

  2. Salin Kunci 1 dengan mengeklik ikon di akhir kotak input.

  3. Tempelkan nilainya ke editor teks.

  4. Salin Titik akhir dengan mengeklik ikon di akhir kotak input.

  5. Tempelkan nilainya ke editor teks.

Membuat aplikasi fungsi

  1. Dari kotak pencarian teratas, cari dan pilih Aplikasi fungsi.

  2. Pilih Buat.

  3. Masukkan nilai berikut.

    Pengaturan Nilai yang disarankan Keterangan
    Langganan Nama langganan Azure Anda
    Grup sumber daya tweet-sentiment-tutorial Gunakan nama grup sumber daya yang sama di seluruh tutorial ini.
    Nama Aplikasi Fungsi TweetSentimentAPI + akhiran unik Nama aplikasi fungsi unik secara global. Karakter yang valid a-z(memperhatikan huruf besar dan kecil),0-9, dan - .
    Terbitkan Kode
    Tumpukan runtime .NET Kode fungsi yang disediakan untuk Anda tersedia di C#.
    Versi Pilih nomor versi terbaru
    Wilayah Pilih wilayah yang paling dekat dengan Anda
  4. Pilih Tinjau + buat.

  5. Pilih Buat.

  6. Setelah penyebarannya selesai, pilih Buka Sumber daya.

Buat fungsi yang dipicu HTTP

  1. Dari menu kiri jendela Fungsi, pilih Fungsi.

  2. Pilih Tambahkan dari menu atas dan masukkan nilai berikut.

    Pengaturan Nilai Keterangan
    Lingkungan pengembangan Kembangkan di portal
    Templat Pemicu HTTP
    Fungsi baru TweetSentimentFungsi Ini adalah nama fungsi Anda.
    Tingkat otorisasi Fungsi
  3. Pilih tombol Tambahkan.

  4. Pilih tombol Kode + Uji.

  5. Tempelkan kode berikut di jendela editor kode.

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

    Skor sentimen diteruskan ke fungsi, yang mengembalikan nama kategori untuk nilai tersebut.

  6. Pilih tombol Simpan pada toolbar untuk menyimpan perubahan Anda.

    Catatan

    Untuk menguji fungsi, pilih Uji/Jalankan dari menu atas. Pada tab Input, masukkan nilai 0.9ke dalam kotak inputIsi, lalu pilihJalankan. Verifikasi bahwa nilai Positif dikembalikan dalam kotak konten respons HTTP di bagian Output.

Selanjutnya, buat aplikasi logika yang terintegrasi dengan Azure Functions, Twitter, dan API layanan Azure AI.

1\. Buat aplikasi logika

  1. Dari kotak pencarian teratas, cari dan pilih Logic Apps.

  2. Pilih Tambahkan.

  3. Pilih Konsumsi dan masukkan nilai berikut ini.

    Pengaturan Nilai yang disarankan
    Langganan Nama langganan Azure Anda
    Grup sumber daya tweet-sentiment-tutorial
    Nama Aplikasi Logika TweetSentimentApp
    Wilayah Pilih wilayah yang paling dekat dengan Anda, sebaiknya bidang yang sama dengan yang Anda pilih di langkah sebelumnya.

    Terima nilai default untuk semua pengaturan lainnya.

  4. Pilih Tinjau + buat.

  5. Pilih Buat.

  6. Setelah penyebarannya selesai, pilih Buka Sumber daya.

  7. Pilih tombol Aplikasi Logika kosong.

    Tombol Aplikasi Logika Kosong

  8. Pilih tombol Simpan pada toolbar untuk menyimpan kemajuan Anda.

Kini Anda dapat menggunakan Logic Apps Designer untuk menambahkan layanan dan pemicu ke aplikasi Anda.

Terhubung ke Twitter

Buat koneksi ke Twitter sehingga aplikasi Anda dapat melakukan polling untuk tweet baru.

  1. Cari Twitter di kotak pencarian teratas.

  2. Pilih ikon Twitter.

  3. Pilih pemicu Kapan tweet baru diposting.

  4. Masukkan nilai berikut untuk menyiapkan koneksi.

    Pengaturan Nilai
    Nama koneksi MyTwitterConnection
    Jenis autentikasi Gunakan aplikasi bersama default
  5. Pilih Masuk.

  6. Ikuti perintah di jendela popup untuk menyelesaikan masuk ke Twitter.

  7. Berikutnya, masukkan nilai berikut dalam kotak Saat tweet baru diposting.

    Pengaturan Nilai
    Cari teks #my-twitter-tutorial
    Seberapa sering Anda ingin memeriksa item? 1 di kotak teks, dan
    Jam di drop-down. Anda dapat memasukkan nilai yang berbeda tetapi pastikan untuk meninjau batasan konektor Twitter saat ini.
  8. Pilih tombol Simpan pada toolbar untuk menyimpan kemajuan Anda.

Selanjutnya, sambungkan ke analitik teks untuk mendeteksi sentimen tweet yang dikumpulkan.

Menambahkan deteksi sentimen Analitik Teks

  1. Pilih Langkah baru.

  2. Cari Analitik Teks di kotak pencarian.

  3. Pilih ikon Analitik Teks.

  4. Pilih Deteksi Sentimen dan masukkan nilai berikut.

    Pengaturan Nilai
    Nama koneksi TextAnalyticsConnection
    Kunci akun Pada kunci akun, tempelkan Analitik Teks yang Anda sisihkan sebelumnya.
    URL Situs Pada titik akhir, tempelkan Analitik Teks yang Anda sisihkan sebelumnya.
  5. Pilih Buat.

  6. Klik di dalam kotak Tambahkan parameter baru, dan centang kotak di samping dokumen yang muncul di pop-up.

  7. Klik di dalam Id dokumen - 1 kotak teks untuk membuka pop-up konten dinamis.

  8. Dalam kotak pencarian konten dinamis, cari id, dan klik id Tweet.

  9. Klik di dalam Teks dokumen - 1 kotak teks untuk membuka pop-up konten dinamis.

  10. Dalam kotak pencarian konten dinamis, cari teks, dan klik teks Tweet.

  11. Di Pilih tindakan, ketik Analitik Teks, lalu klik tindakan Deteksi sentimen.

  12. Pilih tombol Simpan pada toolbar untuk menyimpan kemajuan Anda.

Kotak Deteksi Sentimen akan terlihat seperti cuplikan layar berikut.

Deteksi pengaturan Sentimen

Menyambungkan output sentimen ke titik akhir fungsi

  1. Pilih Langkah baru.

  2. Cari Azure Functions di kotak pencarian.

  3. Pilih ikon Azure Functions.

  4. Cari nama fungsi Anda di kotak pencarian. Jika Anda mengikuti panduan di atas, nama fungsi Anda dimulai dengan TweetSentimentAPI.

  5. Pilih ikon fungsi.

  6. Pilih item TweetSentimentFunction.

  7. Klik bagian dalam kotak Isi Permintaan, dan pilih item skorDeteksi Sentimen dari jendela pop-up.

  8. Pilih tombol Simpan pada toolbar untuk menyimpan kemajuan Anda.

Menambahkan langkah bersyarat

  1. Pilih tombol Tambahkan tindakan.

  2. Klik di dalam kotak Kontrol, dan cari lalu pilih Kontrol di jendela pop-up.

  3. Pilih Kondisi.

  4. Klik di dalam kotak Pilih sebuah nilai, lalu pilih item IsiTweetSentimentFunction dari jendela pop-up.

  5. Masukkan Positif dalam kotak Pilih nilai.

  6. Pilih tombol Simpan pada toolbar untuk menyimpan kemajuan Anda.

Menambahkan pemberitahuan surel

  1. Di bawah kotak True, pilih tombol Tambahkan tindakan.

  2. Cari dan pilih Office 365 Outlook dalam kotak teks.

  3. Cari kirim dan pilih Kirim email dalam kotak teks.

  4. Pilih tombol Masuk.

  5. Ikuti perintah di jendela pop-up untuk menyelesaikan proses masuk ke Office 365 Outlook.

  6. Masukkan alamat email Anda di kotak Kepada.

  7. Klik di dalam kotak Subjek dan klik item Isi di bagian TweetSentimentFunction. Jika item Isi tidak diperlihatkan dalam daftar, klik tautan Lihat selengkapnya untuk memperluas daftar opsi.

  8. Setelah item Isi dalam Subjek, masukkan teks Tweet dari: .

  9. Setelah teks Tweet dari: , klik lagi pada kotak dan pilih Nama pengguna dari daftar opsi Saat tweet baru diposting.

  10. Klik di dalam kotak Isi dan pilih teks Tweet di bagian daftar opsi Saat tweet baru diposting. Jika item Teks tweet tidak diperlihatkan dalam daftar, klik tautan Lihat selengkapnya untuk memperluas daftar opsi.

  11. Pilih tombol Simpan pada toolbar untuk menyimpan kemajuan Anda.

Kotak email sekarang akan terlihat seperti cuplikan layar ini.

Pemberitahuan Email

Jalankan alur kerja

  1. Dari akun Twitter Anda, tweet teks berikut: Saya menikmati #my-twitter-tutorial.

  2. Kembali ke Perancang Logic Apps dan pilih tombol Jalankan.

  3. Periksa email Anda untuk melihat pesan dari alur kerja.

Bersihkan sumber daya

Untuk membersihkan semua layanan dan akun Azure yang dibuat selama tutorial ini, hapus grup sumber daya.

  1. Cari grup Sumber Daya di kotak pencarian teratas.

  2. Pilih tweet-sentiment-tutorial.

  3. Pilih Hapus grup sumber daya

  4. Masukkan tweet-sentiment-tutorial di kotak teks.

  5. Pilih tombol Haus.

Secara opsional, Anda mungkin ingin kembali ke akun Twitter Anda dan menghapus tweet pengujian apa pun dari umpan Anda.

Langkah berikutnya