Melampirkan sumber daya yang dapat ditagih ke set keterampilan di Pencarian Azure AI

Catatan

Pencarian Azure AI tersedia melalui portal Azure, REST API, dan Azure SDK. Ini juga mendukung Foundry IQ, lapisan pengetahuan terkelola yang mengubah konten perusahaan menjadi pangkalan pengetahuan yang dapat digunakan kembali dan sadar izin untuk agen di portal Microsoft Foundry.

Jika Anda menggunakan keterampilan bawaan untuk pengayaan AI di Pencarian Azure AI, Anda dapat memperkaya sejumlah kecil dokumen secara gratis, hingga 20 transaksi per indeks per hari. Untuk beban kerja yang lebih besar atau lebih sering, Anda harus menghubungkan sumber daya Microsoft Foundry yang dapat dikenakan biaya ke skillset.

Pencarian Azure AI menggunakan sumber daya khusus yang dihosting secara internal untuk menjalankan keterampilan bawaan yang didukung oleh Foundry Tools dan memerlukan sumber daya Foundry hanya untuk tujuan penagihan. Pengecualiannya adalah keterampilan Azure Content Understanding, yang menggunakan sumber daya Anda untuk penagihan dan pemrosesan.

Sumber daya Foundry menyediakan akses ke beberapa layanan dalam Foundry Tools. Saat Anda menentukannya dalam set keterampilan, Microsoft dapat menagih Anda untuk menggunakan layanan berikut:

Azure Vision di Foundry Tools untuk analisis gambar, pengenalan karakter optik (OCR), dan integrasi multimodal.
Azure Language in Foundry Tools untuk deteksi bahasa, pengenalan entitas, analisis sentimen, dan ekstraksi frasa kunci.
Azure Translator di Foundry Tools untuk terjemahan teks mesin.

Pemrosesan skillset dikenakan biaya pada layanan dasar dari setiap skill. Pencarian Azure AI mengonsolidasikan biaya untuk Foundry Tools ke dalam satu sumber daya Foundry. Misalnya, jika Anda menggunakan keterampilan Image Analysis dan Deteksi Bahasa, biaya untuk Azure Vision dan Azure Language muncul pada tagihan yang sama untuk sumber daya Foundry Anda. Semua sumber daya lainnya ditagih secara independen.

Untuk melampirkan sumber daya Foundry, berikan informasi koneksi di konfigurasi keterampilan. Anda dapat menggunakan pendekatan berbasis kunci atau tanpa kunci.

Prasyarat

Konektivitas melalui titik akhir publik, kecuali jika layanan pencarian Anda memenuhi persyaratan tanggal pembuatan, tingkat, dan wilayah untuk koneksi privat ke sumber daya Foundry.
Sumber daya di Foundry dengan tipe API. Anda dapat memverifikasi jenis API di halaman Overview sumber daya di portal Azure:

Catatan

Jika sumber daya Foundry Anda dikonfigurasi untuk menggunakan titik akhir privat, Pencarian Azure AI dapat terhubung menggunakan tautan privat bersama. Untuk informasi selengkapnya, lihat Batas sumber daya tautan privat bersama. Atau, tempatkan layanan pencarian dan sumber daya Foundry di perimeter keamanan jaringan yang sama untuk menyimpan panggilan keluar ke sumber daya Foundry di saluran privat.
Dimulai dengan 2025-11-01-preview, kumpulan keterampilan mendukung AIServices jenis API. Akun multi-layanan Azure AI klasik CognitiveServices terus berfungsi, tetapi untuk keterampilan baru, kami sarankan Anda menggunakan sumber daya AIServices dan Foundry.

Penagihan melalui koneksi tanpa kunci

Anda dapat menggunakan identitas dan izin terkelola untuk melampirkan sumber daya Foundry. Keuntungan dari pendekatan ini adalah penagihan tanpa kunci dan tidak memiliki persyaratan wilayah.

Seperti halnya kunci, detail yang Anda berikan tentang sumber daya digunakan untuk penagihan, bukan koneksi. Semua permintaan API yang dibuat oleh Pencarian Azure AI ke Foundry Tools untuk pemrosesan keterampilan bawaan tetap internal dan dikelola oleh Microsoft.

