Bagikan melalui

Mulai cepat: Menyiapkan sumber daya Foundry pertama Anda

Dalam blok pembuka ini, Anda membuat sumber daya Microsoft Foundry dan verifikasi akses.

Pelajari cara membuat dan mengelola sumber daya Foundry. Ini adalah jenis sumber daya Azure utama untuk membangun, menyebarkan, dan mengelola model dan aplikasi AI generatif termasuk agen di Azure.

Sumber daya Azure diperlukan untuk menggunakan dan mengelola layanan di Azure. Ini mendefinisikan cakupan untuk mengonfigurasi akses, keamanan seperti jaringan, penagihan, dan pemantauan.

Sumber daya Foundry adalah versi terbaru dan penggantian nama dari "Foundry Tools" sebelumnya. Ini menyediakan lingkungan aplikasi untuk menghosting agen Anda, penyebaran model, evaluasi, dan banyak lagi.

Sumber daya Foundry dapat mengatur pekerjaan untuk beberapa kasus penggunaan, dan biasanya dibagikan antara tim pengembang yang mengerjakan kasus penggunaan di domain bisnis atau data serupa. Proyek bertindak sebagai folder untuk mengelompokkan pekerjaan terkait.

Diagram memperlihatkan sumber daya Foundry yang berisi beberapa proyek, masing-masing dengan penyebaran dan koneksi.

Nota

Hanya proyek default yang tersedia di portal Foundry (baru). Gunakan portal Foundry (klasik) untuk berinteraksi dengan semua proyek lain pada sumber daya Foundry.

Ingin mengonfigurasi Foundry dengan pengaturan keamanan tingkat lanjut? Lihat opsi pembuatan Foundry tingkat lanjut

Membuat sumber daya pertama Anda

Untuk membuat sumber daya pertama Anda, dengan pengaturan Azure dasar, ikuti langkah-langkah di bawah ini menggunakan portal Microsoft Azure, Azure CLI, atau PowerShell.

Prasyarat

  • Langganan Azure yang valid - Buat langganan secara gratis.
  • Peran Azure RBAC untuk membuat sumber daya. Anda memerlukan salah satu peran berikut yang ditetapkan pada langganan Azure atau grup sumber daya Anda:
    • Kontributor
    • Pemilik
    • Peran kustom dengan Microsoft.CognitiveServices/accounts/write izin

Membuat sumber daya Microsoft Foundry baru

Jika organisasi Anda memerlukan konfigurasi Azure yang disesuaikan seperti nama alternatif, kontrol keamanan, atau tag biaya, Anda mungkin perlu menggunakan portal Microsoft Azure atau opsi templat untuk mematuhi kepatuhan Azure Policy organisasi Anda.

Sumber daya Foundry tercantum di bawah Foundry>Foundry di portal Microsoft Azure. Jenis API adalah AIServices. Cari logo seperti yang ditunjukkan di sini:

Cuplikan layar sumber daya Foundry di portal Microsoft Azure.

Kiat

Portal Foundry menyediakan cara untuk membuat sumber daya Foundry baru dengan pengaturan dasar, default, .

Untuk membuat sumber daya Foundry di portal Microsoft Azure, ikuti instruksi berikut:

  1. Pilih tautan sumber daya Foundry ini: https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

  2. Pada halaman Buat , berikan informasi berikut ini:

    Detail proyek Deskripsi
    Langganan Pilih salah satu langganan Azure Anda yang tersedia.
    Grup sumber daya Grup sumber daya Azure yang akan berisi sumber daya Foundry Anda. Anda dapat membuat grup baru atau menambahkannya ke grup yang sudah ada sebelumnya.
    Wilayah Lokasi instans Foundry Tool Anda. Lokasi yang berbeda dapat menimbulkan latensi, tapi tidak berdampak pada ketersediaan runtime sumber daya Anda.
    Nama Nama deskriptif untuk sumber daya Foundry Anda. Misalnya, MyAIServicesResource.

  3. Konfigurasikan pengaturan lainnya untuk sumber daya Anda sesuai kebutuhan, baca dan terima ketentuan (sebagaimana berlaku), kemudian pilih Tinjau + buat.

Kiat

