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

아티클
11/19/2024

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

다중 서비스 계정은 개별 서비스가 아닌 Azure AI 서비스 컬렉션을 제공합니다. Azure AI Search 기술 세트 에 계정을 제공하면 Microsoft에서 다음 서비스 사용에 대한 요금을 청구할 수 있습니다.

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

기술 세트의 Azure AI 다중 리소스에 대한 연결 정보를 제공해야 합니다. Azure AI Search는 기술 세트 워크로드에 연결을 사용하지 않지만 연결을 사용하여 리소스의 청구 미터에 액세스합니다. 따라서 Azure AI 서비스 계정은 기술 처리가 아닌 청구에 사용됩니다. Azure AI Search는 기술 처리를 위해 별도의 전용 리소스를 사용합니다.

연결에서 키를 사용하거나 현재 미리 보기로 제공되는 키 없는 접근 방식을 구현할 수 있습니다.

팁

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

필수 조건

검색 서비스가 Azure AI 다중 서비스 계정에 대한 프라이빗 연결에 대한 생성 날짜, 계층 및 지역 요구 사항을 충족하지 않는 한 퍼블릭 엔드포인트를 통한 연결

참고 항목

Azure AI 리소스가 프라이빗 엔드포인트를 사용하도록 구성된 경우 검색 서비스가 2024년 4월 3일 이후에 생성되고 더 높은 용량의 컴퓨팅 능력을 제공하고 지원되는 계층에 있는 경우 Azure AI Search에서 공유 프라이빗 링크를 사용하여 연결할 수 있습니다. 자세한 내용은 공유 프라이빗 링크를 사용하기 위한 요구 사항을 참조하세요.

키 없는 연결을 통해 청구

참고 항목

이 기능은 현재 공개 미리 보기로 제공됩니다. 이 미리 보기는 서비스 수준 계약 없이 제공되며 프로덕션 워크로드에는 사용하지 않는 것이 좋습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.

Azure Portal 또는 최신 미리 보기 REST API 및 베타 SDK 패키지를 사용하여 관리 ID 및 권한을 사용하여 Azure AI 다중 서비스 리소스를 연결할 수 있습니다. 이 방법의 장점은 청구가 키가 없고 지역에 대한 종속성이 없다는 것입니다.

관리 ID를 사용하도록 Azure AI Search를 구성합니다.
Azure AI 다중 서비스 리소스에서 Cognitive Services 사용자 역할에 ID를 할당합니다.
Azure Portal 또는 Skillset 2024-11-01-preview REST API 또는 구문을 제공하는 Azure SDK 베타 패키지를 사용하여 ID를 사용하도록 기술 집합을 구성합니다.
- 연결에 사용되는 관리 ID는 검색 서비스에 속합니다.
- ID는 시스템 관리 또는 사용자 할당일 수 있습니다.
- ID에는 Azure AI 리소스에 대한 Cognitive Services 사용자 권한이 있어야 합니다.
- @odata.type 는 항상 #Microsoft.Azure.Search.AIServicesByIdentity.입니다.
- subdomainUrl 는 Azure AI 다중 서비스 리소스의 엔드포인트입니다. Azure AI Search 및 Azure AI 서비스에서 공동으로 지원하는 모든 지역에 있을 수 있습니다.

키와 마찬가지로 Azure AI Services 리소스에 대해 제공하는 세부 정보는 연결이 아닌 청구에 사용됩니다. 기본 제공 기술 처리를 위해 Azure AI Search에서 Azure AI 서비스에 대한 모든 API 요청은 Microsoft에서 내부 및 관리됩니다.

예: 시스템 할당 관리 ID

ID가 null로 설정됩니다.

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 
    }  
}

예: 사용자 할당 관리 ID

ID는 사용자가 할당한 관리 ID의 리소스 ID로 설정됩니다. 기존 사용자 할당 관리 ID를 찾으려면 사용자 할당 관리 ID 관리를 참조 하세요.

사용자 할당 관리 ID의 경우 속성과 userAssignedIdentity 속성을 설정합니다@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}"" 
        }
    } 
}

리소스 키를 통해 청구

Azure AI Search는 Azure AI 다중 서비스 리소스 키를 사용하여 트랜잭션에 대한 요금을 청구할 수도 있습니다. 이 방법은 기본값이며 일반적으로 사용할 수 있습니다. Azure Portal, REST API 또는 Azure SDK를 사용하여 기술 세트에 키를 추가할 수 있습니다.

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

Azure Portal에 로그인합니다.
검색 서비스와 동일한 지역에 Azure AI 다중 서비스 리소스를 만듭니다.
리소스 키 및 엔드포인트 페이지에서 리소스>키를 가져옵니다.
기술 세트 정의에 키를 추가합니다.
- 데이터 가져오기 마법사를 사용하는 경우 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 Search는 내부적으로 프로비전된 Azure AI 다중 서비스 리소스를 사용하여 모든 기술 보강을 수행합니다.

참고 항목

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

공용 연결 요구 사항

검색 서비스가 만들어진 시기와 해당 계층 및 지역에 따라 기본 제공 기술에 대한 청구는 Azure AI Search에서 Azure AI 다중 서비스로의 공용 연결이 필요할 수 있습니다. 공용 네트워크 액세스를 사용하지 않도록 설정하면 일부 시나리오에서 청구가 중단됩니다. 공유 프라이빗 링크를 통해 연결에 대한 요구 사항을 검토하여 검색 서비스에 공용 연결이 필요한지 여부를 확인합니다.

공용 네트워크를 사용할 수 없는 경우 프라이빗 엔드포인트를 지원하는 Azure Function 으로 구현된 사용자 지정 Web API 기술을 구성하고 동일한 VNET에 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 정도를 지불합니다.

다음을 통해 공유

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

필수 조건

키 없는 연결을 통해 청구

예: 시스템 할당 관리 ID

예: 사용자 할당 관리 ID

리소스 키를 통해 청구

키 제거

키 사용 방법

공용 연결 요구 사항

주요 요구 사항 특수 사례

무료 보강

청구 가능한 보강

예제: 비용 추정

다음 단계

피드백

추가 리소스