Azure의 기술에 Cognitive Services 리소스 연결 Cognitive SearchAttach a Cognitive Services resource to a skillset in Azure Cognitive Search

Azure Cognitive Search에서 보강 파이프라인을 구성 하는 경우 제한 된 수의 문서를 무료로 보강할 수 있습니다.When configuring an enrichment pipeline in Azure Cognitive Search, you can enrich a limited number of documents free of charge. 더 크고 더 잦은 워크 로드의 경우 청구 가능 Cognitive Services 리소스를 연결 해야 합니다.For larger and more frequent workloads, you should attach a billable Cognitive Services resource.

이 문서에서는 보강 파이프라인을 정의 하는 기술에 키를 할당 하 여 리소스를 연결 하는 방법에 대해 알아봅니다.In this article, you'll learn how to attach a resource by assigning a key to a skillset that defines an enrichment pipeline.

보강 중에 사용 되는 리소스Resources used during enrichment

Azure Cognitive Search는 이미지 분석과 OCR (광학 문자 인식), 자연어 처리 Text Analytics텍스트 변환과같은 기타 강화에 대 한 Computer Vision 를 비롯 하 여 Cognitive Services에 대 한 종속성이 있습니다.Azure Cognitive Search has a dependency on Cognitive Services, including Computer Vision for image analysis and optical character recognition (OCR), Text Analytics for natural language processing, and other enrichments like Text Translation. Azure Cognitive Search의 보강 컨텍스트에서 이러한 AI 알고리즘은 기술에 배치 되 고 인덱싱 중에 인덱서가 참조 되는 기술내에 래핑됩니다.In the context of enrichment in Azure Cognitive Search, these AI algorithms are wrapped inside a skill, placed in a skillset, and referenced by an indexer during indexing.

청구 방법How billing works

  • Azure Cognitive Search는 기술에서 제공 하는 Cognitive Services 리소스 키를 사용 하 여 이미지 및 텍스트 보강를 청구 합니다.Azure Cognitive Search uses the Cognitive Services resource key you provide on a skillset to bill for image and text enrichment. 청구 가능한 기술 실행은 Cognitive Services 종 량 제 가격으로 진행됩니다.Execution of billable skills is at the Cognitive Services pay-as-you go price.

  • 이미지 추출은 보강 전에 문서를 깨진 경우 발생 하는 Azure Cognitive Search 작업입니다.Image extraction is an Azure Cognitive Search operation that occurs when documents are cracked prior to enrichment. 이미지 추출을 청구 가능 합니다.Image extraction is billable. 이미지 추출 가격은 Azure Cognitive Search 가격 책정 페이지를 참조 하세요.For image extraction pricing, see the Azure Cognitive Search pricing page.

  • 텍스트 추출은 문서 크랙 구에도 발생 합니다.Text extraction also occurs during the document cracking phrase. 청구 되지 않습니다.It is not billable.

  • 조건부, Shaper, 텍스트 병합 및 텍스트 분할 기술을 포함 하 여 Cognitive Services를 호출 하지 않는 기술은 요금이 청구 되지 않습니다.Skills that do not call Cognitive Services, including Conditional, Shaper, Text Merge, and Text Split skills, are not billable.

동일한 지역 요구 사항Same-region requirement

Azure Cognitive Search와 Azure Cognitive Services는 동일한 지역 내에 있어야 합니다.We require that Azure Cognitive Search and Azure Cognitive Services exist within the same region. 그렇지 않으면 런타임에이 메시지를 받게 됩니다."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."

여러 지역에서 서비스를 이동할 수 있는 방법은 없습니다.There is no way to move a service across regions. 이 오류가 발생 하는 경우 Azure Cognitive Search와 동일한 지역에 새 Cognitive Services 리소스를 만들어야 합니다.If you get this error, you should create a new Cognitive Services resource in the same region as Azure Cognitive Search.

참고

