메모
Azure AI 검색 Azure 포털, REST API 및 Azure SDK 통해 사용할 수 있습니다. 또한 엔터프라이즈 콘텐츠를 Microsoft Foundry 포털의 에이전트에 대해 재사용 가능한 사용 권한 인식 기술 자료로 변환하는 관리되는 기술 계층인 Foundry IQ를 뒷받침합니다.
Important
기능, 기능 또는 표시된 속성(미리 보기)은 서비스 수준 계약에 포함되지 않으며 프로덕션 워크로드에는 권장되지 않으며 일반적으로 사용 가능해지기 전에 변경되거나 제한될 수 있습니다. Azure AI 검색 미리 보기 용어는 독립 실행형 기능이든 일반 공급 기능의 일부이든 관계없이 모든 미리 보기 기능에 적용됩니다.
새로 고침 인식 검색 (미리 보기)을 사용하면 인덱싱된 지식 원본이 에이전트 검색 중에 최신 콘텐츠를 선호할 수 있습니다. 지식 원본에는 최신성 정책을 포함할 수 있으므로 호출자가 각 검색 요청마다 사용자 지정 순위 지정 논리를 보낼 필요 없이 Azure AI 검색가 최근 문서에 더 높은 순위를 두도록 할 수 있습니다.
신선도는 하드 필터가 아니라 순위 편향입니다. 이전 문서는 쿼리와 매우 관련이 있는 경우에도 계속 표시할 수 있습니다.
사용량 지원
| Azure Portal | Microsoft Foundry 포털 | .NET SDK | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
사전 요구 사항
blob 지식 원본과 같은 Azure AI 검색 인덱스를 만들고 유지 관리하는 인덱싱된 지식 원본입니다.
지식 소스를 참조하는 기술 자료.
기술 자료를 업데이트할 수 있는 권한입니다. 사용자 계정에 할당된 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-08-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-08-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"
}
}
}
}
최신성 정책은 원본 수집 매개변수의 일부입니다. 인덱스 스키마는 Azure AI 검색 채점 프로필 최신도 함수와 호환되는 생성된 최신도 필드를 지원하도록 수정되어 있습니다. 이 값은 boostingDuration 90일과 같은 P90D 점수 매기기 프로필 새로 고침 함수와 동일한 ISO 8601 기간 형식을 사용합니다. 최신성은 순위 결정에 최신성 신호를 추가하지만, 쿼리 관련성, 구성된 검색 설정, 의미론적 재순위 지정 및 기타 순위 신호는 여전히 적용됩니다.
새 값으로 새 create-or-update 요청을 전송하여 기존 지식 원본의 boostingDuration를 변경할 수 있습니다. 채점 프로필은 재수집할 필요 없이 제자리에서 업데이트됩니다.
기존 지식 원본에서 새로 고침 정책을 제거할 수 없습니다. 최신성 인식 검색을 비활성화하려면 지식 소스를 삭제한 다음 freshnessPolicy 없이 새로 만드세요.
순위 결정 동작 검증
최신성 필드는 수집 시점에 생성되므로 이 정책은 정책이 마련된 이후에 수집된 콘텐츠에만 적용됩니다. 콘텐츠를 수집한 후 최근 콘텐츠와 이전 콘텐츠를 모두 반환할 수 있는 검색 요청을 실행합니다. 성공적인 구성은 검색을 간단한 날짜 정렬로 전환하지 않고 이전에 최신 관련 문서를 표시합니다.
순위가 예상대로 새로 고침을 반영하지 않는 경우 기본 인덱스의 last_modified 필드를 검사합니다. 누락, 부실 또는 일관되지 않은 날짜 값은 새로 고침 신호의 품질을 감소시킵니다.