Note
Azure AI 検索は、Azure ポータル、REST API、およびAzure SDKから使用できます。 また、Foundry IQ は、エンタープライズ コンテンツを、Microsoft Foundry ポータルのエージェントの再利用可能なアクセス許可に対応したナレッジ ベースに変換するマネージド ナレッジ レイヤーです。
Important
機能、またはマークされたプロパティ (プレビュー) は、サービス レベル アグリーメントの対象ではなく、運用環境のワークロードには推奨されず、一般公開される前に変更または制約される可能性があります。 Azure AI 検索 プレビューの用語は、スタンドアロンでも一般公開されている機能の一部でも、すべてのプレビュー機能に適用されます。
鮮度対応の検索 (プレビュー) では、インデックス化されたナレッジ ソースで、エージェントによる検索時に新しいコンテンツを優先できます。 ナレッジ ソースには鮮度ポリシーを含めることができるため、Azure AI 検索 は、呼び出し元が取得要求のたびにカスタムのランキング ロジックを送信しなくても、新しいドキュメントが上位に来るようにランキングを調整できます。
鮮度はランク付けバイアスであり、ハード フィルターではありません。 古いドキュメントは、クエリに強く関連している場合でも表示されます。
使用サポート
| Azure Portal | Microsoft Foundry ポータル | .NET SDK | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Prerequisites
Azure AI 検索 インデックスを作成および維持するインデックス付きナレッジ ソース (たとえば、blob ナレッジ ソース)
ナレッジ ソースを参照するナレッジ ベース。
ナレッジ ベースを更新するためのアクセス許可。 ユーザー アカウントに割り当てられた Search Service 共同作成者ロール (推奨) を使用してキーレス認証を構成するか、管理者 API キーを使用します。
最新の
Azure.Search.Documentsプレビュー パッケージ:dotnet add package Azure.Search.Documents --prereleaseキーレス認証の場合、
Azure.Identityパッケージは次のようになります。dotnet add package Azure.Identity
最新の
azure-search-documentsプレビュー パッケージ:pip install --pre azure-search-documentsキーレス認証の場合、
azure-identityパッケージは次のようになります。pip install azure-identity
Search Service REST API の 2026-08-01-preview バージョン。
キーレス認証の場合は、各 HTTP 要求の
AuthorizationヘッダーにMicrosoft Entra ID トークンを含めます。
鮮度を考慮した検索を有効にするタイミング
新しいコンテンツが一般的に古いコンテンツよりも便利または信頼できる場合は、鮮度に対応した取得を有効にします。 一般的な例としては、リリース ノート、ポリシーの更新、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 検索 スコアリング プロファイル freshness 関数と互換性があります。
boostingDuration値は、スコアリング プロファイルの鮮度関数と同じ ISO 8601 期間形式 (90 日間のP90Dなど) を使用します。 Freshness はランキングに新しさのシグナルを追加しますが、クエリの関連性、構成済みの取得設定、セマンティック再ランキング、その他のランキング シグナルは引き続き適用されます。
新しい値を使用して別の作成または更新要求を送信することで、既存のナレッジ ソースの boostingDuration を変更できます。 スコアリング プロファイルは、再取り込みを必要とせずその場で更新されます。
既存のナレッジ ソースから鮮度ポリシーを削除することはできません。 鮮度対応の取得を無効にするには、ナレッジ ソースを削除し、freshnessPolicy を含めずに新しいナレッジ ソースを作成します。
ランク付けの動作を検証する
鮮度フィールドはインジェスト時に生成されるため、ポリシーはポリシーが適用された後に取り込まれるコンテンツに適用されます。 コンテンツが取り込まれた後、最近のコンテンツと古いコンテンツの両方を返すことができる取得要求を実行します。 構成が成功すると、取得を単純な日付の並べ替えにすることなく、新しい関連ドキュメントが先に表示されます。
ランク付けで期待どおりの鮮度が反映されない場合は、基になるインデックスの last_modified フィールドを調べます。 日付値が見つからない、古い、または一貫性がない場合は、鮮度シグナルの品質が低下します。