Menggunakan aplikasi web Azure OpenAI

Bersama dengan Azure OpenAI Studio, API, dan SDK, Anda dapat menggunakan aplikasi web mandiri yang tersedia untuk berinteraksi dengan model Azure OpenAI Service dengan menggunakan antarmuka pengguna grafis. Anda dapat menyebarkan aplikasi dengan menggunakan Azure OpenAI Studio atau penyebaran manual.

Pertimbangan penting

• Penerbitan membuat instans 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.

• GPT-4 Turbo dengan model Visi tidak didukung.

• Secara default, aplikasi disebarkan dengan IdP Microsoft yang sudah dikonfigurasi. IdP membatasi akses ke aplikasi kepada anggota penyewa Azure Anda. Untuk menambahkan atau mengubah autentikasi:

  1. Buka portal Azure dan cari nama aplikasi yang Anda tentukan selama penerbitan. Pilih aplikasi web, lalu pilih Autentikasi di menu sebelah kiri. Lalu pilih Tambahkan IdP.

     

  2. Pilih Microsoft sebagai penyedia identitas. Pengaturan default di halaman ini membatasi aplikasi hanya untuk penyewa Anda, sehingga Anda tidak perlu mengubah hal lain di sini. Pilih Tambahkan.

  Sekarang pengguna akan diminta untuk masuk dengan akun Microsoft Entra mereka untuk mengakses aplikasi Anda. Anda dapat mengikuti proses serupa untuk menambahkan IdP lain jika mau. Aplikasi ini tidak menggunakan informasi masuk pengguna dengan cara apa pun selain memverifikasi bahwa pengguna adalah anggota penyewa Anda.

Kustomisasi aplikasi web

Anda dapat menyesuaikan logika front-end dan back-end aplikasi. Aplikasi ini menyediakan beberapa variabel lingkungan untuk skenario kustomisasi umum seperti mengubah ikon di aplikasi.

Saat Anda menyesuaikan aplikasi, kami sarankan:

• 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.

• Memperbarui pengaturan aplikasi untuk setiap aplikasi yang Disebarkan untuk menggunakan kunci API baru setelah Anda memutar kunci untuk sumber daya Azure OpenAI atau Azure AI Search Anda.

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

Mulai 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 bahwa Anda memiliki perbaikan bug, versi API, dan peningkatan terbaru. Selain itu, aplikasi web harus disinkronkan setiap kali versi API yang Anda gunakan dihentikan. Pertimbangkan untuk memilih tombol Watch atau Star di repositori GitHub aplikasi web untuk diberi tahu tentang perubahan dan pembaruan kode sumber.

Jika Anda belum mengkustomisasi aplikasi web, Anda dapat menggunakan langkah-langkah ini untuk menyinkronkannya:

1. Buka aplikasi web Anda di portal Azure.

2. Di menu sebelah kiri, di bawah Penyebaran, pilih Pusat Penyebaran.

3. Pilih Sinkronkan di bagian atas panel, dan konfirmasikan bahwa aplikasi akan disebarkan ulang.

   

Jika Anda menyesuaikan atau mengubah kode sumber aplikasi, Anda perlu memperbarui kode sumber aplikasi secara manual dan menyebarkannya kembali:

• Jika aplikasi Anda dihosting di GitHub, dorong perubahan kode Anda ke repositori Anda, lalu gunakan langkah-langkah sinkronisasi sebelumnya.
• Jika Anda menyebarkan ulang aplikasi secara manual (misalnya, dengan menggunakan Azure CLI), ikuti langkah-langkah untuk strategi penyebaran Anda.

Riwayat obrolan

Anda dapat mengaktifkan riwayat obrolan untuk pengguna aplikasi web. Saat Anda mengaktifkan fitur, pengguna memiliki akses ke masing-masing kueri dan respons sebelumnya.

Untuk mengaktifkan riwayat obrolan, sebarkan atau sebarkan ulang model Anda sebagai aplikasi web dengan menggunakan Azure OpenAI Studio dan pilih Aktifkan riwayat obrolan di aplikasi web.

Penting

Mengaktifkan riwayat obrolan membuat instans Azure Cosmos DB di grup sumber daya Anda, dan dikenakan biaya tambahan untuk penyimpanan yang Anda gunakan.

Setelah mengaktifkan riwayat obrolan, pengguna Anda dapat menampilkan dan menyembunyikannya di sudut kanan atas aplikasi. Saat pengguna memperlihatkan riwayat obrolan, mereka dapat mengganti nama atau menghapus percakapan. Karena pengguna masuk ke aplikasi, percakapan secara otomatis dipesan dari yang terbaru ke terlama. Percakapan 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 Bersama dengan semua obrolan yang disimpan, Anda perlu membuka sumber daya terkait di portal Azure dan menghapusnya. Jika Anda menghapus sumber daya Cosmos DB tetapi 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.

Konten terkait

• Rekayasa perintah
• Azure OpenAI Pada data Anda