Azure Yapay Zeka Arama'te bir beceri kümesine faturalanabilir bir kaynak ekleyin.

Azure Yapay Zeka Arama'da AI zenginleştirme için yerleşik beceriler kullanıyorsanız, az sayıda belgeyi günde dizin başına en fazla 20 işlem olmak üzere ücretsiz olarak zenginleştirebilirsiniz. Daha büyük veya daha sık iş yükleri için skillset’inize ücretlendirilebilir bir Microsoft Foundry kaynağı eklemeniz gerekir.

Azure Yapay Zeka Arama, Foundry Araçları tarafından sağlanan yerleşik becerileri yürütmek için ayrılmış, şirket içinde barındırılan kaynakları kullanır ve yalnızca faturalama amacıyla bir Foundry kaynağı gerektirir. Bunun istisnası Azure Content Understanding becerisi olup hem faturalama hem de işleme için kaynağınızı kullanır.

Foundry Araçları içindeki bir dökümhane kaynağı, birden çok hizmete erişim sağlar. Beceri kümesinde belirttiğinizde Microsoft aşağıdaki hizmetleri kullandığınız için sizden ücret tahsil edebilirsiniz:

• Görüntü analizi, optik karakter tanıma (OCR) ve çok modüllü eklemeler için Azure Döküm Araçları'nda Görüntü İşleme.
• Azure Language Foundry Araçları dil algılama, varlık tanıma, duygu analizi ve anahtar ifade ayıklama için.
• Foundry Araçları'nda Azure Çevirmen makine metni çevirisi için.

Beceri kümesi işleme, her becerinin temel hizmetine faturalandırılır. Azure Yapay Zeka Arama Foundry Araçlarının ücretlerini tek bir Foundry kaynağında birleştirir. Örneğin, Image Analysis ve Language Detection becerileri kullanıyorsanız, Azure Görüntü İşleme ve Azure Dili ücretleri, Döküm kaynağınız için aynı faturada görünür. Diğer tüm kaynaklar bağımsız olarak faturalandırılır.

Bir Foundry kaynağı eklemek için beceri kümesinde bağlantı bilgilerini sağlayın. Anahtar tabanlı veya anahtarsız bir yaklaşım kullanabilirsiniz.

Önkoşullar

• Arama hizmetiniz bir Dökümhane kaynağına özel bağlantılar için oluşturma tarihi, katman ve bölge gereksinimlerini karşılıyorsa, aksi takdirde genel uç nokta üzerinden bağlantı kurulur.

• API türüne sahip bir AIServices. API türünü Azure portalındaki kaynağın Overview sayfasında doğrulayabilirsiniz:

  

Anahtarsız bağlantı üzerinden faturalandır

Dökümhane kaynağını bağlamak için yönetilen kimlik ve izinler kullanabilirsiniz. Bu yaklaşımın avantajı faturalamanın anahtarsız olması ve bölge gereksinimlerine sahip olmamasıdır.

Anahtarlarda olduğu gibi, kaynakla ilgili sağladığınız ayrıntılar bağlantılar için değil faturalama için kullanılır. Yerleşik becerilerin işlenmesi için Azure Yapay Zeka Arama tarafından Foundry Tools'a yapılan tüm API istekleri Microsoft tarafından iç sistemde kalır ve yönetilir.

Anahtarsız bağlantı üzerinden faturalandırmak için:

1. Azure Yapay Zeka Arama hizmetinizde yönetilen kimliği yapılandırın. Hem sistem tarafından atanan hem de kullanıcı tarafından atanan kimlikler desteklenir.

2. Arama hizmetinizin yönetilen kimliğine Bilişsel Hizmetler Kullanıcı rolünü Dökümhane kaynağınızda atayın.

3. Yönetilen kimliği kullanmak için bir beceri kümesi yapılandırın. Azure portalını, Skillsets - Create Or Update (REST API) en son kararlı sürümünü veya söz dizimini sağlayan bir Azure SDK paketini kullanabilirsiniz.

   • @odata.type her zaman #Microsoft.Azure.Search.AIServicesByIdentity.

   • subdomainUrl , Foundry kaynağınızın uç noktasıdır. Azure portalındaki https://<resource-name>.services.ai.azure.com sayfasında bulunan https://<resource-name>.cognitiveservices.azure.com veya biçimini kullanabilirsiniz.

   • Diğer özellikler, aşağıdaki REST API örneklerinde gösterildiği gibi yönetilen kimliğin türüne özeldir.

   • Sistem tarafından atanan yönetilen kimlik
   • Kullanıcı tarafından atanan yönetilen kimlik

   Sistem tarafından atanan yönetilen kimlik için örnek beceri kümesi yapılandırması aşağıda verilmiştır. Bu senaryoda identity öğesini null olarak ayarlamanız gerekir.

   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
     }
   }
   

Kaynak anahtarı ile faturalandırma

Default olarak, Azure Yapay Zeka Arama, Foundry kaynağının anahtarını kullanarak işlemler için ücret alır. Bu yaklaşım genel olarak kullanılabilir. Anahtarı beceri kümesine eklemek için Azure portalını, kararlı bir REST API sürümünü veya eşdeğer bir Azure SDK kullanabilirsiniz.

