Dalam cerita ini
Where: Settings → Content & publishing → Your AI accounts
Buka halaman ini: admin.<your-site>/settings/ai/providers (ganti <your-site> dengan alamat situs Anda)
Sebelum Mulai
- Akun Azure dengan resource Azure OpenAI.
- Setidaknya satu model yang sudah di-deploy di resource tersebut. Azure hanya menjalankan model setelah Anda melakukan deployment.
- Anda memiliki izin untuk melihat key resource di Azure.
- Hanya anggota yang mengelola AI yang dapat menghubungkan, dan Anda harus sudah login baru-baru ini.
Langkah-langkah
- Buka Azure portal lalu buka resource Azure OpenAI Anda.
- Buka Resource Management, lalu Keys and Endpoint.
- Salin Endpoint. Tampilannya seperti
https://my-resource.openai.azure.com. Akhirannya harus berupa.openai.azure.comatau.cognitiveservices.azure.com. - Salin KEY 1. Simpan KEY 2 sebagai cadangan. Admin Anda menerima key sepanjang 32 karakter (huruf a–f dan angka) atau 84 karakter.
- Cari nama deployment Anda. Di portal Azure AI Foundry, buka Deployments pada resource Anda. Nama deployment adalah nama yang Anda berikan saat men-deploy model. Namanya bisa berbeda dari nama model aslinya, contohnya
gpt-4o-mini. - Di admin situs Anda, buka Settings → Content & publishing → Your AI accounts, lalu cari kartu Azure OpenAI.
- Tempel Azure endpoint. Tambahkan setiap deployment di bawah Deployment names, lalu ketuk Add untuk setiap nama. Tambahkan minimal satu.
- Tempel key dan ketuk Test & connect. Anda akan melihat "Checking your key…" lalu Connected ✓.
Perlu Diketahui
- Anda dapat menghubungkan hingga dua resource Azure.
- Azure tidak memiliki daftar model otomatis untuk sebuah key, sehingga admin hanya menampilkan deployment yang Anda ketik. Tambahkan lagi nanti jika Anda men-deploy model baru.
- Pengisian harga bersifat opsional. Dengan harga, admin dapat menampilkan biaya. Tanpa harga, AI tidak akan beralih ke akun ini secara otomatis jika akun lain bermasalah.
- Azure yang menagih Anda. Azure portal mencatat biaya dan anggaran Anda. AI budget and limits
- Key tetap tersimpan di server Anda sendiri. Keynate tidak akan pernah melihatnya.
Kendala Umum
Gunakan endpoint Azure OpenAI Anda
Endpoint harus berakhiran .openai.azure.com atau .cognitiveservices.azure.com. Salin dari Keys and Endpoint. Domain kustom atau alamat IP tidak akan berfungsi.
Model atau deployment ini tidak tersedia di akun Azure OpenAI Anda
Nama deployment tidak cocok. Penulisan nama harus persis sama, termasuk huruf besar dan kecil. Periksa Deployments di Foundry, perbaiki namanya di kartu, lalu coba tes lagi.
Azure OpenAI menolak key ini
Salin ulang seluruh key dengan benar. Setiap key terikat pada satu resource, jadi gunakan key dari resource yang sama dengan endpoint.
Kami tidak dapat menjangkau alamat ini
Periksa kembali apakah ada salah ketik pada endpoint. Jika resource Anda hanya mengizinkan jaringan tertentu, pengujian bisa gagal. Buka akses publik ke resource tersebut, atau tambahkan alamat server Anda, lalu tes kembali.
Azure menyatakan kuota atau batas frekuensi telah tercapai
Tunggu sebentar, atau naikkan kuota deployment di Azure.
Pertanyaan
Pertanyaan umum
Key mana yang harus saya gunakan, KEY 1 atau KEY 2?
Bisa yang mana saja. Gunakan KEY 1. Jika Anda memperbarui key (rotate) di Azure, tempel key baru menggunakan Replace key.
Mengapa saya harus mengetik nama deployment?
Azure memungkinkan Anda memberi nama sendiri pada setiap deployment. Admin Anda tidak bisa menebaknya, jadi Anda perlu menentukan mana yang akan digunakan.