메모
Foundry IQ (Azure AI 검색)는 관리형 검색을 위한 상위 수준의 지식 원본 및 지식 베이스 API와 함께 직접 인덱싱 및 쿼리 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.
Important
최신성 인식 검색은 공개 미리 보기로 제공되며 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.
이 기능과 관련된 미리 보기 관련 약관은 미리 보기 기능을 참조하세요.
최신성 인식 검색 (미리 보기)을 사용하면 인덱싱된 지식 원본이 에이전트 검색 중에 최신 콘텐츠를 선호할 수 있습니다. 기술 자료에는 새로 고침 정책이 포함될 수 있으므로 Foundry IQ(Azure AI 검색)는 호출자가 각 검색 요청에 사용자 지정 순위 논리를 보낼 필요 없이 최근 문서에 대한 순위를 편향합니다.
신선도는 하드 필터가 아니라 순위 편향입니다. 이전 문서는 쿼리와 매우 관련이 있는 경우에도 계속 표시할 수 있습니다.
사용량 지원
| Azure 포털 | Microsoft Foundry 포털 | .NET SDK | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
사전 요구 사항
Blob 지식 원본과 같은 Foundry IQ 인덱스를 만들고 유지 관리하는 인덱싱된 지식 원본입니다.
지식 소스를 참조하는 기술 자료.
기술 자료를 업데이트할 수 있는 권한입니다. 사용자 계정에 할당된 Search Service 기여자 역할로 키 없는 인증을 구성하거나(권장) 관리자 API 키를 사용합니다.
최신
Azure.Search.Documents미리 보기 패키지:dotnet add package Azure.Search.Documents --prerelease키 없는 인증의 경우 패키지:
Azure.Identitydotnet add package Azure.Identity
최신
azure-search-documents미리 보기 패키지:pip install --pre azure-search-documents키 없는 인증의 경우 패키지:
azure-identitypip install azure-identity
Search Service REST API의 2026-11-01-preview 버전입니다.
키 없는 인증의 경우 각 HTTP 요청의 헤더에 Microsoft Entra ID 토큰을
Authorization포함합니다.
새로 고침 인식 검색을 사용하도록 설정해야 하는 경우
최신 콘텐츠가 일반적으로 이전 콘텐츠보다 더 유용하거나 신뢰할 수 있는 경우 새로 고침 인식 검색을 사용하도록 설정합니다. 일반적인 예로는 릴리스 정보, 정책 업데이트, Runbook, 서비스 권고 및 운영 지침이 있습니다.
필터링 대신 최신 상태를 사용하지 마세요. 쿼리가 특정 날짜 범위의 콘텐츠만 반환해야 하는 경우 검색 요청 또는 기술 원본 구성에서 필터를 대신 사용합니다.
새로 고침 정책 구성
인덱싱된 기술 자료 정의에 새로 고침 정책을 추가합니다. 미리 보기 계약은 검색 파이프라인의 나머지 부분은 그대로 유지하면서 정책을 사용해 최신성 기반 순위 결정 신호를 적용합니다.
다음 예제에서는 새로 고침 정책이 있는 Blob 지식 원본을 보여 있습니다.
var knowledgeSource = new AzureBlobKnowledgeSource(
name: "news-articles-ks",
azureBlobParameters: new AzureBlobKnowledgeSourceParameters(connectionString: blobConnectionString, containerName: "news")
{
IngestionParameters = new IngestionParameters
{
FreshnessPolicy = new FreshnessPolicy
{
BoostingDuration = TimeSpan.FromDays(90)
}
}
}
)
{
Description = "A knowledge source for recent news articles."
};
await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);
knowledge_source = AzureBlobKnowledgeSource(
name="news-articles-ks",
description="A knowledge source for recent news articles.",
azure_blob_parameters=AzureBlobKnowledgeSourceParameters(
connection_string=blob_connection_string,
container_name="news",
ingestion_parameters=IngestionParameters(
freshness_policy=FreshnessPolicy(boosting_duration="P90D"),
),
),
)
index_client.create_or_update_knowledge_source(knowledge_source)
PUT {{search-endpoint}}/knowledgesources/news-articles-ks?api-version=2026-11-01-preview
Content-Type: application/json
Authorization: Bearer {{search-access-token}}
{
"name": "news-articles-ks",
"kind": "azureBlob",
"description": "A knowledge source for recent news articles.",
"azureBlobParameters": {
"connectionString": "{{blob-connection-string}}",
"containerName": "news",
"ingestionParameters": {
"freshnessPolicy": {
"boostingDuration": "P90D"
}
}
}
}
최신성 정책은 원본 수집 매개변수의 일부입니다. 인덱스 스키마는 Foundry IQ 점수 매기기 프로필 최신성 함수와 호환되는 생성된 최신성 필드를 지원하도록 수정됩니다. 이 값은 boostingDuration 90일과 같은 P90D 점수 매기기 프로필 새로 고침 함수와 동일한 ISO 8601 기간 형식을 사용합니다. 최신성은 순위 결정에 최신성 신호를 추가하지만, 쿼리 관련성, 구성된 검색 설정, 의미론적 재순위 지정 및 기타 순위 신호는 여전히 적용됩니다.
새 값으로 새 create-or-update 요청을 전송하여 기존 지식 원본의 boostingDuration를 변경할 수 있습니다. 채점 프로필은 재수집할 필요 없이 제자리에서 업데이트됩니다.
기존 지식 원본에서 새로 고침 정책을 제거할 수 없습니다. 최신성 인식 검색을 비활성화하려면 지식 소스를 삭제한 다음 freshnessPolicy 없이 새로 만드세요.
순위 결정 동작 검증
최신성 필드는 수집 시점에 생성되므로 이 정책은 정책이 마련된 이후에 수집된 콘텐츠에만 적용됩니다. 콘텐츠를 수집한 후 최근 콘텐츠와 이전 콘텐츠를 모두 반환할 수 있는 검색 요청을 실행합니다. 성공적인 구성은 검색을 간단한 날짜 정렬로 전환하지 않고 이전에 최신 관련 문서를 표시합니다.
순위가 예상대로 새로 고침을 반영하지 않는 경우 기본 인덱스의 last_modified 필드를 검사합니다. 누락, 부실 또는 일관되지 않은 날짜 값은 새로 고침 신호의 품질을 감소시킵니다.