Atur lingkungan Anda

Dalam artikel ini, Anda menyebarkan infrastruktur yang diperlukan untuk membuat agen dengan Foundry Agent Service. Setelah menyelesaikan penyiapan ini, Anda dapat membuat dan mengonfigurasi agen menggunakan SDK pilihan Anda atau portal Foundry.

Membuat agen pertama Anda adalah proses dua langkah:

1. Siapkan lingkungan agen Anda (artikel ini).
2. Membuat dan mengonfigurasi agen Anda.

Memerlukan izin

Tindakan	Peran yang Diperlukan
Membuat akun dan proyek	Azure Pemilik Akun AI
penyiapan standar Hanya: Tetapkan RBAC untuk sumber daya yang diperlukan (Cosmos DB, Search, Storage, dll.)	Administrator Kontrol Akses Berbasis Peran
Membuat dan mengedit agen	Pengguna AI Azure

Menyiapkan lingkungan agen Anda

Untuk memulai, Anda memerlukan sumber daya Microsoft Foundry dan proyek Foundry.
Agen dibuat dalam proyek tertentu, dan setiap proyek bertindak sebagai ruang kerja terisolasi. Ini berarti:

• Semua agen dalam proyek yang sama berbagi akses ke penyimpanan file, penyimpanan utas (riwayat percakapan) yang sama, dan indeks pencarian.
• Data terisolasi antar proyek. Agen dalam satu proyek tidak dapat mengakses sumber daya dari proyek lain. Saat ini, proyek merupakan unit berbagi dan isolasi di Foundry. Lihat artikel apa itu foundry AI untuk informasi selengkapnya tentang proyek Foundry.

Prasyarat

• Langganan Azure - Buat langganan secara gratis.
• Pastikan bahwa individu yang membuat akun dan proyek memiliki peran Azure AI Account Owner di cakupan langganan
• Jika mengonfigurasi pengaturan standard, individu yang sama juga harus memiliki izin untuk menetapkan peran ke sumber daya yang diperlukan (Cosmos DB, Azure AI Search, Azure Blob Storage). Untuk informasi selengkapnya tentang peran RBAC, khusus untuk Layanan Agen, lihat Peran RBAC Layanan Agen.
  • Peran bawaan yang diperlukan adalah Administrator Akses Berbasis Peran.
  • Atau, memiliki peran Pemilik di tingkat langganan juga memenuhi persyaratan ini.
  • Izin kunci yang diperlukan adalah: Microsoft.Authorization/roleAssignments/write

Pilih penyiapan Anda

Agent Service menawarkan tiga mode konfigurasi lingkungan yang sesuai dengan kebutuhan yang berbeda:

• Penyetelan Dasar:

  Penyiapan ini kompatibel dengan Asisten OpenAI dan mengelola status agen menggunakan penyimpanan bawaan platform. Ini termasuk alat dan kemampuan yang sama dengan Assistants API, dengan dukungan tambahan untuk model dan alat non-OpenAI seperti Azure AI Search, dan Bing.

• Penyiapan Standar:

  Mencakup semua yang ada dalam penyiapan dasar dan kontrol mendasar atas data Anda dengan memungkinkan Anda menggunakan sumber daya Azure Anda sendiri. Semua data pelanggan—termasuk file, utas, dan penyimpanan vektor—disimpan di sumber daya Azure Anda sendiri, memberi Anda kepemilikan dan kontrol penuh.

• Pengaturan Standar dengan Jaringan Virtual Pribadi (BYO):

  Mencakup semua yang ada dalam Penyiapan Standar, dengan kemampuan tambahan untuk beroperasi sepenuhnya dalam jaringan virtual Anda sendiri. Penyiapan ini mendukung Bring Your Own Virtual Network (BYO virtual network), memungkinkan kontrol ketat atas pergerakan data dan membantu mencegah penyelundupan data dengan menjaga lalu lintas terbatas pada lingkungan jaringan Anda.

Membandingkan opsi penyiapan

Nota

Isolasi Jaringan Privat pada tabel di bawah ini merujuk pada komunikasi keluar Secured Agent. Pengaturan dasar tidak berlaku, dan Anda dapat menggunakan Isolasi Jaringan Privat untuk Agen Anda hanya dengan Pengaturan Standar.

Komunikasi aman masuk dapat diterapkan ke semua penyiapan di bawah ini, dengan menambahkan titik akhir privat dan menonaktifkan akses publik masuk untuk Akun Foundry Anda.

