Menggunakan aplikasi web Azure OpenAI
Bersama dengan Azure OpenAI Studio, API, dan SDK, Anda juga dapat menggunakan aplikasi web mandiri yang tersedia untuk berinteraksi dengan model Azure OpenAI menggunakan antarmuka pengguna grafis, yang dapat Anda sebarkan menggunakan studio Azure OpenAI atau penyebaran manual.
Pertimbangan penting
Penerbitan membuat Azure App Service di langganan Anda. Ini mungkin dikenakan biaya tergantung pada paket harga yang Anda pilih. Setelah selesai dengan aplikasi, Anda dapat menghapusnya dari portal Azure.
Model pratinjau visi gpt-4 tidak didukung.
Secara default, aplikasi akan disebarkan dengan IdP Microsoft yang sudah dikonfigurasi, membatasi akses ke aplikasi kepada anggota penyewa Azure Anda. Untuk menambahkan atau mengubah autentikasi:
Buka portal Azure dan cari nama aplikasi yang Anda tentukan selama penerbitan. Pilih aplikasi web, dan buka tab Autentikasi di menu navigasi kiri. Lalu pilih Tambahkan IdP.
Pilih Microsoft sebagai penyedia identitas. Pengaturan default di halaman ini hanya akan membatasi aplikasi ke penyewa Anda, sehingga Anda tidak perlu mengubah hal lain di sini. Lalu pilih Tambahkan
Sekarang pengguna akan diminta untuk masuk dengan akun ID Microsoft Entra mereka untuk dapat mengakses aplikasi Anda. Anda dapat mengikuti proses serupa untuk menambahkan IdP lain jika mau. Aplikasi ini tidak menggunakan informasi masuk pengguna dengan cara lain selain memverifikasi bahwa mereka adalah anggota penyewa Anda.
Kustomisasi aplikasi web
Anda dapat menyesuaikan logika frontend dan backend aplikasi. Aplikasi ini menyediakan beberapa variabel lingkungan untuk skenario kustomisasi umum seperti mengubah ikon di aplikasi. Lihat kode sumber untuk aplikasi web, dan informasi selengkapnya di GitHub.
Saat menyesuaikan aplikasi, sebaiknya:
Mengatur ulang sesi obrolan (hapus obrolan) jika pengguna mengubah pengaturan apa pun. Beri tahu pengguna bahwa riwayat obrolan mereka akan hilang.
Berkomunikasi dengan jelas bagaimana setiap pengaturan yang Anda terapkan akan memengaruhi pengalaman pengguna.
Saat Anda memutar kunci API untuk sumber daya Azure OpenAI atau Azure AI Search, pastikan untuk memperbarui pengaturan aplikasi untuk setiap aplikasi yang Anda sebarkan untuk menggunakan kunci baru.
Contoh kode sumber untuk aplikasi web tersedia di GitHub. Kode sumber disediakan "apa adanya" dan sebagai sampel saja. Pelanggan bertanggung jawab atas semua penyesuaian dan implementasi aplikasi web mereka.
Memperbarui aplikasi web
Catatan
Setelah 1 Februari 2024, aplikasi web mengharuskan perintah startup aplikasi diatur ke python3 -m gunicorn app:app. Saat memperbarui aplikasi yang diterbitkan sebelum 1 Februari 2024, Anda perlu menambahkan perintah startup secara manual dari halaman App Service Configuration .
Sebaiknya tarik perubahan dari main cabang untuk kode sumber aplikasi web secara sering untuk memastikan Anda memiliki perbaikan bug, versi API, dan peningkatan terbaru. Selain itu, aplikasi web harus disinkronkan setiap kali versi API yang digunakan dihentikan.
Pertimbangkan untuk mengklik tombol jam tangan atau bintang di repositori GitHub aplikasi web untuk diberi tahu tentang perubahan dan pembaruan pada kode sumber.
Jika Anda belum menyesuaikan aplikasi:
- Anda dapat mengikuti langkah-langkah sinkronisasi di bawah ini
Jika Anda telah menyesuaikan atau mengubah kode sumber aplikasi:
- Anda harus memperbarui kode sumber aplikasi secara manual dan menyebarkannya kembali.
- Jika aplikasi Anda dihosting di GitHub, dorong perubahan kode Anda ke repositori Anda, dan gunakan langkah-langkah sinkronisasi di bawah ini.
- Jika Anda menyebarkan ulang aplikasi secara manual (misalnya Azure CLI), ikuti langkah-langkah untuk strategi penyebaran Anda.
Menyinkronkan aplikasi web
Jika Anda telah menyesuaikan aplikasi, perbarui kode sumber aplikasi.
Navigasi ke aplikasi web Anda di portal Azure.
Pilih Pusat penyebaran di menu navigasi, di bawah Penyebaran.
Pilih Sinkronkan di bagian atas layar, dan konfirmasikan bahwa aplikasi akan disebarkan ulang.
Riwayat obrolan
Anda dapat mengaktifkan riwayat obrolan untuk pengguna aplikasi web. Saat Anda mengaktifkan fitur ini, pengguna Anda akan memiliki akses ke masing-masing kueri dan respons sebelumnya.
Untuk mengaktifkan riwayat obrolan, sebarkan atau sebarkan ulang model Anda sebagai aplikasi web menggunakan Azure OpenAI Studio.
Penting
Mengaktifkan riwayat obrolan akan membuat instans Cosmos DB di grup sumber daya Anda, dan dikenakan biaya tambahan untuk penyimpanan yang digunakan.
Setelah mengaktifkan riwayat obrolan, pengguna Anda akan dapat menampilkan dan menyembunyikannya di sudut kanan atas aplikasi. Saat riwayat ditampilkan, riwayat dapat mengganti nama, atau menghapus percakapan. Saat mereka masuk ke aplikasi, percakapan akan secara otomatis diurutkan dari yang terbaru ke terlama, dan dinamai berdasarkan kueri pertama dalam percakapan.
Menghapus instans Cosmos DB Anda
Menghapus aplikasi web Anda tidak menghapus instans Cosmos DB Anda secara otomatis. Untuk menghapus instans Cosmos DB Anda, bersama dengan semua obrolan yang disimpan, Anda perlu menavigasi ke sumber daya terkait di portal Azure dan menghapusnya. Jika Anda menghapus sumber daya Cosmos DB tetapi tetap mengaktifkan opsi riwayat obrolan di studio, pengguna Anda akan diberi tahu tentang kesalahan koneksi, tetapi dapat terus menggunakan aplikasi web tanpa akses ke riwayat obrolan.