Azure Bilişsel Arama bir beceri bilişsel hizmetler kaynağı iliştirmeAttach a Cognitive Services resource to a skillset in Azure Cognitive Search

AI algoritmaları, Azure Bilişsel Arama 'da içerik dönüştürmesi için kullanılan zenginleştirme işlem hatlarını kullanır.AI algorithms drive the enrichment pipelines used for content transformation in Azure Cognitive Search. Bu algoritmalar, görüntü analizi için görüntü işleme , optik karakter tanıma (OCR) ve varlık tanıma, anahtar tümceciği ayıklama ve diğer zenginler için metin analizi dahil olmak üzere Azure bilişsel hizmetler kaynaklarını temel alır.These algorithms are based on Azure Cognitive Services resources, including Computer Vision for image analysis and optical character recognition (OCR) and Text Analytics for entity recognition, key phrase extraction, and other enrichments. Belge zenginleştirme amaçları için Azure Bilişsel Arama tarafından kullanıldığı gibi algoritmalar , biryeteneğin içine yerleştirilmiş ve dizin oluşturma sırasında bir Dizin Oluşturucu tarafından başvurulan bir yetenekiçine sarılır.As used by Azure Cognitive Search for document enrichment purposes, the algorithms are wrapped inside a skill, placed in a skillset, and referenced by an indexer during indexing.

Sınırlı sayıda belgeyi ücretsiz olarak zenginleştirebilirsiniz.You can enrich a limited number of documents for free. Ya da, daha büyük ve daha sık sık iş yükleri için beceri 'e faturalanabilir bir bilişsel hizmetler kaynağı iliştirebilirsiniz.Or, you can attach a billable Cognitive Services resource to a skillset for larger and more frequent workloads. Bu makalede, Azure Bilişsel Arama Dizin oluşturmasırasında belgeleri zenginleştirmek üzere bir faturalanabilir bilişsel hizmetler kaynağını nasıl ekleyeceğinizi öğreneceksiniz.In this article, you'll learn how to attach a billable Cognitive Services resource to enrich documents during Azure Cognitive Search indexing.

Not

Faturalanabilir olaylar, Azure Bilişsel Arama belge çözme aşamasının bir parçası olarak Bilişsel Hizmetler API'si ve görüntü ayıklama için çağrılar içerir.Billable events include calls to Cognitive Services APIs and image extraction as part of the document-cracking stage in Azure Cognitive Search. Belgelerden veya bilişsel hizmetler 'i çağırmayan yetenekler için metin ayıklama ücreti alınmaz.There is no charge for text extraction from documents or for skills that do not call Cognitive Services.

Faturalanabilir yeteneklerin yürütülmesi, bilişsel Hizmetler Kullandıkça Öde fiyatındakiücretlendirilir.Execution of billable skills is at the Cognitive Services pay-as-you go price. Görüntü ayıklama fiyatlandırması için bkz. Azure bilişsel arama fiyatlandırma sayfası.For image extraction pricing, see the Azure Cognitive Search pricing page.

Aynı bölge gereksinimiSame-region requirement

Azure Bilişsel Arama ve Azure bilişsel hizmetler 'in aynı bölgede mevcut olması gerekir.We require that Azure Cognitive Search and Azure Cognitive Services exist within the same region. Aksi takdirde, bu iletiyi çalışma zamanında alırsınız: "Provided key is not a valid CognitiveServices type key for the region of your search service."Otherwise, you will get this message at run time: "Provided key is not a valid CognitiveServices type key for the region of your search service."

Bir hizmeti bölgeler arasında taşımanın bir yolu yoktur.There is no way to move a service across regions. Bu hatayı alırsanız, Azure Bilişsel Arama ile aynı bölgede yeni bir bilişsel hizmetler kaynağı oluşturmanız gerekir.If you get this error, you should create a new Cognitive Services resource in the same region as Azure Cognitive Search.

Not