Kasus Penggunaan	Penyetelan Dasar	Pengaturan Standar dengan Jaringan Publik	Pemasangan Standar dengan Jaringan Pribadi
Memulai dengan cepat tanpa mengelola sumber daya	✅
Semua riwayat percakapan, file, dan penyimpanan vektor disimpan di sumber daya Anda sendiri		✅	✅
Dukungan untuk Kunci yang Dikelola Pelanggan (CMK)		✅	✅
Isolasi Jaringan Privat (Bawa jaringan virtual Anda sendiri)			✅

Opsi penempatan

Untuk mengkustomisasi templat ini, lihat menggunakan sumber daya Anda sendiri.

Jika Anda memerlukan dukungan untuk Isolasi Jaringan Pribadi, lihat penyiapan yang diamankan jaringan untuk informasi lebih lanjut tentang cara membawa jaringan virtual Anda sendiri.

Deskripsi dan Penyebaran Otomatis	Diagram (klik untuk memperbesar)
Sebarkan penyiapan agen dasar yang menggunakan Identitas Terkelola untuk autentikasi. Akun dan proyek dibuat. Model GPT-4.1 telah diterapkan. Key Vault yang dikelola Microsoft digunakan secara default.
Sebarkan penyiapan agen standar yang menggunakan Identitas Terkelola untuk autentikasi. Akun dan proyek dibuat. Model GPT-4.1 telah diterapkan. Azure sumber daya untuk menyimpan data pelanggan—Azure Storage, Azure Cosmos DB, dan Azure AI Search—secara otomatis dibuat jika sumber daya yang ada tidak disediakan. Sumber daya ini terhubung ke proyek Anda untuk menyimpan file, utas, dan data vektor. Key Vault yang dikelola Microsoft digunakan secara default.

[Opsional] Pemilihan model dalam templat autodeploy

Penting

Jangan ubah parameter modelFormat.

Templat hanya mendukung penyebaran model OpenAI Azure. Lihat model OpenAI Azure mana yang didukung di artikel dukungan model.

Anda dapat menyesuaikan model yang digunakan oleh agen Anda dengan mengedit parameter model di templat autodeploy. Untuk menerapkan model yang berbeda, Anda perlu memperbarui setidaknya parameter modelName dan modelVersion.

Secara default, templat penyebaran dikonfigurasi dengan nilai berikut:

Model Parameter	Nilai Bawaan
modelName	gpt-4.1
modelFormat	OpenAI (untuk Azure OpenAI)
modelVersion	2025-04-14
namaModelSku	GlobalStandard
modelLocation	eastus

Verifikasi penerapan Anda

Setelah penyebaran selesai (biasanya 5-10 menit), verifikasi bahwa sumber daya Anda berhasil dibuat:

1. Buka portal Azure.
2. Cari nama grup sumber daya Anda.
3. Konfirmasikan bahwa sumber daya berikut ada:
   • Pengaturan Dasar: Akun Foundry, proyek, dan penyebaran model.
   • penyiapan Standard: Semua sumber daya dasar ditambah akun Azure Storage, akun Azure Cosmos DB, dan layanan Azure AI Search.

Petunjuk / Saran

Jika penyebaran gagal, periksa bagian Penyebaran di grup sumber daya Anda untuk detail kesalahan. Masalah umum termasuk kuota yang tidak mencukup untuk model atau izin yang hilang.

Troubleshooting

Masalah	Penyebab	Solusi
Penyebaran gagal karena kesalahan kuota	Kuota tidak cukup untuk GPT-4.1 di wilayah yang dipilih	Meminta penambahan kuota atau memilih wilayah lain
Izin ditolak selama penyebaran	Peran Administrator Akses Berbasis Peran Hilang	Minta pemilik langganan Anda untuk memberi Anda peran yang diperlukan
Sumber daya dibuat tetapi pembuatan agen gagal	Proyek tidak tersambung dengan benar ke sumber daya	Verifikasi koneksi di portal Foundry di bawah Pengaturan> proyekSumber daya tersambung
Model tidak tersedia	Model tidak tersedia di wilayah Anda	Periksa dukungan wilayah model dan pilih wilayah yang tersedia

Apa selanjutnya?

• Membuat agen pertama Anda

• Jelajahi lebih lanjut:

  • Menggunakan sumber daya yang sudah ada
  • Penyiapan agen aman jaringan