참고
Foundry IQ (Azure AI 검색)는 관리 검색을 위해 고급 수준의 지식 원본 API 및 지식 베이스 API와 함께 직접 인덱싱 및 쿼리 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.
Important
이 문서에서 (미리 보기)로 표시된 기능 또는 성능은 공개 미리 보기로 제공되며 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.
Foundry IQ(Azure AI 검색)와 관련된 미리 보기 용어는 미리 보기 기능을 참조하세요.
지식 원본은 에이전트 검색 파이프라인에 사용되는 콘텐츠를 정의하는 foundry IQ(Azure AI 검색) 서비스의 최상위 리소스입니다. 각 지식 원본은 인덱싱되거나 원격이며, 콘텐츠 수집, 처리 및 쿼리 방법을 결정합니다. 지식 소스는 지식 기반의 필수 구성 요소입니다.
기술 자료에서 여러 기술 자료를 참조합니다. 일반 minimal 검색은 모든 후보 원본을 쿼리하지만, 작업에서는 lowmedium 하위 집합을 선택할 수 있습니다. 응답은 조회한 소스의 가장 관련성이 큰 결과를 결합합니다.
구성된 원본의 수와 검색 중에 선택한 수는 별도의 제한입니다.
지원되는 기술 자료
Foundry IQ는 에이전트형 검색 워크로드에 대해 다음 지식 소스를 지원합니다.
| 종류 | Description | 인덱싱 또는 원격 |
|---|---|---|
| 검색 인덱스 | 기존 인덱스를 감쌉니다. | 인덱싱된 |
| Azure 블롭 | Blob 컨테이너에서 인덱서 파이프라인을 생성합니다. | 인덱싱된 |
| Azure SQL | Azure SQL 테이블 또는 뷰에서 인덱서 파이프라인을 생성합니다. | 인덱싱된 |
| 파일 | Foundry IQ에 직접 파일을 업로드합니다. | 인덱싱된 |
| OneLake | 레이크하우스에서 인덱서 파이프라인을 생성합니다. | 인덱싱된 |
| 인덱싱된 SharePoint | SharePoint 사이트에서 인덱서 파이프라인을 생성합니다. | 인덱싱된 |
| 원격 SharePoint (미리 보기) | SharePoint 콘텐츠를 검색합니다. | 원격 |
| Fabric 데이터 에이전트(미리 보기) | Microsoft Fabric 데이터 에이전트에서 답변 및 포함된 리소스를 검색합니다. | 원격 |
| Fabric 온톨로지 (미리 보기) | Microsoft Fabric 온톨로지에서 엔터티 및 관계 기반 답변을 검색합니다. | 원격 |
| MCP 서버(미리 보기) | 외부 MCP 서버에서 도구 지원 라이브 결과를 검색합니다. | 원격 |
| Work IQ(미리 보기) | Work IQ에서 조직 인텔리전스를 검색합니다. | 원격 |
| 웹 | Microsoft Bing에서 실시간 그라운딩 데이터를 가져옵니다. | 원격 |
인덱싱된 기술 자료
인덱싱된 기술 원본은 에이전트 검색 조건을 충족하는 검색 인덱스를 가리킵니다. 콘텐츠는 세 가지 경로 중 하나를 통해 쿼리 시간 전에 인덱스에 수집됩니다.
사용자 고유의 인덱스 가져오기: 검색 인덱스 지식 원본을 사용하여 Foundry IQ 서비스에서 기존 인덱스 래핑
직접 파일 업로드: 파일 지식 원본을 사용하여 Foundry IQ에 직접 파일을 업로드합니다. 서비스는 파일을 처리하고 외부 스토리지 또는 인덱서 파이프라인이 필요 없는 생성된 검색 인덱스로 추출된 콘텐츠를 저장합니다.
자동 생성된 인덱서 파이프라인: Blob, OneLake 및 인덱싱된 SharePoint 기술 원본의 경우 Foundry IQ는 외부 데이터 원본에서 전체 인덱서 파이프라인을 자동으로 만듭니다. 파이프라인에는 채워지고 청크된 데이터 원본, 기술 세트, 인덱서 및 인덱 스가 포함됩니다. Azure SQL의 경우 각 행은 논리적 문서가 되고, 서비스는
embeddingColumns를 구성할 때만 기술 집합을 만듭니다.
2026-11-01-preview에서 토픽 그래프를 사용하여 기존 searchIndex 지식 원본에 대한 벡터 검색을 보강합니다. 검색된 벡터 필드의 토픽 그래프 프로필을 통해 준비되고 채워진 호환되는 토픽 인덱스를 바인딩합니다.
생성된 인덱서의 경우 소스 변경 폴링 및 완료되지 않은 수집의 자동 계속은 별개입니다. 직접 파일 업로드는 인덱서 폴링 일정을 사용하지 않습니다.
쿼리는 전체 텍스트(키워드), 벡터 또는 하이브리드 쿼리를 사용하여 Foundry IQ 서비스에서 로컬로 실행됩니다.
인덱싱된 지식 원본에는 기반 검색 인덱스가 있으므로 인덱스의 문서로 연결되는 서비스 생성 인용 URL이 참조에 포함될 수 있습니다. 원격 지식 원본에는 지원 인덱스가 없으므로 인용 URL을 반환하지 않습니다.
원격 지식 원본
원격 지식 원본은 외부 플랫폼에 직접 연결합니다. 콘텐츠는 Foundry IQ에 수집되지 않습니다. 대신 각 플랫폼의 네이티브 API를 통해 쿼리 시간에 검색됩니다. 에이전트 검색 엔진은 API 호출을 수행하고 동일한 응답에서 인덱싱된 모든 기술 원본과 함께 결과를 표시합니다.
플랫폼에 따라 원격 연결은 공용 인터넷(예: Bing) 또는 Microsoft 테넌트(예: SharePoint 및 Fabric) 내의 콘텐츠에 연결됩니다.
SharePoint 아키텍처 선택 사항
구성할 사이트 또는 파이프라인 수를 결정하기 전에 콘텐츠가 애플리케이션에 도달하는 방법을 선택합니다.
| Approach | 다음과 같은 경우 선택하세요 | 소유권 및 권한 |
|---|---|---|
| 인덱싱된 SharePoint 지식 원본 | 선택한 SharePoint 콘텐츠의 검색 가능한 복사본을 만드는 관리되는 수집 경로를 원합니다. | 소스 선택 및 contentExtractionMode는 knowledge-source API를 통해 구성합니다. 지원되는 문서 권한 흐름을 별도로 사용하도록 설정하세요. 수집 액세스가 최종 사용자에게 인덱싱된 모든 항목에 대한 액세스 권한을 부여하는 것은 아닙니다. |
| SharePoint 인덱서 및 검색 인덱스 지식 원본 | 인덱스 스키마, 인덱싱 일정 또는 증강 파이프라인을 제어해야 합니다. | 인덱싱 리소스를 구성하고 유지 관리한 다음, 채워진 인덱스를 기술 자료에 연결합니다. 파생된 청크에도 필요한 권한 필드와 원본 사이트 컨텍스트를 유지합니다. |
| 원격 SharePoint 지식 원본(미리 보기) | Foundry IQ에서 SharePoint 콘텐츠 인덱스 없이 Microsoft 365를 통한 검색을 하려고 합니다. | 검색은 Copilot 검색 API 및 사용자의 SharePoint 권한을 사용합니다. 원격 원본의 라이선스, 필터링 및 콘텐츠 제한 사항을 확인합니다. |
| 사용자 지정 수집 및 검색 인덱스 지식 원본 | 수집 또는 변환 요구 사항은 기본 제공 경로로는 충족되지 않습니다. | 애플리케이션은 추출, 변경 및 삭제 처리 및 권한 동기화를 담당합니다. 콘텐츠를 업로드해도 SharePoint 권한이 자동으로 유지되지 않으므로 지원되는 문서 권한 흐름을 구현하세요. |
인덱스 스키마 및 관리 요구 사항을 공유하는 콘텐츠에는 하나의 인덱스 파이프라인을 사용합니다. 콘텐츠에 독립적인 스키마, 처리 또는 거버넌스가 필요한 경우 별도의 파이프라인과 인덱스를 사용합니다. 공유 인덱스에는 사용자가 서로 다른 액세스 권한이 있는 경우에도 문서 수준 권한이 필요합니다.
인덱싱된 콘텐츠는 모든 원본 항목을 실시간으로 확인하는 것이 아니라, 완료된 수집 및 권한 동기화를 반영합니다. SharePoint 권한 동기화를 검토하세요. 사이트 범위가 더 큰 경우에는 사이트 수가 모든 사용 권한 구성에 동일하게 적용된다고 가정하지 말고 SharePoint 그룹 사용 권한 토폴로지 지침을 따르세요.
인덱싱된 SharePoint는 REST API 2026-10-01에서 사용할 수 있습니다. 원격 SharePoint는 계속 미리 보기 상태입니다. 인덱싱된 원본과 원격 원본을 결합하는 기술 자료는 참조된 모든 소스 종류를 지원하는 API 버전을 사용해야 합니다. 10월 stable API가 원격 SharePoint를 지원한다고 가정하지 마세요.
관리형 인덱스 수집의 경우 standard에서 또는 minimal 콘텐츠 추출을 선택합니다. 직접 구성된 보강 파이프라인의 경우 다중 모드 추출 옵션을 비교하세요. 추출 기능은 원본 자산 및 처리 경로에 따라 달라집니다. 파일, 목록 항목 및 최신 페이지에는 서로 다른 콘텐츠 표현 형식이 있습니다.
통합 순위
인덱싱된 및 원격 지식 원본 모두에 대해 검색된 모든 콘텐츠는 동일한 순위 파이프라인을 통해 흐릅니다. 결과는 관련성에 대해 점수가 매기되고, 쿼리 간에 병합되고, 검색 응답에서 반환되기 전에 다시 순위가 지정됩니다.
지식 소스 사용하기
기술 자료는 기술 자료와 별도로 만들고 관리하는 독립적인 개체입니다. 다음 사항을 고려하세요.
지식 베이스를 만들기 전에 지식 소스를 만드세요. 기술 자료는 ID별로 기술 원본을 참조하므로 먼저 기술 원본이 있어야 합니다.
기술 자료를 삭제하려면 먼저 이를 참조하는 기술 자료를 업데이트하거나 삭제합니다. 그런 다음, 기술 자료를 삭제할 수 있습니다.
지식 소스 및 해당 지식 기반은 동일한 Foundry IQ 서비스에 있어야 합니다.
GET 및 LIST 응답은 비밀을 마스킹하거나 생략할 수 있습니다. 유효한 대상 인증 및 종속성을 사용하여 리소스를 다시 만들려면 안전한 백업, 복원 및 복제를 수행합니다.
지식 원본 만들기
Azure 포털, Microsoft Foundry 포털, REST API 및 Azure SDK 만들기 지원은 지식 원본 종류에 따라 다릅니다. 종류별 지침은 지원되는 기술 자료의 링크를 참조하세요.
민감도 레이블 가져오기(미리 보기)
Blob, 인덱싱된 OneLake 및 인덱싱된 SharePoint 지식 원본의 경우 를 ingestionPermissionOptions 포함하도록 설정하여 sensitivityLabel을 수집할 수 있습니다. 이 값을 설정하기 전에 모든 필수 구성 요소를 따릅니다. 인덱스와 동기화된 후 레이블은 응답 검색에 표시되고 쿼리 시 문서 수준 액세스를 적용하는 데 사용됩니다. 자세한 내용은 쿼리 시 사용 권한 적용(미리 보기)을 참조하세요.
인덱싱된 기술 원본이 통합 벡터화 또는 사용자 지정 텍스트 분할 기술과 같은 청크 인덱스를 사용하는 경우 기술 세트의 인덱스 프로젝션을 통해 각 청크 행에 민감도 레이블을 매핑해야 합니다. 그렇지 않으면 소스 문서에 레이블이 있는 경우 검색 응답의 청크 수준 참조가 반환되지 않습니다.
문서에 포함된 이미지 표시(미리 보기)
Blob, 인덱싱된 OneLake 및 인덱싱된 SharePoint 지식 원본의 경우 원본 문서에 포함된 이미지를 지속적으로 저장하도록 지식 원본의 assetStore에서 ingestionParameters을 구성할 수 있습니다. 기술 자료에서 이미지 서비스도 사용하도록 설정하면 검색 작업은 LLM이 다이어그램, 차트 및 추출된 이미지 콘텐츠를 추론할 수 있도록 해당 이미지를 응답 합성 프롬프트에 삽입합니다. 자세한 내용은 에이전트형 검색에서 문서에 포함된 이미지 표시(미리 보기)를 참조하세요.
동일한 지식 소스에 assetStore 및 ingestionPermissionOptions을(를) 구성하지 마세요.
ingestionPermissionOptions이 구성된 경우 이미지 제공은 지원되지 않습니다.
프라이빗 네트워크로 수집 제한
프라이빗 수집은 일반적으로 REST API 에서 적격 Dedicated 서비스의 2026-10-01, 인덱싱된 Azure SQL 및 인덱싱된 OneLake 지식 원본에 대해 사용할 수 있습니다. 승인된 공유 프라이빗 링크는 적격 원본 연결 및 Azure 종속성을 보호할 수 있습니다. 각 경로 및 별도의 미리 보기 요구 사항에 대해 구성 및 계층 요구 사항을 따르세요.
서버리스는 프라이빗 인덱서 실행 또는 아웃바운드 검색 공유 프라이빗 링크를 지원하지 않습니다. 지원되는 퍼블릭 엔드포인트 액세스 제어에 네트워크 보안 경계 구성 을 사용합니다. 경계는 프라이빗 연결을 만들거나 비공개 실행을 사용하도록 설정하지 않습니다.
SharePoint Online은 공유 프라이빗 링크 대상이 아니므로 원본 연결은 공용으로 유지됩니다.
networkAccessMode는 생성 시에만 가능합니다. 적합한 Blob, ADLS Gen2 및 SQL 원본의 경우 중간 인덱서 재정의 및 해당 제한 사항에 대한 지식 원본 생성 후 네트워킹 변경을 참조하세요.
언어별 자동 분석기 사용(미리 보기)
Blob, 인덱싱된 OneLake 및 인덱싱된 SharePoint 기술 자료는 다국어 콘텐츠에 대한 언어별 자동 분석기를 지원합니다. 사용하도록 설정하면 Foundry IQ는 각 원본 문서의 언어를 검색하고 일치하는 Microsoft 언어 분석기를 자동으로 적용합니다. 기술 자료 정의 또는 쿼리에서 분석기를 지정하지 않습니다.
ingestionParameters.aiServices 콘텐츠 추출 및 minimal을 사용하여 이 미리 보기 기능을 사용하도록 설정합니다. 연결된 커넥터 지침은 공유 설정, 지원되는 언어, 대체 동작, 청구 및 확인 단계를 제공합니다. 이 관리형 옵션은 직접 구성하는 인덱스의 필드에 언어 분석기를 할당하는 것과 다릅니다.
지식 소스 사용
지식 소스를 만든 후 지식 베이스에서 이를 참조합니다. 지식 베이스는 조회할 지식 소스를 결정합니다. 다음 섹션에서는 포함되는 원본과 엔진에서 선택하는 방법을 제어하는 옵션에 대해 설명합니다.
항상 지식 원본 쿼리
retrieve 요청의 소스 alwaysQuerySource 항목에서 true을(를) knowledgeSourceParams(으)로 설정합니다. 이 요청 수준 설정은 2026-10-01에서 지원되며, 지식 소스에 저장된 속성은 아닙니다. 요청 동작 및 소스 선택 제어에 대해서는 GA REST API로 검색하기를 참조하세요.
저장 및 요청 설정
세 가지 구성 화면은 별개입니다.
| Surface | Examples |
|---|---|
| 저장된 지식 소스 |
searchIndexParameters.baseFilter; webParameters.language, market, count및 freshness. 기존 검색 인덱스 설정에는 searchIndexName, sourceDataFields, searchFields, 및 semanticConfigurationName. |
| KB 구성원 자격 | 각 knowledgeSources 항목에는 name만 포함됩니다. |
| 요청 가져오기 |
knowledgeSourceParams 항목은 alwaysQuerySource, failOnError과 일치, knowledgeSourceName, rerankerThreshold, 참조 컨트롤, maxOutputDocuments, kind와 같은 옵션을 지정합니다. |
요청 filterAddOn은 AND를 사용하여 비어 있지 않은 저장된 baseFilter와 결합됩니다. 요청 웹 옵션은 저장된 웹 값을 재정의합니다.
매개변수 검색을 참조하세요.
파일 수집 옵션 및 버전 지원은 파일 지원 및 제한을 참조하세요.
검색 추론 수준을 사용하여 LLM 사용량을 제어하세요
검색 추론 노력은 쿼리 계획을 제어합니다. 일반 minimal 검색은 모델 기반 계획을 건너뜁니다.
2026-11-01-preview에서는 Microsoft Retriever 1로 구성된 기술 자료가 전체 질문을 포함하는 의미 체계 의도를 정확히 하나만 사용하여 Minimal 계획에 이를 사용할 수 있습니다. 여러 시맨틱 의도가 있는 경우 Minimal은 Microsoft Retriever 1 계획을 건너뛰고 각 의도에 대한 일반적인 Minimal 결과를 병합합니다. Microsoft Retriever 1만 있는 지식 베이스는 외부 응답 합성이 아닌 추출 출력을 지원합니다.
medium 및 low에서는 LLM이 쿼리를 계획하고 소스를 선택하며, medium 더 심층적인 검색을 수행합니다.
검색 추론 수준 설정을 참조하세요.
다음 요소는 low 및 medium 노력 수준에서의 선택에 영향을 미칩니다.
name의 지식 출처입니다.인덱싱된 지식 원본용 인덱스의
description.retrievalInstructions기술 자료 정의 또는 검색 작업에 지정된 항목입니다. LLM이 선택하거나 건너뛰는 정보 원본에 대한 검색 지침 가이드입니다. 프롬프트처럼 작동합니다: 간결성, 톤, 형식을 지정할 수 있습니다.