Bazı yerleşik yetenekler, bölgesel olmayan bilişsel hizmetler 'e (örneğin, metin çevirisi becerisi) dayanır.Some built-in skills are based on non-regional Cognitive Services (for example, the Text Translation Skill). Bu becerilerden herhangi birini beceri ' e eklerseniz, verilerinizin Azure Bilişsel Arama veya bilişsel hizmetler kaynağı ile aynı bölgede kalmasını sağlamak için garanti olmadığını unutmayın.Be aware that if you add any of these skills to your skillset that your data is not guaranteed to stay in the same region as your Azure Cognitive Search or Cognitive Services resource. Daha fazla bilgi için bkz. hizmet durumu sayfası .See the service status page for more details.

Ücretsiz kaynakları kullanmaUse Free resources

AI zenginleştirme öğreticisini ve hızlı başlangıç alıştırmaları ' nı tamamlayabilmeniz için sınırlı, ücretsiz bir işleme seçeneğini kullanabilirsiniz.You can use a limited, free processing option to complete the AI enrichment tutorial and quickstart exercises.

Ücretsiz (sınırlı enzenginler) kaynakları, her abonelik için günde 20 belge ile kısıtlıdır.Free (Limited enrichments) resources are restricted to 20 documents per day, per subscription.

  1. Veri Içeri aktarma Sihirbazı 'nı açın:Open the Import data wizard:

    Veri Içeri aktarma Sihirbazı 'nı açınOpen the Import data wizard

  2. Bir veri kaynağı seçin ve AI zenginleştirme (Isteğe bağlı) eklemeyedevam edin.Choose a data source and continue to Add AI enrichment (Optional). Bu sihirbaza yönelik adım adım yönergeler için bkz. Azure Portal dizin oluşturma.For a step-by-step walkthrough of this wizard, see Create an index in the Azure portal.

  3. Bilişsel Hizmetler Ekle ' yi genişletin ve ücretsiz ' i (sınırlı enzenginler) seçin:Expand Attach Cognitive Services and then select Free (Limited enrichments):

    Genişletilmiş ek bilişsel Hizmetler bölümüExpanded Attach Cognitive Services section

  4. Artık bilişsel yetenekler eklemedahil olmak üzere sonraki adımlara devam edebilirsiniz.You can now continue on to the next steps, including Add cognitive skills.

Faturalanabilir kaynakları kullanmaUse billable resources

Günde 20 ' den fazla zenginleştirme oluşturan iş yükleri için faturalandırılabilir bilişsel hizmetler kaynağı iliştirdiğinizden emin olun.For workloads that create more than 20 enrichments per day, make sure to attach a billable Cognitive Services resource. Bilişsel Hizmetler API'si çağrısı yapmasanız bile, her zaman faturalanabilir bir bilişsel hizmetler kaynağı iliştirmenizi öneririz.We recommend that you always attach a billable Cognitive Services resource, even if you never intend to call Cognitive Services APIs. Kaynak eklemek günlük sınırı geçersiz kılar.Attaching a resource overrides the daily limit.