Untuk menagih melalui koneksi tanpa kunci:

Pada layanan Pencarian Azure AI Anda, mengonfigurasi identitas terkelola. Identitas yang ditetapkan sistem dan yang ditetapkan pengguna didukung.
Pada sumber daya Foundry Anda, tetapkan peran Pengguna Cognitive Services ke identitas terkelola layanan pencarian Anda.

Konfigurasikan set keterampilan untuk menggunakan identitas terkelola. Anda dapat menggunakan portal Azure, versi stabil terbaru Skillsets - Create Or Update (REST API), atau paket Azure SDK yang menyediakan sintaks.

@odata.type selalu #Microsoft.Azure.Search.AIServicesByIdentity.
subdomainUrl adalah titik akhir sumber daya Foundry Anda. Anda dapat menggunakan format https://<resource-name>.services.ai.azure.com atau https://<resource-name>.cognitiveservices.azure.com, yang keduanya tersedia di halaman Keys dan Titik Akhir di portal Azure.
Properti lain khusus untuk jenis identitas terkelola, seperti yang ditunjukkan dalam contoh REST API berikut.

Identitas terkelola yang ditetapkan sistem
Identitas terkelola yang ditetapkan pengguna

Berikut adalah contoh konfigurasi set keterampilan untuk identitas terkelola yang ditetapkan sistem. Dalam skenario ini, Anda harus mengatur identity ke null.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json

{
  "name": "my-skillset",
  "skills": [
    // Skills definition goes here
  ],
  "cognitiveServices": {
    "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",
    "description": "A sample configuration for a system-assigned managed identity.",
    "subdomainUrl": "https://[resource-name].services.ai.azure.com",
    "identity": null
  }
}

Berikut adalah contoh konfigurasi set keterampilan untuk identitas terkelola yang ditetapkan pengguna. Dalam skenario ini, Anda harus mengatur identity ke ID sumber daya identitas terkelola yang ditetapkan pengguna. Untuk menemukan identitas terkelola yang ditetapkan pengguna yang sudah ada, lihat Mengelola identitas terkelola yang ditetapkan pengguna.

Anda juga harus mengatur properti identity.@odata.type dan identity.userAssignedIdentity.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json

{ 
    "name": "my-skillset", 
    "skills":  
    [ 
      // Skills definition goes here
    ], 
    "cognitiveServices": { 
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity", 
        "description": "A sample configuration for a user-assigned managed identity.", 
        "subdomainUrl": "https://[resource-name].services.ai.azure.com",
        "identity": {   
            "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",   
            "userAssignedIdentity": "/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-assigned-managed-identity-name}" 
        }
    } 
}

Menagih melalui kunci sumber daya

Secara bawaan, Pencarian Azure AI mengenakan biaya untuk transaksi menggunakan kunci dari sumber daya Foundry. Pendekatan ini umumnya tersedia. Anda dapat menggunakan portal Azure, versi REST API yang stabil, atau Azure SDK yang setara untuk menambahkan kunci ke set keterampilan.

Ada dua jenis kunci yang didukung:

#Microsoft.Azure.Search.CognitiveServicesByKey memanggil titik akhir regional.
#Microsoft.Azure.Search.AIServicesByKey memanggil subdomain. Kami merekomendasikan jenis ini karena mendukung tautan privat bersama dan tidak memiliki persyaratan regional relatif terhadap layanan pencarian.

Sumber daya Foundry Anda harus berada di wilayah yang sama dengan layanan pencarian Anda. Pilih wilayah Pencarian Azure AI yang menyediakan integrasi Foundry Tools, yang ditunjukkan oleh kolom pengayaan AI. Untuk informasi selengkapnya tentang persyaratan wilayah yang sama, lihat Bagaimana kunci digunakan.

Jika Anda tidak menentukan properti cognitiveServices, layanan pencarian Anda mencoba menggunakan pengayaan gratis yang tersedia untuk pengindeksir Anda setiap hari. Eksekusi keterampilan yang dapat ditagih berhenti pada 20 transaksi per panggilan pengindeks, dan pesan "Waktu Habis" akan muncul di riwayat eksekusi pengindeks.

