Memanggil aplikasi Azure Logic sebagai fungsi menggunakan Asisten Azure OpenAI
Catatan
Fungsionalitas ini saat ini hanya tersedia di Azure OpenAI Studio.
Azure Logic Apps adalah platform integrasi di Azure yang memungkinkan Anda membangun aplikasi dan alur kerja otomatisasi dengan alat kode rendah yang memungkinkan produktivitas pengembang dan waktu yang lebih cepat untuk memasarkan. Dengan menggunakan perancang visual dan memilih dari ratusan konektor bawaan, Anda dapat dengan cepat membangun alur kerja yang mengintegrasikan dan mengelola aplikasi, data, layanan, dan sistem Anda.
Azure Logic Apps dikelola sepenuhnya oleh Microsoft Azure, yang membebaskan Anda dari kekhawatiran tentang hosting, penskalaan, pengelolaan, pemantauan, dan pengelolaan solusi yang dibangun dengan layanan ini. Saat Anda menggunakan kemampuan ini untuk membuat aplikasi dan solusi tanpa server, Anda hanya dapat fokus pada logika dan fungsionalitas bisnis. Layanan ini secara otomatis menskalakan untuk memenuhi kebutuhan Anda, membuat alur kerja otomatisasi lebih cepat, dan membantu Anda membangun aplikasi cloud yang kuat menggunakan sedikit atau tanpa kode.
Panggilan fungsi di Azure Logic Apps melalui Assistants Playground
Untuk mempercepat dan menyederhanakan pembuatan aplikasi cerdas, kami sekarang mengaktifkan kemampuan untuk memanggil alur kerja Logic Apps melalui panggilan fungsi di Asisten Azure OpenAI.
Taman bermain Asisten menghitung dan mencantumkan semua alur kerja dalam langganan Anda yang memenuhi syarat untuk panggilan fungsi. Berikut adalah persyaratan untuk alur kerja ini:
- Aplikasi Logika Konsumsi: Saat ini kami hanya mendukung alur kerja konsumsi.
- Pemicu permintaan: Panggilan fungsi memerlukan API berbasis REST. Logic Apps dengan pemicu permintaan menyediakan titik akhir REST. Oleh karena itu, hanya alur kerja dengan pemicu permintaan yang didukung untuk panggilan fungsi.
- Skema: Alur kerja yang ingin Anda gunakan untuk panggilan fungsi harus memiliki skema JSON yang menjelaskan input dan output yang diharapkan. Menggunakan Logic Apps, Anda dapat menyederhanakan dan menyediakan skema dalam pemicu, yang akan diimpor secara otomatis sebagai definisi fungsi.
Jika Anda sudah memiliki alur kerja dengan tiga persyaratan di atas, Anda harus dapat menggunakannya di Azure OpenAI Studio dan memanggilnya melalui perintah pengguna. Jika Anda tidak memiliki alur kerja yang sudah ada, Anda bisa mengikuti langkah-langkah dalam artikel ini untuk membuatnya. Ada dua langkah utama:
- Buat Aplikasi Logika di portal Azure.
- Impor alur kerja Logic Apps Anda sebagai fungsi di Assistants Playground.
Membuat alur kerja Logic Apps untuk panggilan fungsi
Berikut adalah langkah-langkah untuk membuat alur kerja Logic Apps baru untuk panggilan fungsi.
Di kotak pencarian portal Azure, masukkan aplikasi logika, dan pilih Aplikasi logika.
Pada toolbar halaman Aplikasi logika, pilih Tambahkan.
Pada halaman Buat Aplikasi Logika, pertama-tama pilih Jenis paket untuk sumber daya aplikasi logika Anda. Dengan begitu, hanya opsi untuk jenis paket tersebut yang muncul.
Di bagian Paket , untuk Jenis paket, pilih Konsumsi untuk melihat hanya pengaturan sumber daya aplikasi logika konsumsi.
Berikan informasi berikut untuk sumber daya aplikasi logika Anda: Langganan, Grup Sumber Daya, Nama Aplikasi Logika, dan Wilayah.
Saat Anda siap, pilih Tinjau + Buat.
Pada halaman validasi yang muncul, konfirmasikan semua informasi yang disediakan, dan pilih Buat.
Setelah Azure berhasil menyebarkan sumber daya aplikasi logika Anda, pilih Buka sumber daya. Atau, temukan dan pilih aplikasi logika Anda dengan mengetikkan nama dalam kotak pencarian Microsoft Azure.
Buka alur kerja Logic Apps di perancang. Pilih Alat Pengembangan + Perancang aplikasi logika. Ini membuka alur kerja kosong Anda di perancang. Atau Anda memilih Aplikasi Logika Kosong dari templat
Sekarang Anda siap untuk menambahkan satu langkah lagi dalam alur kerja. Alur kerja selalu dimulai dengan satu pemicu, yang menentukan kondisi yang akan dipenuhi sebelum menjalankan tindakan berikutnya dalam alur kerja.
Alur kerja Anda diperlukan untuk memiliki pemicu Permintaan untuk menghasilkan titik akhir REST, dan tindakan respons untuk mengembalikan respons ke Azure OpenAI Studio saat alur kerja ini dipanggil.
Menambahkan pemicu (Permintaan)
Pilih Tambahkan pemicu lalu cari pemicu permintaan. Pilih operasi Saat permintaan HTTP diterima.
Berikan skema JSON untuk permintaan tersebut. Jika Anda tidak memiliki skema, gunakan opsi untuk menghasilkan skema.
Berikut adalah contoh skema permintaan. Anda bisa menambahkan deskripsi untuk alur kerja Anda di kotak komentar. Ini diimpor oleh Azure OpenAI Studio sebagai deskripsi fungsi.
Simpan alur kerja. Ini akan menghasilkan titik akhir REST untuk alur kerja.
Bergantung pada kasus penggunaan bisnis, Anda sekarang dapat menambahkan satu atau beberapa langkah/tindakan dalam alur kerja ini. Misalnya, menggunakan konektor cuaca MSN untuk mendapatkan prakiraan cuaca untuk lokasi saat ini.
Dalam tindakan untuk mendapatkan prakiraan untuk hari ini, kami menggunakan properti lokasi yang diteruskan ke alur kerja ini sebagai input.
Konfigurasikan respons. Alur kerja perlu mengembalikan respons kembali ke Azure OpenAI Studio. Ini dilakukan menggunakan tindakan Respons.
Dalam tindakan respons, Anda dapat memilih output dari salah satu langkah sebelumnya. Anda juga dapat secara opsional memberikan skema JSON jika Anda ingin mengembalikan output dalam format tertentu.
Alur kerja sekarang siap. Di Azure OpenAI Studio, Anda dapat mengimpor fungsi ini menggunakan fitur Tambahkan fungsi di taman bermain Asisten.
Mengimpor alur kerja Logic Apps Anda sebagai fungsi
Berikut adalah langkah-langkah untuk mengimpor alur kerja Logic Apps Anda sebagai fungsi di taman bermain Asisten di Azure OpenAI Studio:
Di Azure OpenAI Studio, pilih Asisten. Pilih Asisten yang sudah ada atau buat yang baru. Setelah mengonfigurasi asisten dengan nama dan instruksi, Anda siap untuk menambahkan fungsi. Pilih + Tambahkan fungsi.
Opsi Tambahkan fungsi membuka layar dengan dua tab. Navigasi ke tab untuk Logic Apps untuk menelusuri alur kerja Anda dengan pemicu permintaan. Pilih alur kerja dari daftar dan pilih Simpan.
Catatan
Daftar ini hanya memperlihatkan alur kerja SKU konsumsi dan dengan pemicu permintaan.
Anda sekarang telah berhasil mengimpor alur kerja Anda dan siap untuk dipanggil. Spesifikasi fungsi dihasilkan berdasarkan swagger alur kerja aplikasi logika dan menyertakan skema dan deskripsi berdasarkan apa yang Anda konfigurasikan dalam tindakan pemicu permintaan.
Alur kerja sekarang akan dipanggil oleh Asisten Azure OpenAI berdasarkan permintaan pengguna. Di bawah ini adalah contoh di mana alur kerja dipanggil secara otomatis berdasarkan permintaan pengguna untuk mendapatkan cuaca.
Anda dapat mengonfirmasi pemanggilan dengan melihat log serta riwayat eksekusi alur kerja Anda.
FAQ
Apa itu Konektor aplikasi Logika?
Azure Logic Apps memiliki konektor ke ratusan aplikasi dan database lini bisnis (LOB) termasuk tetapi tidak terbatas pada: SAP, Salesforce, Oracle, SQL, dan banyak lagi. Anda juga dapat terhubung ke aplikasi SaaS atau aplikasi internal Anda yang dihosting di jaringan virtual. Konektor out of box ini menyediakan operasi untuk mengirim dan menerima data dalam beberapa format. Memanfaatkan kemampuan ini dengan asisten Azure OpenAI, Anda harus dapat dengan cepat membawa data Anda untuk Intelligent Insights yang didukung oleh Azure OpenAI.
Apa yang terjadi ketika Logic Apps diimpor di Azure OpenAI Studio dan dipanggil
File swagger Logic Apps digunakan untuk mengisi definisi fungsi. Azure Logic App menerbitkan definisi OpenAPI 2.0 (swagger) untuk alur kerja dengan pemicu permintaan berdasarkan anotasi pada alur kerja. Pengguna dapat memodifikasi konten swagger ini dengan memperbarui alur kerja mereka. Azure OpenAI Studio menggunakan ini untuk menghasilkan definisi fungsi yang diperlukan Asisten.
Bagaimana cara kerja autentikasi dari Azure OpenAI Studio ke Logic Apps?
Logic Apps mendukung dua jenis autentikasi utama untuk memanggil pemicu permintaan.
Autentikasi berbasis Tanda Tangan Akses Bersama (SAS).
Pengguna dapat memperoleh URL panggilan balik yang berisi SAS menggunakan API URL panggilan balik daftar. Logic Apps juga mendukung penggunaan beberapa kunci dan memutarnya sesuai kebutuhan. Logic Apps juga mendukung pembuatan URL SAS dengan periode validitas tertentu. Untuk informasi selengkapnya, lihat dokumentasi Logic Apps.
Kebijakan autentikasi dasar OAuth berbasis ID Microsoft Entra.
Logic Apps juga mendukung pemanggilan pemicu autentikasi dengan Microsoft Entra ID OAuth, di mana Anda dapat menentukan kebijakan autentikasi yang akan digunakan dalam memvalidasi token OAuth. Untuk informasi selengkapnya, lihat dokumentasi Logic Apps.
Ketika Asisten Azure OpenAI mengharuskan memanggil Aplikasi Logika sebagai bagian dari panggilan fungsi, Azure OpenAI Studio akan mengambil URL panggilan balik dengan SAS untuk memanggil alur kerja.