일부 기본 제공 기술은 비 지역별 Cognitive Services (예: 텍스트 번역 기술)를 기반으로 합니다.Some built-in skills are based on non-regional Cognitive Services (for example, the Text Translation Skill). 지역이 아닌 기술을 사용 하는 것은 Azure Cognitive Search 지역이 아닌 다른 지역에서 요청을 처리할 수 있음을 의미 합니다.Using a non-regional skill means that your request might be serviced in a region other than the Azure Cognitive Search region. 비 지역별 서비스에 대 한 자세한 내용은 지역별 제품 Cognitive Services 페이지를 참조 하세요.For more information non-regional services, see the Cognitive Services product by region page.

무료 리소스 사용Use Free resources

제한 된 무료 처리 옵션을 사용 하 여 AI 보강 자습서 및 빠른 시작 연습을 완료할 수 있습니다.You can use a limited, free processing option to complete the AI enrichment tutorial and quickstart exercises.

Free (제한 된 강화) 리소스는 인덱서 당 하루 20 개의 문서로 제한 됩니다.Free (Limited enrichments) resources are restricted to 20 documents per day, per indexer. 인덱서를 삭제 하 고 다시 만들어 카운터를 다시 설정할 수 있습니다.You can delete and recreate the indexer to reset the counter.

  1. 데이터 가져오기 마법사를 엽니다.Open the Import data wizard:

    데이터 가져오기 마법사 열기Open the Import data wizard

  2. 데이터 원본을 선택 하 고 AI 보강 (선택 사항) 를 계속 추가 합니다.Choose a data source and continue to Add AI enrichment (Optional). 이 마법사의 단계별 연습은 Azure Portal에서 인덱스 만들기를 참조 하세요.For a step-by-step walkthrough of this wizard, see Create an index in the Azure portal.

  3. 연결 Cognitive Services 확장 한 다음 무료 (제한 된 강화) 를 선택 합니다.Expand Attach Cognitive Services and then select Free (Limited enrichments):

    확장 된 Attach Cognitive Services 섹션Expanded Attach Cognitive Services section

  4. 이제 인식 기술 추가를 포함 하 여 다음 단계를 진행할 수 있습니다.You can now continue on to the next steps, including Add cognitive skills.

유료 리소스 사용Use billable resources

하루에 20 개 이상의 강화을 만드는 작업의 경우 청구 가능 Cognitive Services 리소스를 연결 해야 합니다.For workloads that create more than 20 enrichments per day, make sure to attach a billable Cognitive Services resource. Cognitive Services API를 호출 하지 않으려는 경우에도 항상 청구 가능 Cognitive Services 리소스를 연결 하는 것이 좋습니다.We recommend that you always attach a billable Cognitive Services resource, even if you never intend to call Cognitive Services APIs. 리소스를 연결 하면 일일 한도가 재정의 됩니다.Attaching a resource overrides the daily limit.