Jika langganan Anda tidak memungkinkan Anda membuat sumber daya Foundry, Anda mungkin perlu mengaktifkan hak istimewa penyedia sumber daya Azure tersebut menggunakan portal Microsoft Azure, perintah PowerShell , atau perintah Azure CLI. Jika Anda bukan pemilik langganan, mintalah seseorang dengan peran Pemilik atau Admin untuk menyelesaikan pendaftaran untuk Anda atau meminta hak istimewa /register/action untuk diberikan ke akun Anda.

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Foundry, Anda dapat menghapus sumber daya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya lain yang terkandung dalam grup ini.

  1. Di portal Microsoft Azure, luaskan menu di sebelah kiri untuk membuka menu layanan, lalu pilihGrup Sumber Daya untuk menampilkan daftar grup sumber daya Anda.
  2. Temukan grup sumber daya yang berisi sumber daya yang akan dihapus.
  3. Jika Anda ingin menghapus seluruh grup sumber daya, pilih nama grup sumber daya. Pada halaman berikutnya, Pilih Hapus grup sumber daya, dan konfirmasi.
  4. Jika Anda hanya ingin menghapus sumber daya Foundry, pilih grup sumber daya untuk melihat semua sumber daya di dalamnya. Pada halaman berikutnya, pilih sumber daya yang ingin Anda hapus, klik menu elipsis untuk baris tersebut, dan pilih Hapus.

Gunakan panduan mulai cepat ini untuk membuat sumber daya Foundry menggunakan perintah Azure Command-Line Interface (CLI).

Prasyarat

  • Langganan Azure yang valid - Buat langganan secara gratis.
  • Azure CLI versi 2.0 atau yang lebih baru.
  • Peran Azure RBAC untuk membuat sumber daya. Anda memerlukan salah satu peran berikut yang ditetapkan pada langganan Azure atau grup sumber daya Anda:
    • Kontributor
    • Pemilik
    • Peran kustom dengan Microsoft.CognitiveServices/accounts/write izin

Menginstal Azure CLI dan masuk

Instal Azure CLI. Untuk masuk ke penginstalan lokal CLI Anda, jalankan perintah az login:

az login

Membuat grup sumber daya baru

Sebelum membuat sumber daya Foundry, Anda harus memiliki grup sumber daya Azure untuk berisi sumber daya. Saat membuat sumber daya baru, terdapat opsi untuk membuat grup sumber daya baru, atau menggunakan sumber daya yang sudah ada. Artikel ini memperlihatkan cara membuat grup sumber daya baru.

Untuk membuat sumber daya, Anda memerlukan salah satu lokasi Azure yang tersedia untuk langganan Anda. Anda dapat mengambil daftar lokasi yang tersedia dengan perintah az account list-locations. Sebagian besar Foundry Tools dapat diakses dari beberapa lokasi. Pilih salah satu yang paling dekat dengan Anda, atau lihat lokasi mana yang tersedia untuk layanan ini.

Penting

  • Ingat lokasi Azure Anda, karena Anda akan membutuhkannya saat memanggil sumber daya Microsoft Foundry.
  • Ketersediaan beberapa Foundry Tools dapat bervariasi menurut wilayah. Untuk informasi selengkapnya, lihat Produk Azure berdasarkan wilayah.
az account list-locations --query "[].{Region:name}" --out table

Setelah Anda memiliki lokasi Azure Anda, buat grup sumber daya baru di Azure CLI menggunakan perintah az group create. Dalam contoh di bawah ini, ganti lokasi Azure westus2 dengan salah satu lokasi Azure yang tersedia untuk langganan Anda.

az group create --name ai-services-resource-group --location westus2

Membuat sumber daya Foundry

Untuk membuat dan berlangganan sumber daya Foundry baru, gunakan perintah az cognitiveservices account create . Perintah ini menambahkan sumber daya baru yang dapat ditagih ke grup sumber daya yang dibuat sebelumnya. Saat membuat sumber daya baru, Anda harus mengetahui jenis layanan yang ingin Anda gunakan, bersama dengan tingkat harganya (atau SKU) dan lokasi Azure.

Penting

Azure menyediakan lebih dari satu jenis sumber daya untuk Foundry Tools. Pastikan untuk membuatnya dengan kind dari AIServices.

Anda dapat membuat sumber daya Foundry bernama foundry-multi-service-resource dengan perintah di bawah ini.

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --location westus2 --yes

Kiat

Jika langganan Anda tidak memungkinkan Anda membuat sumber daya Foundry, Anda mungkin perlu mengaktifkan hak istimewa penyedia sumber daya Azure tersebut menggunakan portal Microsoft Azure, perintah PowerShell , atau perintah Azure CLI. Jika Anda bukan pemilik langganan, mintalah seseorang dengan peran Pemilik atau Admin untuk menyelesaikan pendaftaran untuk Anda atau meminta hak istimewa /register/action untuk diberikan ke akun Anda.

Mendapatkan penggunaan kuota saat ini untuk sumber daya Anda

Gunakan perintah az cognitiveservices account list-usage untuk mendapatkan informasi penggunaan sumber daya Anda.

az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Foundry, Anda dapat menghapusnya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya lain yang terkandung dalam grup ini.

