Menyiapkan Lingkungan Pengembangan untuk Azure AI Foundry

July 2, 2026 · View on GitHub

Panduan ini menyiapkan model Azure AI Foundry untuk aplikasi AI Java dalam kursus ini, menggunakan autentikasi tanpa kunci (Microsoft Entra ID) — tidak perlu mengelola kunci API. Baru menggunakan alat ini? Mulai dengan panduan lingkungan pengembangan.

Panduan ini menyiapkan model Azure AI Foundry untuk aplikasi AI Java dalam kursus ini. Anda memiliki dua pilihan:

  • Opsi A — Penyediaan dengan azd + Bicep (direkomendasikan): satu perintah untuk menerapkan akun Foundry dan model sebagai kode. Tidak perlu klik-klik di portal.
  • Opsi B — Membuat sumber daya secara manual di portal Azure AI Foundry.

Kedua pilihan menggunakan autentikasi tanpa kunci (Microsoft Entra ID) — tidak ada kunci API yang perlu disalin atau bocor.

Daftar Isi

Apa yang Dibuat

Template Bicep di infra/ menyediakan:

  • Akun Azure AI Foundry (Microsoft.CognitiveServices/accounts, jenis AIServices) dengan sebuah proyek
  • Sebuah deployment chat — gpt-4o-mini
  • Sebuah deployment embedding — text-embedding-3-small (dipakai di bab-bab berikutnya)
  • Sebuah penugasan peran tanpa kunci (Cognitive Services OpenAI User) sehingga Anda masuk dengan az login tanpa perlu mengelola kunci

Prasyarat

Opsi A: Penyediaan dengan azd + Bicep (Direkomendasikan)

Dari folder 02-SetupDevEnvironment:

cd 02-SetupDevEnvironment

# Masuk (kedua alat)
azd auth login
az login

# Menyediakan akun Foundry + penyebaran model
azd up

azd akan meminta nama lingkungan (misalnya genai-java) dan wilayah. Pilih wilayah dimana gpt-4o-mini dan text-embedding-3-small tersedia — misalnya eastus2 atau swedencentral.

Setelah penyediaan selesai, azd:

  1. Menerapkan semua yang didefinisikan di infra/main.bicep.
  2. Menjalankan hook pascapenyediaan yang menulis examples/basic-chat-azure/.env dengan endpoint dan nama deployment Anda (tanpa rahasia).

Tip: Jalankan ulang azd up kapan saja untuk menerapkan perubahan. Jalankan azd down untuk menghapus semuanya dan menghentikan biaya.

Untuk melihat pengaturan yang dihasilkan:

azd env get-values

Sekarang lompat ke Uji Pengaturan Anda.

Opsi B: Membuat Sumber Daya Secara Manual

Lebih suka portal? Buat sumber daya secara manual:

  1. Buka portal Azure AI Foundry dan masuk.
  2. Buat proyek (ini juga membuat sumber daya AI Foundry). Beri nama seperti GenAIJava.
  3. Dalam proyek Anda, buka Models + endpoints → Deploy model → Deploy base model.
  4. Deploy gpt-4o-mini (nama deployment gpt-4o-mini). Ulangi untuk text-embedding-3-small jika Anda ingin contoh embedding.
  5. Dari Overview, salin endpoint (misalnya https://<resource>.openai.azure.com/).
  6. Beri diri Anda akses tanpa kunci: di sumber daya, buka Access control (IAM) → Add role assignment → tetapkan Cognitive Services OpenAI User ke akun Anda.

Masih mengalami kesulitan? Lihat dokumentasi Azure AI Foundry.

Konfigurasikan Lingkungan Anda

Jika Anda menggunakan Opsi A (azd up), file pengaturan Anda sudah dibuat — tidak perlu konfigurasi lagi. Lewati ke Uji Pengaturan Anda.

Jika Anda menggunakan Opsi B (manual), buat file .env contoh sendiri:

cd 02-SetupDevEnvironment/examples/basic-chat-azure
cp .env.example .env

Edit .env dengan endpoint Anda (tanpa kunci — autentikasi tanpa kunci):

AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT=gpt-4o-mini

Catatan keamanan: Tidak ada kunci API yang perlu disimpan. Anda mengautentikasi dengan Microsoft Entra ID melalui az login (lokal) atau identitas terkelola (di Azure). File .env hanya berisi pengaturan yang tidak rahasia dan sudah dilindungi oleh .gitignore.

Uji Pengaturan Anda

Pastikan Anda sudah masuk supaya autentikasi tanpa kunci bisa mendapatkan token, lalu jalankan contoh:

cd 02-SetupDevEnvironment/examples/basic-chat-azure

az login          # jika Anda belum masuk
mvn clean spring-boot:run

Anda akan melihat respons dari model gpt-4o-mini!

Pengguna VS Code: Tekan F5 untuk menjalankan. Aplikasi akan memuat .env Anda secara otomatis.

Contoh lengkap: Lihat Contoh Basic Chat dengan Azure AI Foundry untuk detail dan pemecahan masalah.

Apa Selanjutnya?

Pengaturan selesai! Sekarang Anda memiliki:

  • Azure AI Foundry dengan gpt-4o-mini dan text-embedding-3-small yang sudah dideploy
  • Autentikasi tanpa kunci (Microsoft Entra ID) — tanpa kunci untuk dikelola
  • File .env lokal dengan endpoint dan nama deployment Anda
  • Lingkungan pengembangan Java yang siap pakai

Lanjutkan ke Bab 3: Teknik Inti Generatif AI untuk mulai membangun aplikasi AI!

Sumber Daya

Sumber Daya Tambahan

Penafian: Dokumen ini telah diterjemahkan menggunakan layanan terjemahan AI Co-op Translator. Meskipun kami berupaya untuk mencapai akurasi, harap diketahui bahwa terjemahan otomatis mungkin mengandung kesalahan atau ketidakakuratan. Dokumen asli dalam bahasa aslinya harus dianggap sebagai sumber yang sah. Untuk informasi penting, disarankan menggunakan terjemahan profesional oleh manusia. Kami tidak bertanggung jawab atas kesalahpahaman atau penafsiran yang keliru yang timbul dari penggunaan terjemahan ini.