Masuk ke portal Azure.
Buat sumber daya Foundry di wilayah yang sama dengan layanan pencarian Anda.
Dari panel kiri, pilih Kunci Manajemen> Sumber Dayadan Titik Akhir.
Salin salah satu kunci.
Tambahkan kunci ke definisi kumpulan keterampilan.
- Jika Anda menggunakan wizard Impor data, pilih sumber daya Foundry. Wizard menambahkan kunci sumber daya ke definisi set keterampilan Anda.
- Untuk set keterampilan baru atau yang sudah ada, berikan kunci dalam definisi set keterampilan.

Catatan

Portal secara otomatis melampirkan kunci jenis #Microsoft.Azure.Search.CognitiveServicesByKey.

Gunakan Skillsets - Create Or Update (REST API), spesifikasikan cognitiveServices bagian pada isi permintaan.

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json
{
    "name": "my-skillset",
    "skills": 
    [
      // Skills definition goes here
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByKey",
        "description": "A sample configuration for key-based billing.",
        "subdomainUrl": "https://[resource-name].services.ai.azure.com",
        "key": "{your-billable-resource-key}"
    }
}

Cuplikan kode berikut dari azure-search-dotnet-samples telah dipangkas untuk kejelasan.

IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json");
IConfigurationRoot configuration = builder.Build();

string searchServiceUri = configuration["SearchServiceUri"];
string adminApiKey = configuration["SearchServiceAdminApiKey"];
string cognitiveServicesKey = configuration["CognitiveServicesKey"];

SearchIndexerClient indexerClient = new SearchIndexerClient(new Uri(searchServiceUri), new AzureKeyCredential(adminApiKey));

// Create the skills
Console.WriteLine("Creating the skills...");
OcrSkill ocrSkill = CreateOcrSkill();
MergeSkill mergeSkill = CreateMergeSkill();

// Create the skillset
Console.WriteLine("Creating or updating the skillset...");
List<SearchIndexerSkill> skills = new List<SearchIndexerSkill>();
skills.Add(ocrSkill);
skills.Add(mergeSkill);

SearchIndexerSkillset skillset = CreateOrUpdateDemoSkillSet(indexerClient, skills, cognitiveServicesKey);

Menghapus kunci

Operasi pengayaan adalah operasi yang dapat ditagih. Jika Anda tidak perlu lagi memanggil Foundry Tools, ikuti instruksi berikut untuk menghapus kunci dan mencegah penggunaan sumber daya Foundry.

Tanpa kunci, kumpulan keterampilan akan kembali ke alokasi default yaitu 20 transaksi gratis per indexer per hari. Eksekusi keterampilan yang dapat ditagih berhenti pada 20 transaksi, dan pesan "Waktu Habis" muncul dalam riwayat eksekusi pengindeks saat alokasi digunakan.

portal Azure
SISANYA

Buka layanan pencarian Anda di portal Azure.
Di bawah >, pilih skillset dari daftar.
Gulir ke bagian "cognitiveServices" dalam file.
Hapus nilai kunci dari JSON.
Simpan kompetensi.

Gunakan Skillsets - Get (REST API) untuk mengambil definisi JSON dari set keterampilan.
Gunakan Skillsets - Create Or Update (REST API) untuk merumuskan permintaan pembaruan dengan definisi JSON.
Hapus kunci dari isi definisi JSON.

Kirim permintaan.

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json

{
    "name": "my-skillset",
    "skills": 
    [
      // Skills definition goes here
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
        "description": "An example of removing the key.",
        "key": ""
    }
}

Atau, Anda dapat mengatur cognitiveServices ke null:

"cognitiveServices": null,

Cara kunci digunakan

Penagihan berlaku saat panggilan API ke sumber daya Foundry melebihi 20 panggilan API per pengindeks per hari. Anda dapat mengatur ulang pengindeks untuk mengatur ulang jumlah API.

Koneksi tanpa kunci dan berbasis kunci digunakan untuk penagihan, tetapi tidak untuk koneksi yang terkait dengan operasi pengayaan.