Desteklenen iki anahtar türü vardır:

• #Microsoft.Azure.Search.CognitiveServicesByKey bölgesel uç noktayı çağırır.
• #Microsoft.Azure.Search.AIServicesByKey alt alan adını çağırır. Paylaşılan özel bağlantıları desteklediğinden ve arama hizmetine göre bölgesel gereksinimleri olmadığından bu tür önerilir.

Dökümhane kaynağınız arama hizmetinizle aynı bölgede olmalıdır. AI zenginleştirme sütunuyla belirtilen Döküm Araçları tümleştirmesi sunan bir Azure Yapay Zeka Arama bölgesi seçin. Aynı bölge gereksinimi hakkında daha fazla bilgi için bkz. Anahtarın nasıl kullanıldığı.

Özelliğini belirtmezseniz cognitiveServices , arama hizmetiniz her gün dizin oluşturucunuzun kullanabileceği ücretsiz zenginleştirmeleri kullanmayı dener. Faturalanabilir becerilerin yürütülmesi, dizin oluşturucu çağrısı başına 20 işlemde durur ve dizin oluşturucu yürütme geçmişinde bir "Time Out" iletisi görüntülenir.

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}"
    }
}

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);

Anahtarı kaldırma

Zenginleştirmeler faturalanabilir işlemlerdir. Artık DökümHane Araçları'nı çağırmanız gerekmiyorsa, anahtarı kaldırmak ve Dökümhane kaynağının kullanımını önlemek için bu yönergeleri izleyin.

Anahtar olmadan, beceri kümesi endeksleyici başına günde 20 ücretsiz işlem için varsayılan tahsise geri döner. Faturalanabilir becerilerin yürütülmesi 20 işlemde durur ve ayırma kullanıldığında indeksleyici yürütme geçmişinde bir "Zaman Aşımı" iletisi görüntülenir.

Anahtar nasıl kullanılır?

Bir Foundry kaynağına yapılan API çağrıları, her bir dizin oluşturucu başına günde 20 API çağrısını aştığında faturalama başlar. API sayısını sıfırlamak için dizin oluşturucuyu sıfırlayabilirsiniz.

Anahtarsız ve anahtar tabanlı bağlantılar faturalama için kullanılır, ancak zenginleştirme işlemleriyle ilgili bağlantılar için kullanılmaz.

Anahtar tabanlı bağlantılar için, arama hizmeti iç ağ üzerindenaynı fiziksel bölgede bulunan bir Dökümhane kaynağına bağlanır. Azure Yapay Zeka Arama sunan bölgelerin çoğu başka Azure hizmetleri de sunar. Her iki hizmetin de olmadığı bir bölgede yapay zeka zenginleştirmeyi denerseniz şu iletiyi görürsünüz: "Sağlanan anahtar arama hizmetinizin bölgesi için geçerli bir Bilişsel Hizmetler türü anahtarı değil."

Anahtarsız bağlantılar için, arama hizmeti kimliğini ve rol atamasını kullanarak kimlik doğrulaması yapar ve bir Dökümhane kaynağını hedefler. Kaynak, tam nitelikli URI olarak belirtilir ve URI benzersiz bir alt etki alanı içerir.

Dizin oluşturucular, yalnızca kendi arama hizmetinizin arama düğümleri kullanılarak ayrılmış işleme için özel bir yürütme ortamında çalışacak şekilde yapılandırılabilir. Özel bir yürütme ortamı kullanıyor olsanız bile, Azure Yapay Zeka Arama tüm beceri zenginleştirmelerini gerçekleştirmek için şirket içinde sağlanan kaynaklarını kullanmaya devam eder.

Genel bağlantı gereksinimleri

Arama hizmetinizin ne zaman oluşturulduğuna, fiyatlandırma katmanına ve bölgesine bağlı olarak, yerleşik yetenekler için faturalama, Azure Yapay Zeka Arama'ten Foundry kaynağınıza genel bağlantı gerektirebilir. Genel ağ erişiminin devre dışı bırakılması bazı senaryolarda faturalamayı bozar. Arama hizmetinizin genel bağlantı gerekip gerekmediğini belirlemek için paylaşılan özel bağlantı üzerinden bağlantı gereksinimlerini gözden geçirin.

Ortak ağı kullanamıyorsanız, özel uç noktalarını destekleyen bir Azure İşlevi ile uygulanmış bir Özel Web API'si becerisi yapılandırabilir ve Foundry kaynağınızı aynı sanal ağa ekleyebilirsiniz. Bu senaryoda, Foundry kaynağınızı özel uç noktaları aracılığıyla doğrudan özel yetenekten çağırabilirsiniz.

Önemli gereksinimler özel durumlar

Özel Varlık Arama Azure Yapay Zeka Arama tarafından ölçülür, ancak her dizin oluşturucu için günde 20'yi aşan işlemlerin kilidini açmak için bir Foundry kaynak anahtarı gerektirir. Yalnızca bu beceri için kaynak anahtarı işlem sayısının engelini kaldırır ancak faturalamayla ilgisizdir.