Untuk menghapus grup sumber daya dan sumber daya terkait, gunakan az group delete command.

az group delete --name ai-services-resource-group

Gunakan panduan cepat ini untuk membuat sumber daya Foundry menggunakan perintah Azure PowerShell.

Prasyarat

  • Langganan Azure yang valid - Buat langganan secara gratis.
  • Azure PowerShell versi 5.0 atau yang lebih baru.
  • Peran Azure RBAC untuk membuat sumber daya. Anda memerlukan salah satu peran berikut yang ditetapkan pada langganan Azure atau grup sumber daya Anda:
    • Kontributor
    • Pemilik
    • Peran kustom dengan Microsoft.CognitiveServices/accounts/write izin

Menginstal Azure PowerShell dan masuk

Instal Azure PowerShell. Untuk masuk, jalankan perintah Connect-AzAccount :

Connect-AzAccount

Membuat grup sumber daya Microsoft Foundry baru

Sebelum membuat sumber daya Foundry, Anda harus memiliki grup sumber daya Azure untuk berisi sumber daya. Saat membuat sumber daya baru, terdapat opsi untuk membuat grup sumber daya baru, atau menggunakan sumber daya yang sudah ada. Artikel ini memperlihatkan cara membuat grup sumber daya baru.

Untuk membuat sumber daya, Anda memerlukan salah satu lokasi Azure yang tersedia untuk langganan Anda. Anda dapat mengambil daftar lokasi yang tersedia dengan perintah Get-AzLocation . Sebagian besar Foundry Tools dapat diakses dari beberapa lokasi. Pilih salah satu yang paling dekat dengan Anda, atau lihat lokasi mana yang tersedia untuk layanan ini.

Penting

  • Ingat lokasi Azure Anda, karena Anda akan membutuhkannya saat memanggil sumber daya Foundry.
  • Ketersediaan beberapa Foundry Tools dapat bervariasi menurut wilayah. Untuk informasi selengkapnya, lihat Produk Azure berdasarkan wilayah.
Get-AzLocation | Select-Object -Property Location, DisplayName

Setelah Anda memiliki lokasi Azure, buat grup sumber daya baru di Azure PowerShell menggunakan perintah New-AzResourceGroup . Dalam contoh di bawah ini, ganti lokasi Azure westus2 dengan salah satu lokasi Azure yang tersedia untuk langganan Anda.

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Membuat sumber daya Foundry

Untuk membuat dan berlangganan sumber daya Foundry baru, gunakan perintah New-AzCognitiveServicesAccount . Perintah ini menambahkan sumber daya baru yang dapat ditagih ke grup sumber daya yang dibuat sebelumnya. Saat membuat sumber daya baru, Anda harus mengetahui "jenis" layanan yang ingin Anda gunakan, sekaligus tingkat harga (atau SKU) dan lokasi Azure:

Penting

Azure menyediakan lebih dari satu jenis sumber daya untuk Foundry Tools. Pastikan untuk membuatnya dengan Type dari (jenis) AIServices.

Anda dapat membuat sumber daya Foundry bernama foundry-multi-service-resource dengan perintah di bawah ini.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

Kiat

Jika langganan Anda tidak memungkinkan Anda membuat sumber daya Foundry, Anda mungkin perlu mengaktifkan hak istimewa penyedia sumber daya Azure tersebut menggunakan portal Microsoft Azure, perintah PowerShell , atau perintah Azure CLI. Jika Anda bukan pemilik langganan, mintalah seseorang dengan peran Pemilik atau Admin untuk menyelesaikan pendaftaran untuk Anda atau meminta hak istimewa /register/action untuk diberikan ke akun Anda.

Mendapatkan penggunaan kuota saat ini untuk sumber daya Anda

Gunakan perintah Get-AzCognitiveServicesAccountUsage untuk mendapatkan penggunaan sumber daya Anda.

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource

Membersihkan sumber daya

Jika Anda ingin membersihkan dan menghapus sumber daya Foundry, Anda dapat menghapusnya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya lain yang terkandung dalam grup ini.

Untuk menghapus grup sumber daya dan sumber daya terkait, gunakan perintah Remove-AzResourceGroup .

Remove-AzResourceGroup -Name ai-services-resource-group

Mengakses sumber daya Anda

Dengan sumber daya pertama yang dibuat, Anda dapat mengaksesnya melalui portal Foundry untuk prototipe UX, Foundry SDK untuk pengembangan, atau melalui portal Microsoft Azure untuk manajemen administratif.

Memverifikasi pengaturan Anda