Untuk koneksi berbasis kunci, layanan pencarian terhubung melalui jaringan internal ke sumber daya Foundry yang terletak di wilayah fisik yang sama. Sebagian besar wilayah yang menawarkan Pencarian Azure AI juga menawarkan layanan Azure lainnya. Jika Anda mencoba pengayaan AI di wilayah yang tidak memiliki kedua layanan, Anda akan melihat pesan ini: "Kunci yang disediakan bukan kunci jenis CognitiveServices yang valid untuk wilayah layanan pencarian Anda."

Untuk koneksi tanpa kunci, layanan pencarian mengautentikasi dengan menggunakan identitas dan penetapan perannya, serta menargetkan sumber daya Foundry secara spesifik. Sumber daya ditentukan sebagai URI yang sepenuhnya memenuhi syarat, dan URI menyertakan subdomain unik.

Pengindeks dapat dikonfigurasi untuk berjalan di lingkungan eksekusi privat untuk pemrosesan khusus hanya menggunakan simpul pencarian layanan pencarian Anda sendiri. Bahkan jika Anda menggunakan lingkungan eksekusi privat, Pencarian Azure AI masih menggunakan sumber daya yang disediakan secara internal untuk melakukan semua pengayaan keterampilan.

Catatan

Beberapa keterampilan bawaan, seperti keterampilan Terjemahan Teks, didasarkan pada layanan Foundry Tools non-regional. Jika Anda menggunakan keterampilan non-regional, permintaan Anda mungkin dilayankan di wilayah yang berbeda dari wilayah Pencarian Azure AI. Untuk informasi selengkapnya tentang layanan non-regional, lihat halaman ketersediaan produk menurut wilayah .

Persyaratan koneksi publik

Bergantung pada kapan layanan pencarian Anda dibuat, tingkat harganya, dan wilayahnya, penagihan untuk keterampilan built-in dapat memerlukan koneksi publik dari Pencarian Azure AI ke sumber daya Foundry Anda. Menonaktifkan akses jaringan publik akan mengganggu penagihan dalam beberapa skenario. Tinjau persyaratan untuk koneksi melalui tautan privat bersama untuk menentukan apakah layanan pencarian Anda memerlukan koneksi publik.

Jika Anda tidak dapat menggunakan jaringan publik, Anda dapat mengonfigurasi Custom Web API skill yang diimplementasikan dengan Azure Function yang mendukung titik akhir privat dan menambahkan sumber daya Foundry Anda ke VNET yang sama. Dalam skenario ini, Anda dapat memanggil sumber daya Foundry langsung dari keterampilan kustom menggunakan titik akhir privat.

Persyaratan utama kasus khusus

Pencarian Entitas Kustom diukur oleh Pencarian Azure AI, tetapi memerlukan kunci sumber daya Foundry untuk memungkinkan lebih dari 20 transaksi per pengindeks per hari. Untuk keterampilan ini saja, kunci sumber daya membuka blokir jumlah transaksi tetapi tidak terkait dengan penagihan.

Pengayaan gratis

Pengayaan AI menawarkan sejumlah kecil pemrosesan gratis pengayaan yang dapat ditagih sehingga Anda dapat menyelesaikan latihan singkat tanpa harus melampirkan sumber daya eksternal. Pengayaan gratis adalah 20 dokumen per pengindeks setiap hari. Anda dapat mengatur ulang pengindeks untuk mengatur ulang penghitung jika Anda ingin mengulangi latihan.

Beberapa fitur tambahan selalu gratis.

Keterampilan utilitas yang tidak memanggil Foundry Tools (yaitu keterampilan Kondisional, Ekstraksi Dokumen, Pembentuk, Penggabungan Teks, dan Pemisahan Teks ) tidak dapat ditagih.
Ekstraksi teks dari dokumen PDF dan file lainnya tidak dikenakan biaya. Ekstraksi teks, yang terjadi selama pemecahan dokumen, bukan pengayaan AI, tetapi terjadi selama pengayaan AI dan dengan demikian dicatat di sini.

Pengayaan yang dapat ditagih

Selama pengayaan AI, Pencarian Azure AI memanggil API untuk keterampilan tertanam yang didasarkan pada Azure Vision, Azure Language, dan Azure Translator.

