Azure AI 검색의 기술 세트에 Azure AI 다중 서비스 리소스 연결

아티클
10/22/2024

Azure AI Search에서 선택적 AI 보강 파이프라인 을 구성할 때 인덱스당 매일 20개의 트랜잭션으로 제한되는 적은 수의 문서를 무료로 보강할 수 있습니다. 더 크고 빈번한 워크로드의 경우 청구 가능한 Azure AI 다중 서비스 리소스를 연결해야 합니다.

다중 서비스 계정은 개별 서비스가 아닌 Azure AI 서비스 컬렉션을 제공합니다. 계정에 연결된 리소스 키가 있습니다. 이 키는 Azure AI Search 기술 세트 에 지정되며 Microsoft에서 다음 서비스 사용에 대한 요금을 청구할 수 있습니다.

이미지 분석, OCR(광학 문자 인식) 및 멀티모달 텍스트 및 이미지 포함을 위한 Azure AI Vision
언어 검색, 엔터티 인식, 감정 분석 및 핵심 구 추출을 위한 Azure AI 언어
음성 텍스트 변환 및 텍스트 음성 변환을 위한 Azure AI 음성
컴퓨터 텍스트 번역을 위한 Azure AI 번역기

키는 연결이 아닌 청구에 사용됩니다. 연결에서 역할 할당 및 관리 ID와 같은 다른 메커니즘을 사용하는 경우에도 기술 세트에 키를 제공해야 합니다.

팁

Azure는 청구 및 예산을 모니터링할 수 있는 인프라를 제공합니다. Azure AI 서비스 모니터링에 대한 자세한 내용은 Azure AI 서비스 비용 계획 및 관리를 참조하세요.

Azure AI 다중 서비스 계정에 대한 리소스 키 가져오기

Azure Portal에 로그인합니다.
검색 서비스와 동일한 지역에 Azure AI 다중 서비스 리소스를 만듭니다.
리소스 키 및 엔드포인트 페이지에서 리소스>키를 가져옵니다.

기술 세트에 리소스 키 추가

Azure Portal, REST API 또는 Azure SDK를 사용하여 기술 세트에 키를 추가할 수 있습니다.

속성을 지정하지 않은 상태로 두면 검색 서비스는 매일 인덱서에서 사용할 수 있는 무료 보강 기능을 사용하려고 시도합니다. 청구 가능한 기술의 실행은 인덱서 호출당 20개의 트랜잭션에서 중지되고 "시간 초과" 메시지가 인덱서 실행 기록에 나타납니다.

기술 세트 정의에 키를 추가합니다.

데이터 가져오기 마법사를 사용하는 경우 Azure AI 계정을 만들거나 선택합니다. 마법사는 기술 세트 정의에 리소스 키를 추가합니다.
새 기술 세트 또는 기존 기술 세트의 경우 기술 세트 정의의 키를 제공합니다.

요청 본문에 섹션을 지정하는 cognitiveServices 기술 세트 만들기 또는 업데이트 API를 사용합니다.

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

다음 코드 조각은 간결함을 위해 잘린 azure-search-dotnet-samples에서 가져온 것입니다.

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

키 제거

보강은 청구 가능한 작업입니다. Azure AI 서비스를 더 이상 호출할 필요가 없는 경우 다음 지침에 따라 다중 서비스 키를 제거하고 외부 리소스의 사용을 방지합니다. 키가 없으면 기술 세트는 인덱서당 하루 20개의 무료 트랜잭션인 기본 할당으로 되돌립니다. 청구 가능한 기술의 실행은 20개의 트랜잭션에서 중지되고 할당이 모두 사용되면 인덱서 실행 기록에 "시간 초과" 메시지가 나타납니다.

Azure Portal
REST (영문)

Azure Portal에 로그인합니다.
검색 관리 > 기술 세트의 목록에서 기술 세트를 선택합니다.
를 포함하는 파일의 섹션으로 스크롤합니다 "cognitiveServices".
JSON에서 키 값을 삭제하고 기술 세트를 저장합니다.

전체 정의를 사용할 수 있도록 기술 세트를 가져옵니다.
기술 세트의 JSON 정의를 제공하여 업데이트 기술 세트 요청을 작성합니다.

정의 본문에서 키를 제거한 후 다음과 같은 요청을 보냅니다.

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

또는 "cognitiveServices"를 null로 설정해도 됩니다.

"cognitiveServices": null,

키 사용 방법

키 기반 청구는 Azure AI 리소스에 대한 API 호출이 인덱서당 하루 20개의 API 호출을 초과하는 경우 적용됩니다. 인덱서 다시 설정하여 API 수를 다시 설정할 수 있습니다.

키는 청구에 사용되지만 보강 작업의 연결에는 사용되지 않습니다. 연결의 경우 검색 서비스는 동일한 물리적 지역에 있는 Azure AI 서비스 리소스에 내부 네트워크를 통해 연결합니다. Azure AI 검색을 제공하는 대부분의 지역에서는 언어와 같은 다른 Azure AI 서비스도 제공합니다. 두 서비스가 모두 없는 지역에서 AI 보강을 시도하면 "제공된 키는 검색 서비스 지역에 유효한 CognitiveServices 유형 키가 아닙니다"라는 메시지가 표시됩니다.

현재 기본 제공 기술에 대한 청구에는 Azure AI 검색에서 다른 Azure AI 서비스로의 공용 연결이 필요합니다. 공용 네트워크 액세스를 사용하지 않도록 설정하면 요금이 청구되지 않습니다. 공용 네트워크를 사용하지 않도록 설정하는 것이 요구 사항인 경우 프라이빗 엔드포인트를 지원하는 Azure Functions로 구현된 사용자 지정 Web API 기술을 구성하고 동일한 VNET에 대한 Azure AI 서비스 리소스를 추가할 수 있습니다. 이러한 방식으로 프라이빗 엔드포인트를 사용하여 사용자 지정 기술에서 직접 Azure AI 서비스 리소스를 호출할 수 있습니다.