Yalnızca Bilişsel Hizmetler API'si çağıran yetenekler için ücret ödersiniz.You're charged only for skills that call the Cognitive Services APIs. Özel yeteneklerveya metin merkli, metin bölücüve milgibi yetenekler için, API tabanlı olmayan beceriler için faturalandırılırsınız.You're not billed for custom skills, or skills like text merger, text splitter, and shaper, which aren't API-based.

  1. Veri alma Sihirbazı ' nı açın, bir veri kaynağı seçin ve AI zenginleştirme (Isteğe bağlı) eklemeyedevam edin.Open the Import data wizard, choose a data source, and continue to Add AI enrichment (Optional).

  2. Bilişsel Hizmetler Ekle ' yi genişletin ve yeni bilişsel Hizmetler kaynağı oluştur' u seçinExpand Attach Cognitive Services and then select Create new Cognitive Services resource. Kaynağı oluşturabilmeniz için yeni bir sekme açılır:A new tab opens so that you can create the resource:

    Bilişsel hizmetler kaynağı oluşturmaCreate a Cognitive Services resource

  3. Konum listesinde Azure bilişsel arama hizmetinizin bulunduğu bölgeyi seçin.In the Location list, select the region where your Azure Cognitive Search service is located. Performans nedenleriyle bu bölgeyi kullandığınızdan emin olun.Make sure to use this region for performance reasons. Bu bölge kullanıldığında, bölgeler arasında giden bant genişliği ücretlerini de indirebilirsiniz.Using this region also voids outbound bandwidth charges across regions.

  4. Fiyatlandırma katmanı listesinde, Azure bilişsel arama tarafından sunulan yerleşik becerileri kapsayan adım adım Hizmetleri özellikleri dahil olmak üzere tüm bilişsel hizmetler özelliklerini almak için S0 ' ı seçin.In the Pricing tier list, select S0 to get the all-in-one collection of Cognitive Services features, including the Vision and Language features that back the built-in skills provided by Azure Cognitive Search.

    S0 katmanı için, bilişsel Hizmetler fiyatlandırma sayfasındabelirli iş yükleri için ücretleri bulabilirsiniz.For the S0 tier, you can find rates for specific workloads on the Cognitive Services pricing page.

    • Teklif Seç listesinde bilişsel Hizmetler ' in seçildiğinden emin olun.In the Select Offer list, make sure Cognitive Services is selected.
    • Dil özellikleri ' nin altında, metın ANALIZI Standard ücretleri AI dizin oluşturma için geçerlidir.Under Language features, the rates for Text Analytics Standard apply to AI indexing.
    • Görme özellikleri altında, görüntü işleme S1 için ücretler geçerlidir.Under Vision features, the rates for Computer Vision S1 apply.
  5. Yeni bilişsel hizmetler kaynağını sağlamak için Oluştur ' u seçin.Select Create to provision the new Cognitive Services resource.

  6. Veri Içeri aktarma Sihirbazı 'nı içeren önceki sekmeye geri dönün.Return to the previous tab, which contains the Import data wizard. Bilişsel hizmetler kaynağını göstermek için Yenile ' yi seçin ve ardından kaynağı seçin:Select Refresh to show the Cognitive Services resource, and then select the resource:

    Bilişsel hizmetler kaynağını seçinSelect the Cognitive Services resource

  7. Verilerinizde çalıştırmak istediğiniz belirli bilişsel becerileri seçmek için bilişsel yetenekler Ekle bölümünü genişletin.Expand the Add cognitive skills section to select the specific cognitive skills that you want to run on your data. Sihirbazın geri kalanını tamamlayın.Complete the rest of the wizard.

Bilişsel hizmetler kaynağına mevcut bir beceri iliştirmeAttach an existing skillset to a Cognitive Services resource

Mevcut bir beceri varsa, bunu yeni veya farklı bir bilişsel hizmetler kaynağına ekleyebilirsiniz.If you have an existing skillset, you can attach it to a new or different Cognitive Services resource.

  1. Hizmete genel bakış sayfasında becerileri' yi seçin:On the Service overview page, select Skillsets:

    Becerileri sekmesiSkillsets tab

  2. Beceri adını seçin ve ardından var olan bir kaynağı seçin veya yeni bir kaynak oluşturun.Select the name of the skillset, and then select an existing resource or create a new one. Değişikliklerinizi onaylamak için Tamam ' ı seçin.Select OK to confirm your changes.

    Beceri kaynak listesiSkillset resource list

    Ücretsiz (sınırlı enzenginler) seçeneğinin her gün 20 belge olduğunu ve yeni bir faturalanabilir kaynak sağlamak için yeni bilişsel Hizmetler kaynağı oluşturma ' yı kullanacağınızı unutmayın.Remember that the Free (Limited enrichments) option limits you to 20 documents daily, and that you can use Create new Cognitive Services resource to provision a new billable resource. Yeni bir kaynak oluşturursanız, bilişsel hizmetler kaynakları listesini yenilemek için Yenile ' yi seçin ve ardından kaynağı seçin.If you create a new resource, select Refresh to refresh the list of Cognitive Services resources, and then select the resource.

Bilişsel hizmetler 'i programlı olarak ekleAttach Cognitive Services programmatically