Keterampilan bawaan yang dikenakan biaya yang melakukan panggilan back-end ke layanan eksternal meliputi:

Penautan Entitas
Pengenalan Entitas
Analisis Gambar
Ekstraksi Frasa Kunci
Deteksi Bahasa
OCR
Deteksi Informasi Pengidentifikasi Pribadi (PII)
Sentimen
Terjemahan Teks
penyematan multimodal Azure Vision

Pengvektor query-time yang didukung oleh model penanaman multimodal Azure Vision juga merupakan pengayaan yang dapat ditagih.

Ekstraksi gambar adalah operasi Pencarian Azure AI yang terjadi ketika dokumen dipecahkan sebelum proses pengayaan. Semua tingkat harga untuk ekstraksi gambar dapat dikenakan biaya, kecuali untuk 20 ekstraksi harian gratis pada tingkat gratis. Biaya ekstraksi gambar berlaku untuk file gambar di dalam blob, gambar yang disematkan di file lain (PDF dan file aplikasi lainnya), dan gambar yang diekstrak menggunakan Ekstraksi Dokumen. Untuk harga ekstraksi gambar, lihat halaman harga Pencarian Azure AI.

Tips

Untuk menurunkan biaya pemrosesan set keterampilan, aktifkan pengayaan inkremental untuk cache dan gunakan kembali pengayaan apa pun yang tidak terpengaruh oleh perubahan yang dilakukan pada set keterampilan. Penembolokan memerlukan Azure Storage (lihat pricing), tetapi biaya kumulatif eksekusi skillset lebih rendah jika pengayaan yang ada dapat digunakan kembali, terutama untuk skillset yang menggunakan ekstraksi dan analisis gambar.

Contoh: Memperkirakan biaya

Harga yang ditunjukkan di bagian ini bersifat hipotetis dan digunakan untuk menggambarkan proses estimasi. Biaya Anda bisa lebih rendah. Untuk harga transaksi aktual, lihat Harga Foundry Tools.

Untuk memperkirakan biaya yang terkait dengan pengindeksan Pencarian Azure AI, mulailah dengan gambaran umum dokumen rata-rata agar Anda dapat melakukan perhitungan. Misalnya, Anda mungkin memperkirakan:

1.000 PDF
Masing-masing enam halaman
Satu gambar per halaman (6.000 gambar)
3.000 karakter per halaman

Asumsikan alur yang terdiri dari pemecahan dokumen dari setiap PDF, ekstraksi gambar dan teks, OCR gambar, dan pengenalan entitas organisasi.

Untuk pemecahan dokumen dengan konten teks dan gambar, ekstraksi teks saat ini gratis. Untuk 6.000 gambar, asumsikan $1 untuk setiap 1.000 gambar yang diekstrak. Itu adalah biaya $ 6,00 untuk langkah ini.
Untuk OCR dari 6.000 gambar dalam bahasa Inggris, keterampilan kognitif OCR menggunakan algoritma terbaik (DescribeText). Dengan asumsi biaya $2,50 per 1.000 gambar yang akan dianalisis, Anda akan membayar $15,00 untuk langkah ini.
Untuk ekstraksi entitas, Anda akan memiliki total tiga rekaman teks per halaman. Setiap rekaman adalah 1.000 karakter. Tiga rekaman teks per halaman dikalikan dengan 6.000 halaman sama dengan 18.000 rekaman teks. Dengan asumsi $2,00 per 1.000 catatan teks, langkah ini akan dikenakan biaya $36,00.

Menggabungkan semuanya, Anda akan membayar sekitar $57.00 untuk memproses 1.000 dokumen PDF jenis ini dengan keahlian yang telah dijelaskan.

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-05-12

Melampirkan sumber daya yang dapat ditagih ke set keterampilan di Pencarian Azure AI

Prasyarat

Penagihan melalui koneksi tanpa kunci

Menagih melalui kunci sumber daya

Menghapus kunci

Cara kunci digunakan

Persyaratan koneksi publik

Persyaratan utama kasus khusus

Pengayaan gratis

Pengayaan yang dapat ditagih

Contoh: Memperkirakan biaya

Konten terkait

Saran dan Komentar

Sumber Daya Tambahan: