메모
Foundry IQ (Azure AI 검색)는 관리형 검색을 위한 상위 수준의 지식 원본 및 지식 베이스 API와 함께 직접 인덱싱 및 쿼리 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.
knowledgeRetrieval 서비스 속성을 사용하여 에이전트형 검색에 대한 무료 또는 표준 청구 플랜을 선택합니다. 이 플랜은 Foundry IQ 서비스의 가격 책정 계층과는 별개입니다. 새 Foundry IQ 서비스에는 기본적으로 무료 요금제가 적용되며, 이 요금제에서는 에이전트형 검색 추론에 사용할 수 있는 월별 토큰 사용량 한도를 추가 비용 없이 제공합니다. 유료 검색을 이용하려면 표준 요금제로 전환합니다.
Search Service REST API 버전 2026-04-01부터 의미 체계 순위 및 에이전트 검색에 대한 청구 동의는 별개입니다.
knowledgeRetrieval를 사용하여 semanticSearch와 독립적으로 유료 에이전트 검색 사용량을 제어합니다.
필수 구성 요소
지원되는 지역에 있으며 지원되는 요금제 계층의 Foundry IQ 서비스(자세한 내용은 청구 요금제 참조).
Microsoft.Search/searchServices/write을 통해 Foundry IQ 서비스를 업데이트할 수 있는 권한 소유자 및 기여자와 같은 기본 제공 역할은 이 권한을 부여합니다. 자세한 내용은 역할 기반 접근 제어를 참조하세요.REST API 버전 2026-03-01-preview 이상의 검색 관리에서
knowledgeRetrieval속성을 설정합니다.
청구 분할
지원되는 Search Management REST API 버전을 사용하여 청구 동의를 설정합니다. 다음 표에서는 검색 요청(데이터 평면)의 Search Service REST API 버전에 따라 적용되는 속성을 보여 줍니다.
| Search Service REST API 버전 | 의미 체계 순위 대금 청구 | 에이전트 데이터 검색 청구 |
|---|---|---|
2026-04-01 및 이후 |
semanticSearch에 의해 제어됨 |
knowledgeRetrieval에 의해 제어됨 |
2025-11-01-preview 이전 버전 |
semanticSearch에 의해 제어됨 |
semanticSearch에 의해 제어됨 |
Search Service REST API 버전 2026-04-01 이상에서는 knowledgeRetrieval가 semanticSearch와 독립적으로 에이전트형 검색 청구를 제어합니다. 의미 체계 순위 청구를 제어하려면 의미 체계 랭커 청구 사용 또는 사용 안 함을 참조하세요.
Search Service REST API 버전 2025-11-01-preview 이하에서는 semanticSearch가 시맨틱 순위 지정기와 유료 에이전트형 검색 사용 모두에 대한 동의 여부를 제어합니다. 속성은 knowledgeRetrieval 무시됩니다.
청구 계획
이 속성은 knowledgeRetrieval 두 가지 청구 플랜인 free 및 standard을 지원합니다. 두 계획 모두 서비스의 가격 책정 계층을 변경하지 않습니다. 현재 요금 및 제공량은 Foundry IQ 가격 페이지를 참조하세요.
| 계획 | 설명 | Availability |
|---|---|---|
| 무료(기본값) | 매월 토큰 허용량을 무료로 제공합니다. 무료 허용량을 사용한 후 유료 사용량이 발생하는 요청은 HTTP 402(결제 필요) 오류를 반환합니다. | 지원되는 서비스 계층 및 지역에 따라 다릅니다. |
| 표준 | 월별 무료 수당이 소비된 후 종량제 가격 책정 | 지원되는 SKU가 필요합니다. |
에이전트 기반 검색 기능 청구 사용 가능
중요
이전에 semanticSearch에 의존하여 유료 agentic retrieval 사용을 활성화한 경우, agentic retrieval 워크로드를 Search Service REST API 버전 knowledgeRetrieval 이상으로 마이그레이션하기 전에 standard를 2026-04-01로 명시적으로 설정해야 합니다.
다음 단계에 따라 에이전트 검색을 표준 청구 계획으로 전환합니다.
Azure 포털에서 Foundry IQ 서비스로 이동합니다.
개요 페이지에서 가격 책정 계층이 기본 이상인지 확인합니다.
왼쪽 창에서 설정>프리미엄 기능을 선택합니다.
기술 자료 검색에서 표준 카드에서 계획 선택을 선택합니다.
에이전트 기반 검색 청구 사용 안 함
에이전트 검색을 무료 청구 플랜으로 다시 전환하려면 다음 단계를 수행합니다. 무료 플랜은 agentic retrieval 추론에만 적용됩니다.
Azure 포털에서 Foundry IQ 서비스로 이동합니다.
왼쪽 창에서 설정>프리미엄 기능을 선택합니다.
지식 검색에서 무료 카드에서 계획 선택을 선택합니다.