참고
Foundry IQ (Azure AI 검색)는 관리형 검색을 위한 상위 수준의 지식 원본 및 지식 베이스 API와 함께 직접 인덱싱 및 쿼리 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.
Important
이 문서에서 (미리 보기)로 표시된 기능 또는 성능은 공개 미리 보기로 제공되며 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.
Foundry IQ(Azure AI 검색)와 관련된 미리 보기 용어는 미리 보기 기능을 참조하세요.
Azure AI 검색(Foundry IQ)의 AI 보강을 위한 일부 기본 제공 기술에는 하루에 인덱스당 최대 20개의 트랜잭션이 무료로 허용됩니다. 각 기술의 요구 사항을 확인하고 필요한 경우 청구 가능한 Microsoft Foundry 리소스를 기술 세트에 연결합니다.
Foundry 리소스는 Foundry 도구 내의 여러 서비스에 대한 액세스를 제공합니다. 기술 세트에 지정하면 Microsoft 다음 서비스 사용에 대한 요금을 청구할 수 있습니다.
- Azure 이미지 분석, OCR(광학 문자 인식) 및 멀티모달 포함을 위한 Foundry 도구의 비전입니다.
- 언어 감지, 엔터티 인식, 감정 분석 및 핵심 구 추출을 위한 Foundry Tools의 Azure 언어.
- Foundry 도구의 Azure Translator는 기계 텍스트 번역을 위해 사용됩니다.
기술 세트 처리는 각 기술의 기본 서비스에 청구됩니다. Foundry IQ는 Foundry 도구에 대한 요금을 단일 Foundry 리소스로 통합합니다. 예를 들어 Image Analysis 및 Language Detection 기술을 사용하는 경우 Azure Vision 및 Azure 언어에 대한 요금은 Foundry 리소스에 대해 동일한 청구서에 표시됩니다. 다른 모든 리소스는 독립적으로 청구됩니다.
Foundry 리소스를 연결하려면 연결 정보를 스킬셋에 입력하십시오. 키 기반 또는 키 없는 방법을 사용할 수 있습니다.
필수 구성 요소
Foundry IQ 서비스가 Foundry 리소스에 대한 프라이빗 연결 에 대한 생성 날짜, 계층 및 지역 요구 사항을 충족하지 않는 한 퍼블릭 엔드포인트를 통한 연결
API 종류가 포함된
AIServices. Azure 포털의 리소스 Overview 페이지에서 API 종류를 확인할 수 있습니다.
참고
Foundry 리소스가 프라이빗 엔드포인트를 사용하도록 구성된 경우 Foundry IQ는 공유 프라이빗 링크를 사용하여 연결할 수 있습니다. 자세한 내용은 공유 프라이빗 링크 리소스 제한을 참조하세요. 또는 Foundry IQ 서비스와 Foundry 리소스를 동일한 네트워크 보안 경계 에 배치하여 개인 채널에서 Foundry 리소스에 대한 아웃바운드 호출을 유지합니다.
2025-11-01-preview부터 스킬셋은
AIServicesAPI 종류를 지원합니다. 이전CognitiveServices및 클래식 Azure AI 다중 서비스 계정은 계속 작동하지만 새로운 기술 세트의 경우AIServices및 Foundry 리소스를 사용하는 것이 좋습니다.
키 없는 연결을 통해 청구
관리 ID 및 권한을 사용하여 Foundry 리소스를 연결할 수 있습니다. 이 접근 방식의 장점은 청구할 때 키가 필요 없고 지역에 제한이 없다는 것입니다.
키 없는 연결을 통해 청구하려면 다음을 수행합니다.
Foundry IQ 서비스에서 관리형 ID를 구성합니다. 시스템 할당 ID와 사용자 할당 ID가 모두 지원됩니다.
Foundry 리소스에서 Foundry IQ 서비스의 관리 ID에 Cognitive Services 사용자 역할을 할당합니다.
관리 ID를 사용하도록 기술 세트를 구성합니다. Azure 포털, 안정적인 최신 버전의 Skillsets - 만들기 또는 업데이트(REST API) 또는 구문을 제공하는 Azure SDK 패키지를 사용할 수 있습니다.
@odata.type는 항상#Microsoft.Azure.Search.AIServicesByIdentity.subdomainUrl는 Foundry 리소스의 엔드포인트입니다.https://<resource-name>.services.ai.azure.com또는https://<resource-name>.cognitiveservices.azure.com형식을 사용할 수 있으며, 둘 다 Azure 포털의 Keys 및 엔드포인트 페이지에서 사용할 수 있습니다.다른 속성은 다음 REST API 예제와 같이 관리 ID 유형에 따라 다릅니다.
시스템 할당 관리 ID에 대한 샘플 기술 세트 구성은 다음과 같습니다. 이 시나리오에서는
identity을(를)null로 설정해야 합니다.POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-10-01 api-key: [admin-key] Content-Type: application/json { "name": "my-skillset", "skills": [ // Skills definition goes here ], "cognitiveServices": { "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity", "description": "A sample configuration for a system-assigned managed identity.", "subdomainUrl": "https://[resource-name].services.ai.azure.com", "identity": null } }
리소스 키를 통해 청구
기본적으로 Foundry IQ는 Foundry 리소스의 키를 사용하여 트랜잭션에 대한 요금을 청구합니다. 이 방법은 일반적으로 사용할 수 있습니다. Azure 포털, 안정적인 REST API 버전 또는 동등한 Azure SDK 사용하여 기술 세트에 키를 추가할 수 있습니다.
지원되는 두 가지 키 유형은 다음과 같습니다.
-
#Microsoft.Azure.Search.CognitiveServicesByKey지역 엔드포인트를 호출합니다. -
#Microsoft.Azure.Search.AIServicesByKey하위 도메인을 호출합니다. 공유 프라이빗 링크를 지원하고 Foundry IQ 서비스와 관련된 지역 요구 사항이 없으므로 이 유형을 사용하는 것이 좋습니다.
Foundry 리소스는 Foundry IQ 서비스와 동일한 지역에 있어야 합니다. Foundry 도구 통합을 제공하는 Foundry IQ 지역을 선택합니다. 해당 여부는 AI 보강 열에 표시됩니다. 동일한 지역 요구 사항에 대한 자세한 내용은 키를 사용하는 방법을 참조하세요.
속성을 지정 cognitiveServices 하지 않으면 Foundry IQ 서비스는 매일 인덱서에서 사용할 수 있는 무료 보강을 사용하려고 시도합니다. 청구 가능한 기술의 실행은 인덱서 호출당 20개의 트랜잭션에서 중지되고 인덱서 실행 기록에 "시간 초과" 메시지가 표시됩니다.
Azure 포털 로그인합니다.
Foundry IQ 서비스와 동일한 지역에 Foundry 리소스를 만듭니다.
왼쪽 창에서 리소스 관리>키 및 엔드포인트를 선택합니다.
키 중 하나를 복사합니다.
기술 세트 정의에 키를 추가합니다.
데이터 가져오기 마법사를 사용하는 경우 Foundry 리소스를 선택합니다. 마법사는 기술 세트 정의에 리소스 키를 추가합니다.
새 기술 세트 또는 기존 기술 세트의 경우 기술 세트 정의의 키를 제공합니다.
참고
포털은 #Microsoft.Azure.Search.CognitiveServicesByKey 형식의 키를 자동으로 연결합니다.
키 제거
보강은 청구 가능한 작업입니다. Foundry 도구를 더 이상 호출할 필요가 없는 경우 다음 지침에 따라 키를 제거하고 Foundry 리소스를 사용하지 않도록 합니다.
키가 없으면 기술 세트는 하루에 인덱서당 20개의 무료 트랜잭션을 기본 할당으로 되돌립니다. 청구 가능한 기술의 실행은 20개 트랜잭션에서 중지되고 할당이 사용될 때 인덱서 실행 기록에 "시간 초과" 메시지가 표시됩니다.
Azure 포털에서 Foundry IQ 서비스로 이동합니다.
검색 관리 > 기술 세트의 목록에서 기술 세트를 선택합니다.
파일의
"cognitiveServices"섹션으로 스크롤합니다.JSON에서 키 값을 삭제합니다.
기술 세트를 저장합니다.
키 사용 방법
무료 허용을 사용하는 기술의 경우 Foundry 리소스에 대한 API 호출이 하루에 인덱서당 20개 API 호출을 초과하면 청구가 시작됩니다. 인덱서 다시 설정하여 API 수를 다시 설정할 수 있습니다.
Foundry IQ의 내부적으로 프로비전된 리소스에서 보강 작업이 실행되는 기술의 경우, 연결된 Foundry 리소스에 대한 키 없는 키 기반 연결은 보강 처리가 아닌 청구를 처리합니다. Azure Content Understanding 기술은 연결된 Foundry 리소스를 처리 및 청구에 사용합니다. 지원되는 지역 및 Foundry 리소스에 대한 연결 요구 사항을 검토합니다.
키 기반 청구 전용 연결의 경우 Foundry IQ 서비스는 내부 네트워크를 통해동일한 물리적 지역에 있는 Foundry 리소스에 연결합니다. Foundry IQ를 제공하는 대부분의 지역에서는 다른 Azure 서비스도 제공합니다. 두 서비스가 모두 없는 지역에서 AI 보강을 시도하는 경우 다음 메시지가 표시됩니다. "제공된 키는 Foundry IQ 서비스의 지역에 대한 유효한 CognitiveServices 유형 키가 아닙니다."
키 없는 연결의 경우 Foundry IQ 서비스는 ID 및 역할 할당을 사용하여 인증하고 Foundry 리소스를 대상으로 합니다. 리소스는 정규화된 URI로 지정되고 URI에는 고유한 하위 도메인이 포함됩니다.
자체 Foundry IQ 서비스의 검색 노드만 사용하는 전용 처리 작업을 위해 인덱서가 프라이빗 실행 환경에서 실행되도록 구성할 수 있습니다. 이 설정은 모든 기술 처리가 검색 노드에서 실행되도록 하지는 않습니다. 일부 기술은 Foundry IQ의 내부적으로 프로비전된 리소스를 사용하는 반면, Azure Content Understanding, Azure OpenAI Embedding, 및 GenAI Prompt와 같은 기술은 고객이 구성한 리소스 또는 모델 엔드포인트를 호출합니다.
참고
텍스트 번역 기술과 같은 일부 기본 제공 기술은 비지역 파운드리 도구 서비스를 기반으로 합니다. 비지역 스킬을 사용하는 경우 요청이 Foundry IQ 지역과 다른 지역에서 서비스될 수 있습니다. 비지역 서비스에 대한 자세한 내용은 지역별 제품 가용성 페이지를 참조하세요.
공용 연결 요구 사항
Foundry IQ 서비스가 만들어진 시기, 가격 책정 계층 및 해당 지역에 따라 기본 제공 기술에 대한 청구에는 Foundry IQ에서 Foundry 리소스로의 공용 연결이 필요할 수 있습니다. 공용 네트워크 액세스를 사용하지 않도록 설정하면 일부 시나리오에서 청구가 중단됩니다. 공유 프라이빗 링크를 통해 연결 요구 사항을 검토하여 Foundry IQ 서비스에 공용 연결이 필요한지 여부를 확인합니다.
공용 네트워크를 사용할 수 없는 경우 Azure 함수로 구현된 Custom Web API 기술을 구성하고, 프라이빗 엔드포인트를 지원하며 Foundry 리소스를 동일한 VNET에 추가할 수 있습니다. 이 시나리오에서는 프라이빗 엔드포인트를 사용하여 사용자 지정 기술에서 직접 Foundry 리소스를 호출할 수 있습니다.
주요 요구 사항 특수 사례
사용자 지정 엔터티 조회 는 Foundry IQ를 통해 측정되지만, 하루에 인덱서당 20개 이상의 트랜잭션을 잠금 해제하려면 Foundry 리소스 키가 필요합니다. 이 기술에 대해서만 리소스 키는 트랜잭션 수를 차단 해제하지만 청구와는 관련이 없습니다.
무료 보강
AI 보강은 외부 리소스를 연결하지 않고도 짧은 연습을 완료할 수 있도록 청구 가능한 보강을 소량 무료로 처리할 수 있습니다. 무료 보강은 하루에 인덱서당 20개의 문서입니다. 연습을 반복하려는 경우 인덱서 로 다시 설정하여 카운터를 다시 설정할 수 있습니다.
일부 보강은 항상 무료입니다.
Foundry 도구를 호출하지 않는 유틸리티 기술(즉, 조건부, 문서 추출, 쉐이퍼, 텍스트 병합 및 텍스트 분할 기술)은 청구할 수 없습니다.
PDF 문서 및 기타 응용 프로그램 파일에서 텍스트 추출은 청구되지 않습니다. 문서 크래킹 중에 발생하는 텍스트 추출은 AI 보강이 아니라 AI 보강 중에 발생하므로 여기에 설명되어 있습니다.
청구 가능한 보강
AI 보강 중에 Foundry IQ는 Azure Vision, Azure Language 및 Azure Translator 기반으로 하는 기본 제공 기술에 대해 API를 호출합니다.
외부 서비스에 대한 백 엔드 호출을 만드는 청구 가능한 기본 제공 기술은 다음과 같습니다.
Azure Vision 멀티모달 임베딩 모델로 지원되는 쿼리 시간 벡터라이저도 청구 가능한 강화 기능입니다.
이미지 추출은 보강 처리 전에 문서를 크래킹할 때 발생하는 Foundry IQ 작업입니다. 이미지 추출은 무료 계층에서 20개의 무료 일일 추출을 제외하고 모든 가격 책정 계층에서 청구할 수 있습니다. 이미지 추출 비용은 Blob 내의 이미지 파일, 다른 파일(PDF 및 기타 앱 파일)에 포함된 이미지 및 문서 추출을 사용하여 추출된 이미지에 적용됩니다. 이미지 추출 가격 책정에 대해서는 Foundry IQ 가격 책정 페이지를 참조하세요.
팁
기술 세트 처리 비용을 낮추려면 증분 보강(미리 보기) 을 사용하여 기술 세트의 변경 내용에 영향을 받지 않는 모든 보강을 캐시하고 다시 사용할 수 있습니다. 캐싱에는 Azure Storage( 참조)가 필요하지만, 특히 이미지 추출 및 분석을 사용하는 기술 세트의 경우 기존 보강을 다시 사용할 수 있는 경우 기술 세트 실행의 누적 비용이 더 낮습니다.
예: 비용 예측
이 섹션에 표시된 가격은 가상이며 예측 프로세스를 설명하는 데 사용됩니다. 비용은 더 낮을 수 있습니다. 실제 트랜잭션 가격은 Foundry Tools 가격 책정을 참조하세요.
Foundry IQ 인덱싱과 관련된 비용을 추정하려면, 먼저 평균적인 문서가 어떤 형태인지 파악하여 대략 계산해 볼 수 있어야 합니다. 예를 들어 근사치를 구할 수 있습니다.
- PDF 1,000개
- 각 6페이지
- 페이지당 이미지 1개(이미지 6,000개)
- 페이지당 3,000자
각 PDF의 문서 크래킹, 이미지 및 텍스트 추출, 이미지의 OCR 및 조직의 엔터티 인식으로 구성된 파이프라인을 가정합니다.
텍스트 및 이미지 콘텐츠가 포함된 문서 크래킹의 경우 현재 텍스트 추출이 무료입니다. 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를 지불하게 됩니다.