Cognitive Services API를 호출 하는 기술에 대해서만 요금이 청구 됩니다.You're charged only for skills that call the Cognitive Services APIs. 사용자 지정 기술또는 텍스트 병합기, 텍스트 분할자shaper같은 기술에 대 한 요금이 청구 되지 않으며,이는 API 기반이 아닙니다.You're not billed for custom skills, or skills like text merger, text splitter, and shaper, which aren't API-based.

  1. 데이터 가져오기 마법사를 열고 데이터 원본을 선택한 다음 AI 보강 (선택 사항) 를 계속 추가 합니다.Open the Import data wizard, choose a data source, and continue to Add AI enrichment (Optional).

  2. 연결 Cognitive Services 를 확장 하 고 새 Cognitive Services 리소스 만들기를 선택 합니다.Expand Attach Cognitive Services and then select Create new Cognitive Services resource. 리소스를 만들 수 있도록 새 탭이 열립니다.A new tab opens so that you can create the resource:

    Cognitive Services 리소스 만들기Create a Cognitive Services resource

  3. 위치 목록에서 Azure Cognitive Search 서비스가 있는 지역을 선택 합니다.In the Location list, select the region where your Azure Cognitive Search service is located. 성능상의 이유로이 지역을 사용 해야 합니다.Make sure to use this region for performance reasons. 또한이 영역을 사용 하면 지역 간에 아웃 바운드 대역폭 요금이 void 됩니다.Using this region also voids outbound bandwidth charges across regions.

  4. 가격 책정 계층 목록에서 S0 를 선택 하 여 Azure Cognitive Search에서 제공 하는 기본 제공 기술을 지 원하는 비전 및 언어 기능을 포함 하 여 Cognitive Services 기능의 전체 컬렉션을 가져옵니다.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 계층의 경우 Cognitive Services 가격 책정 페이지에서 특정 작업에 대 한 요금을 확인할 수 있습니다.For the S0 tier, you can find rates for specific workloads on the Cognitive Services pricing page.

    • 제안 선택 목록에서 Cognitive Services 가 선택 되어 있는지 확인 합니다.In the Select Offer list, make sure Cognitive Services is selected.
    • 언어 기능에서 Text Analytics 표준 에 대 한 요금은 AI 인덱싱에 적용 됩니다.Under Language features, the rates for Text Analytics Standard apply to AI indexing.
    • 비전 기능에서 S1 Computer Vision 에 대 한 요금이 적용 됩니다.Under Vision features, the rates for Computer Vision S1 apply.
  5. 만들기 를 선택 하 여 새 Cognitive Services 리소스를 프로 비전 합니다.Select Create to provision the new Cognitive Services resource.

  6. 데이터 가져오기 마법사가 포함 된 이전 탭으로 돌아갑니다.Return to the previous tab, which contains the Import data wizard. 새로 고침 을 선택 하 Cognitive Services 리소스를 표시 한 다음 리소스를 선택 합니다.Select Refresh to show the Cognitive Services resource, and then select the resource:

    Cognitive Services 리소스를 선택 합니다.Select the Cognitive Services resource

  7. 인식 기술 추가 섹션을 확장 하 여 데이터에서 실행 하려는 특정 인지 기술을 선택 합니다.Expand the Add cognitive skills section to select the specific cognitive skills that you want to run on your data. 마법사의 나머지 단계를 완료 합니다.Complete the rest of the wizard.

Cognitive Services 리소스에 기존 기술 연결Attach an existing skillset to a Cognitive Services resource

기존 기술이 있으면 새 Cognitive Services 리소스나 다른 Cognitive Services 리소스에 연결할 수 있습니다.If you have an existing skillset, you can attach it to a new or different Cognitive Services resource.

  1. 서비스 개요 페이지에서 기술력과를 선택 합니다.On the Service overview page, select Skillsets:

    기술력과 탭Skillsets tab

  2. 기술의 이름을 선택한 다음 기존 리소스를 선택 하거나 새 리소스를 만듭니다.Select the name of the skillset, and then select an existing resource or create a new one. 확인을 선택하여 변경 내용을 확인합니다.Select OK to confirm your changes.

    기술 리소스 목록Skillset resource list

    무료 (제한 된 강화) 옵션은 매일 20 개의 문서를 제한 하 고 새 Cognitive Services 리소스 만들기 를 사용 하 여 새로운 청구 가능 리소스를 프로 비전 할 수 있습니다.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. 새 리소스를 만든 경우 새로 고침을 선택하여 Cognitive Services 리소스 목록을 새로 고친 다음, 리소스를 선택합니다.If you create a new resource, select Refresh to refresh the list of Cognitive Services resources, and then select the resource.

프로그래밍 방식으로 Cognitive Services 연결Attach Cognitive Services programmatically

