Azure AI Search'te bir beceri kümesine Azure AI çoklu hizmet kaynağı ekleme

Azure AI Search'te isteğe bağlı bir yapay zeka zenginleştirme işlem hattı yapılandırırken sınırlı sayıda belgeyi ücretsiz olarak zenginleştirebilirsiniz. Daha büyük ve daha sık iş yükleri için faturalanabilir bir Azure AI çoklu hizmet kaynağı eklemeniz gerekir.

Çok hizmetli bir kaynak, tek bir API anahtarı üzerinden erişim izni verilen tek tek hizmetler yerine bir dizi Azure AI hizmetine teklif olarak başvurur. Bu anahtar bir beceri kümesinde belirtilir ve Microsoft'un bu hizmetleri kullandığınız için sizden ücret ödemesine izin verir:

• Görüntü analizi ve optik karakter tanıma (OCR) için Azure AI Vision
• Dil algılama, varlık tanıma, yaklaşım analizi ve anahtar ifade ayıklama için Azure AI Dili
• Konuşmayı metne dönüştürme ve metin okuma için Azure AI Konuşma
• Makine metin çevirisi için Azure AI Translator

İpucu

Azure, faturalandırmayı ve bütçeleri izlemeniz için altyapı sağlar. Azure yapay zeka hizmetlerini izleme hakkında daha fazla bilgi için bkz . Azure yapay zeka hizmetleri için maliyetleri planlama ve yönetme.

Kaynak anahtarını ayarlama

Beceri kümesine faturalanabilir bir kaynak eklemek için Azure portalını, REST API'yi veya Azure SDK'sını kullanabilirsiniz.

Özelliği belirsiz bırakırsanız, arama hizmetiniz günlük olarak 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 "Zaman Aşımı" iletisi görüntülenir.

Azure portalı

1. Azure Portal’ında oturum açın.

2. Arama hizmetinizle aynı bölgede bir Azure AI çoklu hizmet kaynağı oluşturun.

3. Anahtarı beceri kümesi tanımına ekleyin:

   • Verileri içeri aktarma sihirbazını kullanıyorsanız ikinci adım olan "Yapay zeka zenginleştirmeleri ekleme" anahtarını girin.

   • Anahtarı yeni veya mevcut bir beceri kümesine ekliyorsanız, anahtarı Azure AI hizmetleri sekmesinde sağlayın.

   

REST

1. Arama hizmetinizle aynı bölgede bir Azure AI çoklu hizmet kaynağı oluşturun.

2. Beceri kümesi isteği gövdesinde bölüm belirterek cognitiveServices beceri kümesi oluşturun veya güncelleştirin:

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2023-11-01
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
        "categories": [ "Organization" ],
        "defaultLanguageCode": "en",
        "inputs": [
          {
            "name": "text", "source": "/document/content"
          }
        ],
        "outputs": [
          {
            "name": "organizations", "targetName": "organizations"
          }
        ]
      }
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
        "description": "mycogsvcs",
        "key": "<your key goes here>"
    }
}

.NET SDK

Aşağıdaki kod parçacığı azure-search-dotnet-samples şeklindedir ve kısa kullanım için kırpılmıştır.

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 Azure AI hizmetlerini çağırmanız gerekmiyorsa, çok bölgeli anahtarı kaldırmak ve dış kaynağın kullanımını önlemek için bu yönergeleri izleyin. Anahtar olmadan beceri kümesi, dizin oluşturucu başına günde 20 ücretsiz işlemin varsayılan ayırmasına geri döner. Faturalanabilir becerilerin yürütülmesi 20 işlemde durur ve ayırma kullanıldığında dizin oluşturucu yürütme geçmişinde bir "Zaman Aşımı" iletisi görüntülenir.

Azure portalı

1. Azure portalında oturum açın ve arama hizmetine Genel Bakış sayfasını açın.

2. Beceri Kümeleri'nin altında, kaldırmak istediğiniz anahtarı içeren beceri kümesini seçin.

   

3. Dosyanın sonuna kaydırın.

4. Anahtarı JSON'dan kaldırın ve beceri kümesini kaydedin.

   

REST

1. Tam tanımı elde edebilmeniz için Skillset'i edinin.

2. Beceri kümesinin JSON tanımını sağlayarak bir Güncelleştirme Beceri Kümesi isteği formüle edin.

3. Tanımın gövdesindeki anahtarı kaldırın ve isteği gönderin:

   PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2023-11-01
   api-key: [admin key]
   Content-Type: application/json
   {
       "name": "skillset name",
       "skills": 
       [
         {
           "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
           "categories": [ "Organization" ],
           "defaultLanguageCode": "en",
           "inputs": [
             {
               "name": "text", "source": "/document/content"
             }
           ],
           "outputs": [
             {
               "name": "organizations", "targetName": "organizations"
             }
           ]
         }
       ],
       "cognitiveServices": {
           "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
           "description": "mycogsvcs",
           "key": ""
       }
   }
   

   Alternatif olarak, "cognitiveServices" öğesini null olarak ayarlayabilirsiniz:

   "cognitiveServices": null,
   