Program aracılığıyla beceri tanımlarken, Beceri bölümüne bir cognitiveServices bölümü ekleyin.When you're defining the skillset programmatically, add a cognitiveServices section to the skillset. Bu bölümde, Beceri ilişkilendirmek istediğiniz bilişsel hizmetler kaynağının anahtarını ekleyin.In that section, include the key of the Cognitive Services resource that you want to associate with the skillset. Kaynağın Azure Bilişsel Arama kaynağınız ile aynı bölgede olması gerektiğini unutmayın.Remember that the resource must be in the same region as your Azure Cognitive Search resource. Ayrıca @odata.typeekleyin ve #Microsoft.Azure.Search.CognitiveServicesByKeyolarak ayarlayın.Also include @odata.type, and set it to #Microsoft.Azure.Search.CognitiveServicesByKey.

Aşağıdaki örnekte bu desenler gösterilmektedir.The following example shows this pattern. Tanımın sonundaki cognitiveServices bölümüne dikkat edin.Notice the cognitiveServices section at the end of the definition.

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2019-05-06
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.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>"
    }
}

Örnek: tahmini maliyetlerExample: Estimate costs

Bilişsel arama dizinlemesi ile ilişkili maliyetleri tahmin etmek için, ortalama bir belgenin nasıl göründüğünü bir fikir ile başlayın, böylece bazı sayılar çalıştırabilirsiniz.To estimate the costs associated with cognitive search indexing, start with an idea of what an average document looks like so you can run some numbers. Örneğin, şunları yapabilirsiniz:For example, you might approximate:

  • 1.000 PDF.1,000 PDFs.
  • Altı sayfa her.Six pages each.
  • Sayfa başına bir görüntü (6.000 resim).One image per page (6,000 images).
  • sayfa başına 3.000 karakter.3,000 characters per page.

Her PDF 'nin belge çözme, görüntü ve metin ayıklama, optik karakter tanıma (OCR) ve kuruluşların varlık tanıma özelliğini içeren bir işlem hattı varsayın.Assume a pipeline that consists of document cracking of each PDF, image and text extraction, optical character recognition (OCR) of images, and entity recognition of organizations.

Bu makalede gösterilen fiyatlar kuramsal olarak gösterilmiştir.The prices shown in this article are hypothetical. Tahmin işlemini göstermek için kullanılırlar.They're used to illustrate the estimation process. Maliyetleriniz daha düşük olabilir.Your costs could be lower. İşlemlerin gerçek fiyatları için bkz. bilişsel Hizmetler fiyatlandırması.For the actual prices of transactions, see See Cognitive Services pricing.

  1. Metin ve görüntü içeriğiyle belge çözme için metin ayıklama Şu anda ücretsizdir.For document cracking with text and image content, text extraction is currently free. 6.000 görüntü için, ayıklanan her 1.000 görüntüsü için $1 ' i varsayın.For 6,000 images, assume $1 for every 1,000 images extracted. Bu adım için $6,00 maliyeti vardır.That's a cost of $6.00 for this step.

  2. OCR Bilişsel Beceri, Ingilizce olan 6.000 görüntünün OCR için en iyi algoritmayı (DescribeText) kullanır.For OCR of 6,000 images in English, the OCR cognitive skill uses the best algorithm (DescribeText). 1.000 görüntü başına $2,50 maliyeti varsayarak, bu adım için $15,00 ödersiniz.Assuming a cost of $2.50 per 1,000 images to be analyzed, you would pay $15.00 for this step.

  3. Varlık ayıklama için, sayfa başına toplam üç metin kaydı vardır.For entity extraction, you'd have a total of three text records per page. Her kayıt 1.000 karakterdir.Each record is 1,000 characters. Sayfa başına 6.000 sayfa ile çarpılan üç metin kaydı 18.000 metin kayıtlarına eşittir.Three text records per page multiplied by 6,000 pages equals 18,000 text records. Her 1.000 metin kaydı için $2,00 varsayılıyor, bu adımda maliyet $36,00.Assuming $2.00 per 1,000 text records, this step would cost $36.00.

Tümünü bir araya getirmek için, açıklanan beceri bu türdeki 1.000 PDF belgelerini almak üzere $57,00 ile ödeme yaparsınız.Putting it all together, you'd pay about $57.00 to ingest 1,000 PDF documents of this type with the described skillset.

Sonraki adımlarNext steps