참고
일부 에이전트 검색 기능은 프로그래밍 방식 액세스를 통해 2026-04-01 REST API 버전에서 일반적으로 사용할 수 있습니다. Azure 포털 및 Microsoft Foundry 포털은 모든 에이전트 검색 기능에 대한 미리 보기 전용 액세스를 계속 제공합니다. 일반적으로 사용할 수 있는 항목과 미리 보기로 남아 있는 항목에 대한 분석을 비롯한 마이그레이션 지침은 에이전트 검색 코드를 최신 버전으로 마이그레이션을 참조하세요.
지식 출처는 에이전트 검색에 사용되는 콘텐츠를 지정합니다. 외부 데이터로 채워진 검색 인덱스를 캡슐화하거나 직접 쿼리되는 Bing 또는 SharePoint 같은 원격 대상에 대한 직접 연결입니다. 지식 원천은 지식 베이스의 필수적인 정의이다.
검색 서비스에서 최고 수준의 리소스로 지식 원천을 만듭니다. 각 지식 원본은 에이전트 검색 조건을 충족하는 검색 인덱스 또는 지원되는 외부 리소스 중 하나의 데이터 구조만을 정확히 가리킵니다.
기술 자료에서 하나 이상의 정보원을 참조합니다. 에이전트 검색 파이프라인에서 단일 요청에서 여러 지식 원본에 대해 쿼리할 수 있습니다. 하위 쿼리는 각 기술 원본에 대해 생성됩니다. 검색 응답에서 상위 결과가 반환됩니다.
특정 기술 원본의 경우 기술 원본 정의를 사용하여 에이전트 검색에 적합한 전체 인덱서 파이프라인(데이터 원본, 기술 세트, 인덱서 및 인덱스)을 생성할 수 있습니다. 여러 개체를 수동으로 만드는 대신 지식 원본의 정보를 사용하여 채워진, 청크 및 검색 가능한 인덱스를 비롯한 모든 개체를 생성합니다.
기술 자료를 만들기 전에 하나 이상의 지식 원본이 있는지 확인합니다. 지식 소스 및 지식 기반의 전체 사양은 REST API 참조에서 찾을 수 있습니다.
지식 정보원 작업
만들기 경로: 먼저 지식 소스를 만든 다음 지식 기반을 만듭니다.
삭제 경로: 기술 자료를 업데이트하거나 삭제하여 기술 원본에 대한 참조를 제거한 다음, 마지막으로 기술 자료를 삭제합니다.
기술 원본, 해당 인덱스 및 기술 자료는 모두 동일한 검색 서비스에 있어야 합니다. 외부 콘텐츠는 공용 인터넷(Bing) 또는 Microsoft 테넌트(원격 SharePoint)를 통해 액세스됩니다.
지원되는 기술 자료
다음 지식 소스를 만들 수 있습니다.
| 종류 | 인덱싱 또는 원격 |
|---|---|
"searchIndex" API 는 기존 인덱스를 래핑합니다. |
인덱싱된 |
"azureBlob" API 는 Blob 컨테이너에서 끌어오는 인덱서 파이프라인을 생성합니다. |
인덱싱된 |
"indexedOneLake" API 는 레이크하우스에서 끌어오는 인덱서 파이프라인을 생성합니다. |
인덱싱된 |
"indexedSharePoint" API(미리 보기)는 SharePoint 사이트에서 끌어오는 인덱서 파이프라인을 생성합니다. |
인덱싱된 |
"remoteSharePoint" API(미리 보기)는 SharePoint 직접 콘텐츠를 검색합니다. |
원격 |
"web" API는 Microsoft Bing 실시간 접지 데이터를 검색합니다. |
원격 |
인덱싱된 기술 자료는 Azure AI 검색 대상 인덱스를 가리킵니다. 쿼리 실행은 검색 서비스의 검색 엔진에 로컬입니다. 키워드(전체 텍스트 검색), 벡터 및 하이브리드 쿼리 기능은 인덱싱된 지식 원본에서 데이터를 검색하는 데 사용됩니다.
쿼리 시 원격 지식 원본에 액세스합니다. 에이전트 검색 엔진은 플랫폼(Bing 또는 SharePoint API)에 네이티브인 검색 API를 호출합니다.
인덱싱되거나 원격으로 검색된 모든 콘텐츠는 관련성에 대해 점수가 매겨진 Azure AI 검색 순위 파이프라인으로 끌어오고, 병합(여러 쿼리를 가정)하고, 재전송되고, 검색 응답에서 반환됩니다.
지식 원본 만들기
독립 실행형 개체로 기술 자료를 만듭니다. 그런 다음, "knowledgeSources" 배열 내의 기술 자료에 지정합니다.
검색 서비스에서 개체를 만들려면 Search Service 기여자 권한이 필요합니다. 인덱서 파이프라인을 만드는 기술 자료를 사용하는 경우 인덱스를 로드하려면 인덱스 데이터 기여자 검색 권한도 필요합니다. 또는 역할 대신 API 관리자 키를 사용할 수 있습니다.
Azure 포털, REST API 또는 Azure SDK 패키지를 사용하여 기술 자료를 만듭니다. 다음 링크는 기술 자료를 만들기 위한 지침을 제공합니다.
- 검색 인덱스 지식 원본을 만드는 방법(기존 인덱스 래핑)
- Blob 지식 원본을 만드는 방법(인덱서 파이프라인 생성)
- OneLake 지식 소스를 생성하는 방법(인덱서 파이프라인 생성)
- 인덱서 파이프라인을 생성하는 인덱싱된 SharePoint 지식 소스를 만드는 방법
- SharePoint(원격) 지식 소스를 만드는 방법 (SharePoint에 직접 쿼리)
- 웹 지식 원본 리소스를 만드는 방법(Bing의 퍼블릭 엔드포인트에 연결)
지식 소스를 만든 후 지식 베이스에서 참조합니다.
지식 소스 사용
지식 원본 정의를 설정 alwaysQuery 하거나 쿼리 계획 중에 사용되는 조향 지침을 통해 지식 원본 사용량을 명시적으로 제어할 수 있습니다. 조향 지침은 인덱스에 대한 설명 또는 인덱스 사용 시기에 대한 지침을 제공하는 기술 자료의 명시적 검색 지침을 참조합니다. 쿼리 계획은 LLM에서 낮거나 중간 수준의 검색 추론 노력을 사용할 때 발생합니다. 최소한의 추론을 위해 기술 자료에 나열된 모든 기술 원본은 모든 쿼리에 대한 범위에 있습니다. 낮음 및 보통의 경우, 지식 기반과 대규모 언어 모델(LLM)은 쿼리 시점에서 최적의 검색 데이터 집합을 제공할 수 있는 지식 출처를 결정할 수 있습니다.
지식 원본 선택 논리는 다음 요소를 기반으로 합니다.
설정되어 있나요
alwaysQuery? 그렇다면 지식 원본은 항상 모든 쿼리에서 사용됩니다.name의 지식 출처입니다.description인덱싱된 지식 원본을 가정하는 인덱스의 값입니다.retrievalInstructions검색 작업 또는 기술 자료 정의에 지정된 내용은 기술 원본을 포함하거나 제외하는 지침을 제공합니다. 프롬프트와 비슷합니다. 간결성, 톤 및 서식을 검색 명령으로 지정할 수 있습니다.지식 기반에서의
outputMode은 쿼리 결과와 응답 내용에도 영향을 줍니다.
검색 추론 노력을 사용하여 LLM 사용량 제어
모든 솔루션이 LLM 쿼리 계획 및 실행의 이점을 활용하는 것은 아닙니다. 단순성과 속도가 LLM 쿼리 계획 및 컨텍스트 엔지니어링에서 제공하는 이점보다 큰 경우 파이프라인에서 LLM 처리를 방지하기 위한 최소한의 추론 노력을 지정합니다.
낮음 및 보통의 경우 LLM 처리 수준은 관련성을 향상시키는 균형 잡힌 또는 최대 접근 방식입니다. 자세한 내용은 검색 추론 작업 설정을 참조하세요.
참고
이전 미리 보기에서 attemptFastPath을(를) 사용했다면, 이제 minimal으로 설정된 retrievalReasoningEffort으로 대체됩니다.