Anahtar nasıl kullanılır?

Anahtar tabanlı faturalama, Azure AI hizmetleri kaynaklarına yapılan API çağrıları dizin oluşturucu başına günde 20 API çağrısını aştığında geçerlidir.

Anahtar faturalama için kullanılır, ancak zenginleştirme işlemlerinin bağlantıları için kullanılmaz. Bağlantılar için, arama hizmeti iç ağ üzerinden aynı fiziksel bölgede bulunan bir Azure AI hizmetleri kaynağına bağlanır. Azure AI Search'e sahip bölgelerin çoğu Dil gibi diğer Azure yapay zeka hizmetlerini 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 CognitiveServices tür anahtarı değil."

Şu anda yerleşik becerilerin faturalaması için Azure AI Search'ten başka bir Azure AI hizmetine genel bağlantı gerekir. Genel ağ erişiminin devre dışı bırakılması faturalamayı bozar. Genel ağları devre dışı bırakmak bir gereksinimse, özel uç noktaları destekleyen bir Azure İşlevi ile uygulanan bir Özel Web API'si becerisini yapılandırabilir ve Azure AI hizmetleri kaynağını aynı sanal ağa ekleyebilirsiniz. Bu şekilde, özel uç noktaları kullanarak azure yapay zeka hizmetleri kaynağını doğrudan özel beceriden çağırabilirsiniz.

Not

Bazı yerleşik beceriler, bölgesel olmayan Azure AI hizmetlerini (örneğin, Metin Çevirisi Becerisi) temel alır. Bölgesel olmayan bir beceri kullanmak, isteğinizin Azure AI Search bölgesi dışında bir bölgede karşılanabileceği anlamına gelir. Bölgesel olmayan hizmetler hakkında daha fazla bilgi için bölgeye göre Azure AI hizmetleri ürünü sayfasına bakın.

Önemli gereksinimler özel durumlar

Özel Varlık Arama , Azure AI hizmetleri tarafından değil Azure AI Search tarafından ölçülür, ancak dizin oluşturucu başına günde 20'nin ötesinde işlemlerin kilidini açmak için bir Azure AI çok hizmetli 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, Azure AI çok hizmetli bir 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:

• Azure AI hizmetlerini çağırmayan yardımcı program becerileri (Koşullu, Belge Ayıklama, Şekillendirici, Metin Birleştirme ve Metin Bölme 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 AI Search, Azure AI Vision, Translator ve Azure AI Dili'ni temel alan yerleşik beceriler için Azure AI hizmetleri API'lerini çağırır.

Azure AI hizmetlerine arka uç çağrıları yapacak faturalanabilir yerleşik beceriler arasında Varlık Bağlama, Varlık Tanıma, Görüntü Analizi, Anahtar İfade Ayıklama, Dil Algılama, OCR, Kişisel Bilgiler (PII) Algılama, Yaklaşım ve Metin Çevirisi sayılabilir.

Görüntü ayıklama, zenginleştirmeden önce belgeler kırıldığında gerçekleşen bir Azure AI Search işlemidir. Görüntü ayıklama, ücretsiz katmanda günlük 20 ücretsiz ayıklama dışında tüm katmanlarda faturalandırılabilir. Görüntü ayıklama maliyetleri blobların içindeki görüntü dosyalarına, diğer dosyalardaki ekli 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 Bkz . Azure AI Search fiyatlandırma sayfası.

İpucu

Beceri kümesi işleme maliyetini azaltmak için artımlı zenginleştirmeyi (önizleme) etkinleştirerek beceri kümesinde yapılan değişikliklerden etkilenmeyen zenginleştirmeleri önbelleğe alın ve yeniden kullanın. Önbelleğe alma için Azure Depolama gerekir (özellikle görüntü ayıklama ve analiz kullanan beceri kümeleri için mevcut zenginleştirmeler yeniden kullanılabiliyorsa fiyatlandırmaya bakın ama beceri kümesi yürütmenin kümülatif maliyeti daha düşüktür.

Örnek: Tahmin maliyetleri

Azure AI Search dizin oluşturma ile 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 PDF'nin belge çatlama, görüntü ve metin ayıklama, optik karakter tanıma (OCR) görüntüleri ve kuruluşların varlık tanımasını içeren bir işlem hattı varsayın.

Bu makalede gösterilen fiyatlar varsayımsaldır. Tahmin sürecini göstermek için kullanılırlar. Maliyetleriniz daha düşük olabilir. İşlemlerin gerçek fiyatı için bkz . Azure yapay zeka hizmetleri fiyatlandırması.

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.

Sonraki adımlar

• Azure AI Search fiyatlandırma sayfası
• Beceri kümesi tanımlama
• Beceri Kümesi Oluşturma (REST)
• Zenginleştirilmiş alanları eşleme