Ücretsiz zenginleştirmeler

Yapay zeka zenginleştirmesi, dış kaynak eklemek zorunda kalmadan kısa alıştırmaları tamamlayabilmeniz için faturalanabilir zenginleştirmelerin az miktarda ücretsiz işlenmesini sağlar. Ücretsiz zenginleştirmeler, dizin oluşturucu başına günde 20 belgedir. Bir alıştırmayı yinelemek istiyorsanız, sayacı sıfırlamak için dizin oluşturucuyu sıfırlayabilirsiniz.

Bazı zenginleştirmeler her zaman ücretsizdir:

• DökümHane Araçları 'nı ( Koşullu, Belge Ayıklama, Şekillendirici, Metin Birleştirme ve Metin Bölme becerileri) çağırmayen yardımcı program becerileri faturalandırılamaz.

• PDF belgelerinden ve diğer uygulama dosyalarından metin ayıklama işlemi yapılamaz. Belgenin kırılması sırasında oluşan metin ayıklama bir yapay zeka zenginleştirmesi değildir, ancak yapay zeka zenginleştirmesi sırasında gerçekleşir ve bu nedenle burada not edilir.

Faturalanabilir zenginleştirmeler

Yapay zeka zenginleştirmesi sırasında, Azure Yapay Zeka Arama, Azure Görüntü İşleme, Azure Dil ve Azure Translator'a dayalı yerleşik beceriler için API'leri çağırır.

Dış hizmetlere arka uç çağrıları yapmak için faturalanabilir yerleşik beceriler şunlardır:

• Varlık Bağlama
• Varlık Tanıma
• Görüntü Analizi
• Anahtar Kelime Çıkarma
• Dil Algılama
• OCR
• Kişisel Bilgiler (PII) Algılama
• Duyguları
• Metin çevirisi
• Azure Vision çok modüllü eklemeler (önizleme)

Azure Vision çok modlu gömme modeli tarafından desteklenen query-time vektörleştiricisi de faturalanabilir bir zenginleştirmedir.

Görüntü ayıklama, zenginleştirmeden önce belgeler kırıldığında oluşan bir Azure Yapay Zeka Arama işlemidir. Görüntü ayıklama, ücretsiz katmanda günlük 20 ücretsiz ayıklama dışında tüm fiyatlandırma katmanlarında faturalandırılabilir. Görüntü ayıklama maliyetleri blobların içindeki görüntü dosyalarına, diğer dosyalara eklenmiş görüntülere (PDF ve diğer uygulama dosyaları) ve Belge Ayıklama kullanılarak ayıklanan görüntülere uygulanır. Görüntü ayıklama fiyatlandırması için Azure Yapay Zeka Arama fiyatlandırma sayfasına bakın.

Örnek: Tahmin maliyetleri

Bu bölümde gösterilen fiyatlar varsayımsaldır ve tahmin sürecini göstermek için kullanılır. Maliyetleriniz daha düşük olabilir. İşlemlerin gerçek fiyatı için Foundry Tools fiyatlandırması bölümüne bakın.

Azure Yapay Zeka Arama dizin oluşturmayla ilişkili maliyetleri tahmin etmek için, bazı sayıları çalıştırabilmek için ortalama bir belgenin nasıl göründüğüne ilişkin bir fikirle başlayın. Örneğin, yaklaşık olarak:

• 1.000 PDF
• Her biri altı sayfa
• Sayfa başına bir resim (6.000 resim)
• Sayfa başına 3.000 karakter

Her bir PDF'nin belge yapısının çözümlenmesi, görüntü ve metin ayıklama, görüntülerin OCR ile işlenmesi ve kuruluşların tanınmasını içeren bir işlem hattı varsayın.

1. Metin ve görüntü içeriğiyle belgenin kırılması için, metin ayıklama şu anda ücretsizdir. 6.000 resim için, ayıklanan her 1.000 görüntü için 1 ABD doları olduğunu varsayalım. Bu adım için 6,00 ABD doları tutarında bir maliyettir.

2. İngilizce 6.000 görüntünün OCR'sinde, OCR bilişsel becerisi en iyi algoritmayı (DescribeText) kullanır. Analiz edilecek 1.000 görüntü başına 2,50 ABD doları maliyeti varsayarsak, bu adım için 15,00 ABD doları ödersiniz.

3. Varlık ayıklama için sayfa başına toplam üç metin kaydınız olur. Her kayıt 1.000 karakterdir. Sayfa başına üç metin kaydı, 6.000 sayfayla çarpılarak 18.000 metin kaydına eşittir. 1.000 metin kaydı başına 2,00 ABD doları olduğu varsayıldığında, bu adım 36,00 TL'ye mal olur.

Hepsini bir araya getirerek, açıklanan beceri kümesiyle bu türdeki 1.000 PDF belgesini almak için yaklaşık 57,00 ABD doları ödersiniz.

İlgili içerik

• Azure Yapay Zeka Arama fiyatlandırma sayfası
• Bir beceri seti nasıl tanımlanır?
• Beceri Kümesi Oluşturma (REST)
• Zenginleştirilmiş alanları eşleme