메모
Foundry IQ (Azure AI 검색)는 관리 검색을 위해 고급 수준의 지식 원본 API 및 지식 베이스 API와 함께 직접 인덱싱 및 쿼리 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.
Search Documents API에서 moreLikeThis 매개 변수를 사용하여 인덱스에 이미 있는 문서와 유사한 문서를 찾습니다. 매개 변수는 일반적으로 REST API 버전 2026-10-01에서 사용할 수 있습니다. foundry IQ(Azure AI 검색)는 원본 문서의 검색 가능한 필드에서 쿼리 용어를 파생시키고 결과에서 해당 문서를 제외합니다.
예제
다음 예제에서는 사용 권한 필터 필드가 있는 인덱스 만들기의 4개 문서 인덱스와 해당 인덱싱 워크플로를 사용합니다. 먼저 해당 설정을 완료합니다.
<SEARCH_ACCESS_TOKEN>를 엔드포인트로 바꾸고 <SEARCH_SERVICE_ENDPOINT>를 인덱스를 쿼리할 권한이 있는 호출자 토큰으로 바꾸세요.
<USER_OBJECT_ID>을 업로드에 사용된 <USER_ACCESS_TOKEN>의 원시 위임 사용자 토큰으로 바꾸십시오.
단순 쿼리
search를 사용할 때는 moreLikeThis를 생략합니다.
"search": "*"를 포함한 null이 아닌 모든 검색 텍스트는 moreLikeThis와 충돌하여 요청 오류를 발생시킵니다.
다음 POST 요청은 원본 문서 키 21 와 최상위 검색 가능 content 필드를 사용합니다.
POST <SEARCH_SERVICE_ENDPOINT>/indexes('secured-content-index')/docs/search.post.search?api-version=2026-10-01
Authorization: Bearer <SEARCH_ACCESS_TOKEN>
x-ms-query-source-authorization: <USER_ACCESS_TOKEN>
Content-Type: application/json
Accept: application/json
{
"moreLikeThis": "21",
"searchFields": "content",
"select": "id,content",
"top": 4,
"count": true
}
참조: 문서 검색(POST).
빈 유사성 결과 문제 해결
유사성이 비어 있지 않은 결과를 보장하지는 않습니다. 지정한 키를 가진 문서가 없으면 요청은 value를 반환하며, 200 OK 배열은 비어 있습니다.
이 양수 쿼리가 비어 있는 경우 쿼리 예제 를 사용하여 원본 문서 21 와 후보가 101 동일한 자격 증명으로 검색 가능하고 읽을 수 있는지 확인합니다.
두 문서를 모두 읽을 수 있는 경우에도 작은 코퍼스가 유사성 쿼리의 용어 빈도 요구 사항을 충족하지 못할 수 있습니다. 문서 분포는 이러한 요구 사항이 충족되는지 여부에 영향을 줄 수 있습니다.
필터 적용
moreLikeThis를 필터와 결합하여 후보 결과를 제한합니다. 이 요청은 긍정 쿼리에서 천문학 후보를 제외한 원예 문서를 선택합니다.
POST <SEARCH_SERVICE_ENDPOINT>/indexes('secured-content-index')/docs/search.post.search?api-version=2026-10-01
Authorization: Bearer <SEARCH_ACCESS_TOKEN>
x-ms-query-source-authorization: <USER_ACCESS_TOKEN>
Content-Type: application/json
Accept: application/json
{
"moreLikeThis": "21",
"searchFields": "content",
"select": "id,content",
"top": 4,
"count": true,
"filter": "category eq 'gardening'"
}
참조: 문서 검색(POST).
필드 선택 및 결과 제한
select를 사용하여 결과 수를 제한하고 top를 사용하여 반환된 필드를 선택합니다. 쉼표로 구분된 searchFields 매개 변수를 사용하여 검색 가능한 필드를 선택합니다. 생략하면 일반적인 검색 가능 필드 확인 방식이 적용됩니다.
moreLikeThis
복잡한 하위 필드를 지원하지 않으므로 인덱스에 복잡한 필드가 포함된 경우 적절한 최상위 검색 가능 필드를 명시적으로 선택합니다.
예제는 최대 4개의 결과를 요청하고 id 및 content를 반환합니다. 결과는 여전히 원본 문서를 제외합니다.
네이티브 문서 사용 권한
네이티브 권한 필터링이 사용 설정된 인덱스에서는 moreLikeThis가 해당 콘텐츠를 사용하기 전에 원본 문서의 사용 권한을 확인합니다. 또한 인덱스의 ACL 및 RBAC 범위 권한을 통해 독립적으로 후보 문서를 필터링합니다.
권한 필터링 쿼리의 경우 위임된 사용자의 토큰을 전달합니다 x-ms-query-source-authorization. 헤더를 사용하려면 사용 권한 필터링이 사용하도록 설정된 인덱스가 필요합니다. 지원되는 권한 흐름은 쿼리 시간 토큰 역할 및 권한 흐름에서 확인하세요. 이 예제에서는 원본 및 후보 문서에 대한 직접 사용자 부여를 사용합니다.
moreLikeThis에서는 Purview 및 에이전트 쿼리가 지원되지 않습니다.