참고
Azure AI 검색 Azure 포털, REST API 및 Azure SDK 통해 사용할 수 있습니다. 또한 엔터프라이즈 콘텐츠를 Microsoft Foundry 포털의 에이전트에 대해 재사용 가능한 사용 권한 인식 기술 자료로 변환하는 관리되는 기술 계층인 Foundry IQ를 뒷받침합니다.
참고
일부 에이전트 검색 기능은 프로그래밍 방식 액세스를 통해 2026-04-01 REST API에서 일반적으로 사용할 수 있습니다. Azure 포털 및 Microsoft Foundry 포털은 모든 에이전트 검색 기능에 대한 미리 보기 전용 액세스를 계속 제공합니다. 일반적으로 사용할 수 있는 항목과 미리 보기로 남아 있는 항목에 대한 분석을 비롯한 마이그레이션 지침은 에이전트 검색 코드를 최신 버전으로 마이그레이션을 참조하세요.
미리 보기 REST API를 사용하도록 선택하는 경우 아직 일반 공급되지 않는 에이전트 검색 기능에 액세스할 수 있습니다. 미리 보기 기능은 서비스 수준 계약 없이 제공되며 프로덕션 워크로드에는 권장되지 않습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.
Important
이러한 기능과 기능은 2026-05-01-preview REST API의 일부입니다. 2026-05-01-preview는 Azure 구독의 일부로 사용자에게 라이선스가 부여되며, Microsoft Product Terms의 "미리 보기"에 적용되는 약관, Microsoft 제품 및 서비스 데이터 보호 부록("DPA") 및 Microsoft Azure 미리 보기용 추가 사용 약관의 적용을 받습니다.
2026-05-01-preview는 다른 Microsoft 서비스 및 타사 서비스에 대한 연결을 지원합니다. 이러한 서비스의 사용은 해당 약관의 적용을 받으며 Azure 규정 준수 경계 외부의 데이터 처리 또는 스토리지뿐만 아니라 Azure 규정 준수 경계로 데이터가 유입될 수 있습니다.
데이터가 조직의 규정 준수 및 지리적 경계와 관련된 의미를 벗어나는지 여부와 적절한 권한, 경계 및 승인이 프로비전되는지를 관리하는 것은 사용자의 책임입니다.
특정 사용 사례의 컨텍스트에서 빌드한 애플리케이션을 신중하게 검토하고 테스트하고 모든 적절한 결정 및 사용자 지정을 수행할 책임이 있습니다. 여기에는 메타프롬프트, 콘텐츠 필터 또는 기타 안전 시스템과 같은 책임 있는 AI 완화를 구현하고 애플리케이션이 적절한 품질, 안정성, 보안 및 신뢰성 표준을 충족하도록 보장하는 것이 포함됩니다. 자세한 내용은 Azure AI 검색 투명성 정보를 참고하세요.
기술 원본은 에이전트 검색 파이프라인에 사용되는 콘텐츠를 정의하는 Azure AI 검색 서비스의 최상위 리소스입니다. 각 지식 원본은 인덱싱되거나 원격이며, 콘텐츠 수집, 처리 및 쿼리 방법을 결정합니다. 지식 소스는 지식 기반의 필수 구성 요소입니다.
단일 기술 자료에서 여러 기술 자료를 참조할 수 있습니다. 에이전트 검색 엔진은 모든 쿼리를 단일 요청으로 쿼리합니다. 각 기술 원본에 대해 하위 쿼리가 생성되고 상위 결과가 검색 응답에 반환됩니다.
지원되는 기술 자료
Azure AI 검색 에이전트 검색 워크로드에 대해 다음 기술 자료를 지원합니다.
| 종류 | Description | 인덱싱 또는 원격 |
|---|---|---|
| 검색 인덱스 | 기존 인덱스를 감쌉니다. | 인덱싱된 |
| Azure Blob | Blob 컨테이너에서 인덱서 파이프라인을 생성합니다. | 인덱싱된 |
| Azure SQL(미리 보기) | Azure SQL 테이블 또는 뷰에서 인덱서 파이프라인을 생성합니다. | 인덱싱된 |
| 파일(미리 보기) | 파일을 Azure AI 검색 직접 업로드합니다. | 인덱싱된 |
| OneLake | 레이크하우스에서 인덱서 파이프라인을 생성합니다. | 인덱싱된 |
| 인덱싱된 SharePoint(미리 보기) | SharePoint 사이트에서 인덱서 파이프라인을 생성합니다. | 인덱싱된 |
| 원격 SharePoint(미리 보기) | SharePoint 콘텐츠를 검색합니다. | 원격 |
| Fabric 데이터 에이전트(미리 보기) | Microsoft Fabric 데이터 에이전트에서 답변 및 포함된 리소스를 검색합니다. | 원격 |
| Fabric 온톨로지(미리 보기) | Microsoft Fabric 온톨로지에서 엔터티 및 관계 기반 답변을 검색합니다. | 원격 |
| MCP 서버(미리 보기) | 외부 MCP 서버에서 도구 지원 라이브 결과를 검색합니다. | 원격 |
| Work IQ(미리 보기) | Work IQ에서 조직 인텔리전스를 검색합니다. | 원격 |
| 웹 | Microsoft Bing에서 실시간 그라운딩 데이터를 가져옵니다. | 원격 |
인덱싱된 기술 자료
인덱싱된 기술 원본은 에이전트 검색 조건을 충족하는 검색 인덱스를 가리킵니다. 콘텐츠는 세 가지 경로 중 하나를 통해 쿼리 시간 전에 인덱스에 수집됩니다.
사용자 지정 인덱스 사용: 검색 인덱스 지식 소스를 사용하여 검색 서비스에 있는 기존 인덱스를 래핑합니다.
직접 파일 업로드: 파일 기반 지식 원본을 사용하여 Azure AI 검색에 파일을 직접 업로드합니다. 서비스는 파일을 처리하고 외부 스토리지 또는 인덱서 파이프라인이 필요 없는 생성된 검색 인덱스로 추출된 콘텐츠를 저장합니다.
자동 생성된 인덱서 파이프라인: 다른 모든 인덱싱된 기술 원본의 경우 Azure AI 검색 외부 데이터 원본에서 전체 인덱서 파이프라인을 자동으로 만듭니다. 여기에는 데이터가 채워지고 청크로 분할된 데이터 원본, 기술 집합, 인덱서 및 인덱스가 포함됩니다.
쿼리는 키워드(전체 텍스트), 벡터 또는 하이브리드 쿼리를 사용하여 검색 서비스에서 로컬로 실행됩니다.
원격 지식 원본
원격 지식 원본은 외부 플랫폼에 직접 연결합니다. 콘텐츠는 Azure AI 검색에 절대 수집되지 않습니다. 대신 각 플랫폼의 네이티브 API를 통해 쿼리 시간에 검색됩니다. 에이전트 검색 엔진은 API 호출을 수행하고 동일한 응답에서 인덱싱된 모든 기술 원본과 함께 결과를 표시합니다.
플랫폼에 따라 원격 연결은 공용 인터넷(예: Bing) 또는 Microsoft 테넌트(예: SharePoint 및 Fabric) 내의 콘텐츠에 연결됩니다.
통합 순위
인덱싱된 및 원격 지식 원본 모두에 대해 검색된 모든 콘텐츠는 동일한 순위 파이프라인을 통해 흐릅니다. 결과는 관련성에 대해 점수가 매기되고, 쿼리 간에 병합되고, 검색 응답에서 반환되기 전에 다시 순위가 지정됩니다.
지식 소스 사용하기
기술 자료는 기술 자료와 별도로 만들고 관리하는 독립적인 개체입니다. 다음 사항을 고려하세요.
지식 베이스를 만들기 전에 지식 소스를 만드세요. 기술 자료는 ID별로 기술 원본을 참조하므로 먼저 기술 원본이 있어야 합니다.
기술 자료를 삭제하려면 먼저 이를 참조하는 기술 자료를 업데이트하거나 삭제합니다. 그런 다음, 기술 자료를 삭제할 수 있습니다.
기술 원본 및 해당 기술 자료는 동일한 검색 서비스에 있어야 합니다.
지식 원본 만들기
기술 자료를 만들려면 검색 서비스에 대한 Search Service 기여자 권한이 필요합니다. 기술 원본에서 인덱서 파이프라인을 생성하는 경우 인덱스를 로드하려면 인덱스 데이터 기여자 검색 권한도 필요합니다. 역할 할당 대신 관리자 API 키를 사용할 수 있습니다.
Azure 포털, Microsoft Foundry 포털, REST API 및 Azure SDK 만들기 지원은 지식 원본 종류에 따라 다릅니다. 종류별 지침은 지원되는 기술 자료의 링크를 참조하세요.
민감도 레이블 가져오기(미리 보기)
Blob, 인덱싱된 OneLake 및 인덱싱된 SharePoint 지식 원본의 경우 를 ingestionPermissionOptions 포함하도록 설정하여 sensitivityLabel을 수집할 수 있습니다. 이 값을 설정하기 전에 모든 필수 구성 요소를 따릅니다. 인덱스와 동기화된 후 레이블은 응답 검색에 표시되고 쿼리 시 문서 수준 액세스를 적용하는 데 사용됩니다. 자세한 내용은 쿼리 시 사용 권한 적용(미리 보기)을 참조하세요.
인덱싱된 기술 원본이 통합 벡터화 또는 사용자 지정 텍스트 분할 기술과 같은 청크 인덱스를 사용하는 경우 기술 세트의 인덱스 프로젝션을 통해 각 청크 행에 민감도 레이블을 매핑해야 합니다. 그렇지 않으면 소스 문서에 레이블이 있는 경우 검색 응답의 청크 수준 참조가 반환되지 않습니다.
문서에 포함된 이미지 표시(미리 보기)
Blob, 인덱싱된 OneLake 및 인덱싱된 SharePoint 지식 원본의 경우 원본 문서에 포함된 이미지를 지속적으로 저장하도록 지식 원본의 assetStore에서 ingestionParameters을 구성할 수 있습니다. 기술 자료에서 이미지 서비스도 사용하도록 설정하면 검색 작업은 LLM이 다이어그램, 차트 및 추출된 이미지 콘텐츠를 추론할 수 있도록 해당 이미지를 응답 합성 프롬프트에 삽입합니다. 자세한 내용은 에이전트형 검색에서 문서에 포함된 이미지 표시(미리 보기)를 참조하세요.
동일한 지식 소스에 assetStore 및 ingestionPermissionOptions을(를) 구성하지 마세요.
ingestionPermissionOptions이 구성된 경우 이미지 제공은 지원되지 않습니다.
지식 소스 사용
지식 소스를 만든 후 지식 베이스에서 이를 참조합니다. 지식 베이스는 조회할 지식 소스를 결정합니다. 다음 섹션에서는 포함되는 원본과 엔진에서 선택하는 방법을 제어하는 옵션에 대해 설명합니다.
항상 지식 원본 쿼리
지식 소스 정의에서 alwaysQuery를 true로 설정하면 검색 추론 수준과 관계없이 모든 쿼리에 포함됩니다.
검색 추론 노력을 사용하여 LLM 사용량 제어(미리 보기)
검색 추론 작업은 각 쿼리에 적용되는 LLM 처리 양을 제어합니다. 모든 솔루션이 LLM 쿼리 계획의 이점을 활용하는 것은 아닙니다. 단순성과 속도가 우선순위라면 LLM 처리를 우회하기 위해 minimal 방식을 사용하세요.
low 및 medium 수준에서는 LLM이 어떤 지식 소스를 질의할지 계획하고 선택하며, medium에서는 더 심층적인 결과를 위해 반복 단계를 추가합니다. 각 수준에 대한 자세한 내용은 검색 추론 작업 설정(미리 보기)을 참조하세요.
다음 요소는 low 및 medium 노력 수준에서의 선택에 영향을 미칩니다.
name의 지식 출처입니다.인덱싱된 지식 원본용 인덱스의
description.retrievalInstructions기술 자료 정의 또는 검색 작업에 지정된 항목입니다. LLM이 선택하거나 건너뛰는 정보 원본에 대한 검색 지침 가이드입니다. 프롬프트처럼 작동합니다: 간결성, 톤, 형식을 지정할 수 있습니다.