Anda dapat memverifikasi bahwa sumber daya Anda disiapkan dengan benar dengan menggunakan Azure AI Projects SDK untuk menyambungkan dan mencantumkan proyek. Contoh minimal ini mengonfirmasi autentikasi dan akses.

# Install the SDK: pip install azure-ai-projects azure-identity
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Replace with your actual values from Azure portal
client = AIProjectClient(
    subscription_id="<your-subscription-id>",
    resource_group_name="<your-resource-group>",
    project_name="<your-project-name>",
    credential=DefaultAzureCredential()
)

# List projects to verify connection
projects = client.projects.list()
print(f"Successfully connected. Found {len(list(projects))} projects.")

Output yang diharapkan: Successfully connected. Found X projects. di mana X adalah jumlah proyek di sumber daya Anda.

Referensi:

Memberikan atau mendapatkan izin pengembang

Azure Role Based Access Control (RBAC) membedakan izin antara tindakan manajemen dan pengembangan. Untuk membangun dengan Foundry, akun pengguna Anda harus diberi izin pengembang ("tindakan data"). Anda dapat menggunakan salah satu peran RBAC bawaan, atau menggunakan peran RBAC kustom.

Peran pengembang Azure RBAC bawaan untuk Foundry meliputi:

Role Deskripsi
Manajer Proyek Azure AI Memberikan izin pengembangan, dan izin manajemen proyek. Dapat mengundang pengguna lain untuk berkolaborasi pada proyek sebagai 'Pengguna Azure AI'.
Pengguna Azure AI Memberikan izin pengembangan.
Pemilik Akun Azure AI Memberikan akses penuh untuk mengelola proyek dan akun AI. Dapat mengundang pengguna lain untuk berkolaborasi pada proyek sebagai 'Pengguna Azure AI'.
Pemilik Azure AI Memberikan akses penuh ke proyek dan akun AI terkelola serta membangun dan mengembangkan dengan proyek.

Nota

Peran Pemilik AI di Azure akan segera tersedia untuk ditetapkan di portal Azure dan Foundry.

Diagram peran bawaan di Foundry.

Untuk perusahaan yang lebih besar dengan persyaratan akses berbasis peran yang ketat, kami merekomendasikan penggunaan peran Pengguna Azure AI dengan izin pengembang hak istimewa paling sedikit. Untuk perusahaan yang lebih kecil yang ingin pengembang mereka melayani mandiri dalam organisasi mereka, sebaiknya gunakan peran Pemilik Azure AI untuk izin pengembang serta izin pembuatan sumber daya.

Hanya pengguna yang berwenang, biasanya langganan Azure atau pemilik grup sumber daya, yang dapat menetapkan peran melalui [portal Microsoft Azure](tautan ke portal Microsoft Azure) atau [portal Foundry melalui Admin](Tautan ke portal Foundry). Pelajari selengkapnya tentang kontrol akses berbasis peran.

Penting

Peran Pemilik dan Kontributor Azure hanya menyertakan izin manajemen, dan bukan izin pengembangan. Izin pengembangan diperlukan untuk membangun dengan semua kemampuan di Foundry.

Mulai membangun di proyek pertama Anda

Dengan izin yang disiapkan, Anda sekarang siap untuk mulai membangun Foundry. Di portal Foundry , buka atau buat proyek pertama Anda. Proyek mengatur pekerjaan kustomisasi agen dan model Anda di Foundry, dan Anda dapat membuat beberapa di bawah sumber daya yang sama.

Jelajahi beberapa layanan yang dibundel dengan sumber daya Anda:

Layanan Deskripsi
Ikon Foundry Layanan Agen Foundry Gabungkan kekuatan model AI generatif dengan alat yang memungkinkan agen mengakses dan berinteraksi dengan sumber data dunia nyata.
Ikon Foundry Penerapan Model Azure Melakukan inferensi model untuk model unggulan dalam katalog model Foundry.
Azure OpenAI pada ikon Model Foundry Azure OpenAI Lakukan berbagai tugas bahasa alami.
Ikon Keamanan Konten Keamanan Konten Alat Foundry yang mendeteksi konten yang tidak diinginkan.
Ikon Kecerdasan Dokumen Kecerdasan Dokumen Ubah dokumen menjadi solusi berbasis data cerdas.
Ikon bahasa Bahasa Bangun aplikasi dengan kemampuan pemahaman bahasa alami terkemuka di industri.
Ikon Ucapan Pidato Ucapan ke teks, teks ke ucapan, terjemahan, dan pengenalan pembicara.
Ikon Penerjemah Penerjemah Gunakan teknologi terjemahan yang didukung AI untuk menerjemahkan lebih dari 100 bahasa dan dialek yang digunakan, berisiko, dan terancam punah.

Langkah selanjutnya

  • Last updated on