프로그래밍 방식으로 기술을 정의하는 경우 cognitiveServices 섹션을 기술에 추가합니다.When you're defining the skillset programmatically, add a cognitiveServices section to the skillset. 이 섹션에는 기술 연결 하려는 Cognitive Services 리소스의 키가 포함 되어 있습니다.In that section, include the key of the Cognitive Services resource that you want to associate with the skillset. 리소스는 Azure Cognitive Search 리소스와 동일한 지역에 있어야 합니다.Remember that the resource must be in the same region as your Azure Cognitive Search resource. 또한 @odata.type을 포함하고, 이를 #Microsoft.Azure.Search.CognitiveServicesByKey로 설정하세요.Also include @odata.type, and set it to #Microsoft.Azure.Search.CognitiveServicesByKey.

다음 예제는 이러한 패턴을 보여줍니다.The following example shows this pattern. 정의의 끝 부분에 있는 섹션을 확인 cognitiveServices 합니다.Notice the cognitiveServices section at the end of the definition.

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2020-06-30
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>"
    }
}

예: 비용 추정Example: Estimate costs

인지 검색 인덱싱에 관련 된 비용을 예상 하려면 몇 가지 숫자를 실행할 수 있도록 평균 문서 모양을 파악 해야 합니다.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. 예를 들어 다음을 대략적으로 확인할 수 있습니다.For example, you might approximate:

  • 1000 Pdf.1,000 PDFs.
  • 6 개의 페이지Six pages each.
  • 페이지당 하나의 이미지 (6000 이미지)One image per page (6,000 images).
  • 페이지당 3000 자3,000 characters per page.

각 PDF의 문서 크랙, 이미지 및 텍스트 추출, 이미지의 OCR (광학 문자 인식) 및 조직의 엔터티 인식으로 구성 된 파이프라인을 가정 합니다.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.

이 문서에 표시 된 가격은 가상입니다.The prices shown in this article are hypothetical. 예측 프로세스를 설명 하는 데 사용 됩니다.They're used to illustrate the estimation process. 비용은 낮아질 수 있습니다.Your costs could be lower. 트랜잭션의 실제 가격은 Cognitive Services 가격 책정을 참조 하세요.For the actual prices of transactions, see See Cognitive Services pricing.

  1. 텍스트 및 이미지 콘텐츠로 문서 해독의 경우, 텍스트 추출이 현재 무료입니다.For document cracking with text and image content, text extraction is currently free. 6000 이미지의 경우 추출 된 모든 1000 이미지에 대해 $1를 가정 합니다.For 6,000 images, assume $1 for every 1,000 images extracted. 이 단계의 비용은 $6.00입니다.That's a cost of $6.00 for this step.

  2. 영어로 된 6,000개의 이미지 OCR의 경우, OCR 인지 기술은 최적의 알고리즘(DescribeText)을 사용합니다.For OCR of 6,000 images in English, the OCR cognitive skill uses the best algorithm (DescribeText). 분석할 1,000개 이미지당 비용이 $2.50라고 가정할 경우 이 단계를 위해 $15.00를 지불합니다.Assuming a cost of $2.50 per 1,000 images to be analyzed, you would pay $15.00 for this step.

  3. 엔터티 추출의 경우 페이지당 총 세 개의 텍스트 레코드가 있습니다.For entity extraction, you'd have a total of three text records per page. 각 레코드는 1,000자입니다.Each record is 1,000 characters. 페이지당 3 개의 텍스트 레코드 6000 페이지를 곱한 값이 18000 텍스트 레코드와 같습니다.Three text records per page multiplied by 6,000 pages equals 18,000 text records. 1,000개의 텍스트 레코드당 $2.00라고 가정할 경우 이 단계의 비용은 $36.00입니다.Assuming $2.00 per 1,000 text records, this step would cost $36.00.

이를 모두 함께 사용 하면 설명 된 기술을 사용 하 여이 유형의 1000 PDF 문서를 수집 하는 데 $57.00에 대 한 비용을 지불 하 게 됩니다.Putting it all together, you'd pay about $57.00 to ingest 1,000 PDF documents of this type with the described skillset.

다음 단계Next steps