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, dizin başına günlük 20 işlemle sınırlı olmak üzere az 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 hesap, tek tek hizmetler yerine azure yapay zeka hizmetlerinin bir koleksiyonunu sağlar. Azure AI Arama beceri kümesinde bir hesap sağlamak, Microsoft'un şu hizmetleri kullandığınız için sizden ücret ödemesine olanak tanır:

• Görüntü analizi, optik karakter tanıma (OCR) ve çok modüllü metin ve görüntü ekleme 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

Beceri kümesindeki Azure AI çoklu kaynağına bağlantı bilgileri sağlamanız gerekir. Azure AI Search beceri kümesi iş yükleri için bağlantıyı kullanmaz, ancak kaynağın faturalama ölçümlerine erişmek için bağlantıyı kullanır. Bu nedenle, Azure AI hizmetleri hesabınız beceri işleme için değil faturalama için kullanılır. Azure AI Search, beceri işleme için ayrı ayrılmış kaynaklar kullanır.

Bağlantıda bir anahtar kullanabilir veya şu anda önizleme aşamasında olan anahtarsız bir yaklaşım uygulayabilirsiniz.

Önkoşullar

• Arama hizmetiniz bir Azure AI çoklu hizmet hesabına özel bağlantılar için oluşturma tarihi, katman ve bölge gereksinimlerini karşılamadığı sürece genel uç nokta üzerinden bağlantı.

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

Azure portalını veya daha yeni önizleme REST API'lerini ve beta SDK paketlerini kullanarak yönetilen kimlik ve izinler kullanarak Azure AI çok hizmetli bir kaynak ekleyebilirsiniz. Bu yaklaşımın avantajı faturalamanın anahtarsız olması ve bölgelere bağımlılığı olmamasıdır.

1. Azure AI Search'i yönetilen kimlik kullanacak şekilde yapılandırın.

2. Azure AI çok hizmetli kaynağınızda, kimliği Bilişsel Hizmetler Kullanıcı rolüne atayın.

3. Azure portalını veya Skillset 2024-11-01-preview REST API'sini veya söz dizimini sağlayan bir Azure SDK beta paketini kullanarak bir beceri kümesini kimlik kullanacak şekilde yapılandırın:

   • Bağlantıda kullanılan yönetilen kimlik arama hizmetine aittir.
   • Kimlik sistem tarafından yönetilebilir veya kullanıcıya atanabilir.
   • Kimliğin Azure AI kaynağı üzerinde Bilişsel Hizmetler Kullanıcı izinlerine sahip olması gerekir.
   • @odata.type her zaman #Microsoft.Azure.Search.AIServicesByIdentityşeklindedir.
   • subdomainUrl , Azure AI çok hizmetli kaynağınızın uç noktasıdır. Azure AI Search ve Azure AI hizmetleri tarafından ortak olarak desteklenen herhangi bir bölgede olabilir.

Anahtarlarda olduğu gibi, Azure AI Services kaynağı hakkında sağladığınız ayrıntılar bağlantılar için değil faturalama için kullanılır. Yerleşik beceri işleme için Azure Yapay Zeka Arama'nın Azure yapay zeka hizmetlerine yaptığı tüm API istekleri, Microsoft tarafından dahili olarak yönetilmeye devam eder.

Alt etki alanı URL'si benzersiz bir ad içermelidir (örneğin, https://hereismyuniquename.cognitiveservices.azure.com). Hizmet Azure portalı aracılığıyla oluşturulduysa, hizmet kurulumunuzun bir parçası olarak otomatik olarak benzersiz bir alt etki alanı oluşturulur. Azure AI Search tümleştirmesi ile kullanmadan önce hizmetinizin benzersiz bir alt etki alanı içerdiğinden emin olun.

Örnek: sistem tarafından atanan yönetilen kimlik

Kimlik null olarak ayarlanır.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": null 
    }  
} 

Örnek: kullanıcı tarafından atanan yönetilen kimlik

Kimlik, kullanıcı tarafından atanan yönetilen kimliğin kaynak kimliğine ayarlanır. Kullanıcı tarafından atanan mevcut bir yönetilen kimliği bulmak için bkz . Kullanıcı tarafından atanan yönetilen kimlikleri yönetme.

Kullanıcı tarafından atanan yönetilen kimlik için ve userAssignedIdentity özelliklerini ayarlayın@odata.type.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.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}"" 
        }
    } 
}

Kaynak anahtarı üzerinden faturalandır

Azure AI Search, Azure AI çok hizmetli kaynak anahtarını kullanarak işlem için ücret de alabilir. Bu yaklaşım varsayılandır ve genel kullanıma açıktır. Anahtarı beceri kümesine eklemek için Azure portalını, REST API'sini veya Azure SDK'sını kullanabilirsiniz.

Desteklenen iki anahtar türü vardır: #Microsoft.Azure.Search.CognitiveServicesByKey bölgesel uç noktayı çağıran ve "#Microsoft.Azure.Search.AIServicesByKey alt etki alanını çağıran anahtar türleri. Paylaşılan özel bağlantı desteği ve arama hizmetiyle ilgili bölgesel gereksinimler olmadan çalışabilmesi için kullanmanızı AIServicesByKey öneririz.

Özelliği belirsiz bırakırsanız cognitiveServices , 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.

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-11-01-Preview
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.AIServicesByKey",
        "description": "mycogsvcs",
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",
        "key": "<your key goes here>"
    }
}

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, çoklu hizmet anahtarını 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.

Anahtar nasıl kullanılır?

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 faturalama geçerli olur. 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ş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."

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 yürütme ortamı kullanıyor olsanız bile, Azure AI Search tüm beceri zenginleştirmelerini gerçekleştirmek için dahili olarak sağlanan Azure AI çok hizmetli kaynağını kullanmaya devam eder.

Genel bağlantı gereksinimleri

Arama hizmetinizin ne zaman oluşturulduğuna ve katmanına ve bölgesine bağlı olarak, yerleşik becerilerin faturalaması için Azure AI Search'ten Azure AI çoklu hizmetine genel bağlantı gerekebilir. 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.

Genel ağı kullanamıyorsanız, özel uç noktaları destekleyen bir Azure İşlevi ile uygulanan bir Özel Web API'si becerisi 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.

Ö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ı.

Ö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