참고 항목

일부 기본 제공 기술은 비 지역별 Azure AI 서비스(예: 텍스트 번역 기술)를 기반으로 합니다. 비지역별 기술을 사용하는 것은 Azure AI 검색 지역이 아닌 다른 지역에서 요청을 처리할 수 있음을 의미합니다. 비지역별 서비스에 대한 자세한 내용은 지역별 Azure AI 서비스 제품 페이지를 참조하세요.

주요 요구 사항 특수 사례

사용자 지정 엔터티 조회는 Azure AI 서비스가 아닌 Azure AI 검색으로 측정되지만, 인덱서당 하루 20개를 초과하는 트랜잭션을 잠금 해제하려면 Azure AI 다중 서비스 리소스 키가 필요합니다. 이 기술의 경우에만 리소스 키는 트랜잭션 수를 차단 해제하지만 청구와는 관련이 없습니다.

무료 보강

AI 보강은 청구 가능한 보강에 대한 소량의 무료 처리를 제공하므로 Azure AI 다중 서비스 리소스를 연결하지 않고도 짧은 연습을 완료할 수 있습니다. 무료 보강은 인덱서당 하루에 20개의 문서입니다. 연습을 반복하려는 경우 인덱스기를 다시 설정하여 카운터를 다시 설정할 수 있습니다.

일부 보강은 항상 무료입니다.

Azure AI 서비스를 호출하지 않는 유틸리티 기술(즉, 조건부, 문서 추출, 셰이퍼, 텍스트 병합 및 텍스트 분할 기술)은 청구되지 않습니다.
PDF 문서 및 기타 애플리케이션 파일에서 텍스트 추출은 청구할 수 없습니다. 문서 크래킹 중에 발생하는 텍스트 추출은 AI 보강이 아니지만 AI 보강 중에 발생하므로 여기에 언급됩니다.

청구 가능한 보강

AI 보강 중에 Azure AI 검색은 Azure AI 비전, Azure AI 번역기 및 Azure AI 언어를 기반으로 하는 기본 제공 기술을 위해 Azure AI 서비스 API를 호출합니다.

Azure AI 서비스에 대한 백 엔드 호출을 수행하는 청구 가능한 기본 제공 기술에는 엔터티 링크 설정, 엔터티 인식, 이미지 분석, 핵심 구 추출, 언어 인식, OCR , PII(개인 식별 정보) 검색, 감정 및 텍스트 번역이 포함됩니다.

이미지 추출은 보강 전에 문서가 깨진 경우 발생하는 Azure AI 검색 작업입니다. 이미지 추출은 무료 계층에서 20개의 무료 일별 추출을 제외하고 모든 계층에서 청구 가능합니다. 이미지 추출 비용은 Blob 내부의 이미지 파일, 다른 파일(PDF 및 기타 앱 파일)에 포함된 이미지, 문서 추출을 사용하여 추출한 이미지에 적용됩니다. 이미지 추출 가격 책정은 Azure AI 검색 가격 책정 페이지를 참조하세요.

팁

기술 세트 처리 비용을 낮추려면 증분 보강을 사용하도록 설정하여 기술 세트 변경에 의해 영향을 받지 않는 보강을 캐시하고 재사용합니다. 캐싱에는 Azure Storage가 필요합니다(가격 책정 참조). 특히 이미지 추출 및 분석을 사용하는 기술 세트의 경우 기존 강화를 재사용할 수 있는 경우 기술 세트 실행의 누적 비용이 더 낮습니다.

예제: 비용 추정

Azure AI 검색 인덱싱과 관련된 비용을 추정하려면 평균 문서가 어떤 모양인지부터 생각하여 몇 가지 숫자를 실행할 수 있도록 합니다. 예를 들어 다음과 같을 수 있습니다.

PDF 파일 1,000개
각 6페이지
페이지당 이미지 하나(이미지 6,000개)
페이지당 3,000자

각 PDF의 문서 크래킹, 이미지 및 텍스트 추출, 이미지의 OCR(광학 문자 인식) 및 조직의 엔터티 인식으로 구성된 파이프라인이 있다고 가정합니다.

이 문서에 표시된 가격은 가상입니다. 예측 프로세스를 설명하는 데 사용됩니다. 비용은 낮아질 수 있습니다. 트랜잭션의 실제 가격은 Azure AI 서비스 가격 책정을 참조하세요.

텍스트 및 이미지 콘텐츠로 문서 해독의 경우, 텍스트 추출이 현재 무료입니다. 6,000개 이미지의 경우 추출된 모든 1,000개 이미지에 대해 $1를 가정합니다. 이 단계의 비용은 $6.00입니다.
영어로 된 6,000개의 이미지 OCR의 경우, OCR 인지 기술은 최적의 알고리즘(DescribeText)을 사용합니다. 분석할 1,000개 이미지당 비용이 $2.50라고 가정할 경우 이 단계를 위해 $15.00를 지불합니다.
엔터티 추출의 경우 페이지당 총 3개의 텍스트 레코드가 있습니다. 각 레코드는 1,000자입니다. 페이지당 3개의 텍스트 레코드* 6,000장의 페이지 = 18,000개의 텍스트 레코드입니다. 1,000개의 텍스트 레코드당 $2.00라고 가정할 경우 이 단계의 비용은 $36.00입니다.

비용을 모두 합하면, 설명한 기술 세트를 통해 이러한 형식의 PDF 문서 1,000개를 수집하는 데 $57.00 정도를 지불합니다.

다음을 통해 공유