REST API バージョン (Azure AI Search)

この記事では、Azure AI Search用の Search REST API の現在と過去のバージョンの一覧を示します。

バージョン管理された API ドキュメント

REST API ドキュメントのバージョン管理が行われます。 API 参照ページを開くと、目次の上にバージョン セレクターが表示されます。

  1. [ 参照データ プレーン] を > 展開します

  2. API リファレンス ページを選択します。

  3. 左上のドロップダウン フィルターから API バージョン を選択します。

    バージョン セレクターのスクリーンショット。

安定したバージョン

API バージョン 仕様 API の更新
2023-11-01 (最新) Swagger の仕様 リリース ノート
2020-06-30 Swagger の仕様 リリース ノート
2019-05-06 Swagger の仕様 複合型が追加されています。
2017-11-11 Swagger の仕様 スキルセットと AI エンリッチメントが追加されています。
2016-09-01 Swagger の仕様 インデクサーが追加されています。
2015-02-28 2020 年 10 月 10 日以降はサポートされません 最初に一般公開されたリリースです。

プレビュー バージョン

プレビュー バージョンは、新機能のテスト、フィードバックの収集、問題の検出と修正のためにリリースされます。 プレビュー API は、「 Microsoft Azure プレビューの追加使用条件」で入手できます。

API バージョン 仕様 API の更新
2024-03-01-Preview (最新) Swagger の仕様 リリース ノート
2023-10-01-Preview Swagger の仕様 リリース ノート
2023-07-01-Preview Swagger の仕様 リリース ノート
2021-04-30-Preview Swagger の仕様 リリース ノート
2020-06-30-Preview Swagger の仕様 リリース ノート
2019-05-06-Preview Swagger の仕様 リリース ノート
2017-11-11-Preview Swagger の仕様 安定バージョンに関連付けられているプレビュー バージョン。
2016-09-01-Preview Swagger の仕様 安定バージョンに関連付けられているプレビュー バージョン。
2015-02-28-Preview 2020 年 10 月 10 日以降はサポートされません 安定バージョンに関連付けられているプレビュー バージョン。
2014-10-20-Preview 2020 年 10 月 10 日以降はサポートされません 2 番目のパブリック プレビューです。
2014-07-31-Preview 2020 年 10 月 10 日以降はサポートされません 1 番目のパブリック プレビューです。

リリース ノート

2024-03-01-Preview

このプレビュー バージョンは、 2023-10-01-preview 領域を節約するのに役立つ次のプレビュー API を追加することで構築されます。

  • ベクター フィールドをサポートする埋め込みモデルがある場合、または小さいベクトルを出力する量子化ロジックがある場合は、ベクター フィールドの新しい 狭いデータ型
  • 検索インデックスの組み込みベクター圧縮のための新しいベクトル 量子化プロパティ
  • フィールドの追加のコピーを格納するかどうかを決定するベクター フィールドの新しいブール型格納プロパティ。 追加のコピーは、そのフィールドの取得可能なコンテンツです。 保存しない場合、フィールドはクエリで引き続き使用されますが、検索結果で返すことはできません。 このプロパティを設定すると、検索サービスの領域または検索インデックス内のベクター クォータを節約できます。

2023-11-01

このバージョンでは、次のような一般公開されている機能が提供されます。

  • Search Post 要求のセマンティック ランク付け。
  • Create または Update Index 要求のベクター検索インデックス作成と、Search Post 要求のベクター クエリ。

2023-10-01-Preview

このバージョンには、以前のプレビューで導入されたすべての機能と、ベクター検索 API への追加と変更が含まれています。 ベクター検索 API へのUpdatesは、2023-07-01-Preview からの破壊的変更です。 移行のヘルプについては、「 ベクター フィールドの追加 」と 「ベクター クエリの作成 」を参照してください。

新しいプレフィルター機能を使用する予定の場合は、2023-10-01 以降に作成されたインデックスを使用する必要があります。

インデックスの作成または更新:

  • vectorSearchには、および のalgorithmsprofiles定義がありますvectorizers

    • algorithms は引き続きサポート hnsw され、階層的なナビゲーション可能な小さな世界 (HNSW) と包括的な K ニアレスト ネイバー (eKNN) を参照して、 もサポート eknnされるようになりました。 アルゴリズム セクション内では、HNSW パラメーターと eKNN パラメーターの複数の名前付き組み合わせを定義できます。 これは、 algorithmConfigurations 2023-07-01-Preview の プロパティ内 vectorSearch で置き換えられます。

    • profiles は、アルゴリズム構成を指定する新しい定義です。 たとえば、HNSW-1、HSNW-2、eKNN-1 という名前のアルゴリズム構成があるとします。 プロファイルで HNSW-1 を指定する場合があります。

    • vectorizers は表示されますが、現在は無視されます。

  • ベクター フィールドでは、 vectorSearchProfilevectorSearchConfiguration置き換えます。 プロパティは vectorSearchProfile 、フィールドで使用するベクター検索プロファイルを指定します。

  • この API バージョンより前に作成されたインデックスでは、2023-10-01-Preview API を呼び出すと、要求で フィールドを変更して、 で指定したアルゴリズムとまったく同じアルゴリズムがプロファイルでvectorSearchConfiguration指定されている限り、 を指定vectorSearchProfileする必要があります。 たとえば、既存のフィールド定義で が指定されている "vectorSearchConfiguration": "myHnsw"場合は、 に "vectorSearchProfile": "your profile name"置き換え、同じ "algorithm": "myHnsw"を参照するようにプロファイルを定義する必要があります。

ドキュメントのSearch:

  • vectorQueriesvectorsは 2023-07-01-Preview で置き換えられます

  • vectorQueries.vectorsvectors.values 2023-07-01-Preview で置き換えられます。

  • ベクター クエリはポリモーフィック構造になりました。 kind は、要求されるベクター クエリの種類を示すために指定する必要があります。

    • "kind": "vector" はクエリがベクターであることを意味するため、呼び出し元は検索クエリ文字列をベクター埋め込みに既にベクター化している必要があります。
  • "exhaustive": "true" は、ベクトル インデックス内のすべてのベクトルに対して、完全な (ブルート フォース) k ニアレスト ネイバー検索を実行するかどうかを指定する新しいプロパティです。

  • vectorFilterMode は、クエリで事前フィルター処理 (2023-10-01 以降に作成されたインデックスの既定値) またはポストフィルター処理 (以前のインデックスの既定値) を指定するための新しいパラメーターです。

2023-07-01-Preview

このバージョンには、以前のプレビューで導入されたすべての機能とベクター検索のサポートが含まれています。

  • 検索インデックスで、単精度浮動小数点数の配列を含むフィールドにデータ型を割り当てます Collection(Edm.Single) 。 これは、ドキュメント フィールドごとに 1 つの生成された埋め込みを格納するために使用される、新しいベクター検索機能のデータ型です。 また、検索インデックスでベクター構成プロパティを指定します。 これらの API については、「 インデックスの作成または更新 」を参照してください。

  • インデックス作成ワークロードは、ベクター データを受け入れるように更新されます。 「 ドキュメントの追加、更新、または削除」を参照してください

  • ベクター検索のクエリ パラメーター。 これらのパラメーターについては、「Search ドキュメント」を参照してください。

  • サービス統計の取得: サービスのベクター インデックス クォータと使用状況を返します。

  • インデックス統計の取得: ベクター インデックスのクォータと検索インデックスの使用状況を返します。

2021-04-30-Preview

このプレビュー バージョンには、2020-06-30-Preview で導入されたすべての機能と、次の API への追加が含まれています。

2020-06-30

このバージョンでは、次のような一般提供の機能が提供されます。

  • データ プレーン操作のための Azure ロールベースのアクセス制御
  • 関連性スコアリング (BM25)
  • ナレッジ ストア
  • Azure Data Lake Storage (ADLS) Gen2 のインデクサー データ ソース
  • カスタム エンティティの参照スキル
  • Microsoft Entra IDを介してシステムまたはユーザーマネージド ID で実行されているインデクサー

2020-06-30-Preview

このプレビュー バージョンには、2019-05-06-Preview で導入されたすべての機能と、次の追加機能が含まれています。

  • セマンティック検索。Standard レベルのサービスで実行され、セマンティック ランク付けを呼び出す Premium 機能です。
  • Power Query コネクタのインデクサー データ ソース
  • MySQL のインデクサー データ ソース
  • Cosmos DB Gremlin API のインデクサー データ ソース
  • SharePoint Online のインデクサー データ ソース
  • テキスト正規化の Normalizer プロパティ(大文字と小文字を区別しないフィルター処理、ファセット、並べ替え用)
  • インデクサーベースのインデックス作成のためにドキュメントをリセットして、特定のドキュメントを ID で具体的に更新する
  • エンティティ リンクのコグニティブ スキル (v3)
  • エンティティ認識の認知スキル (v3)
  • 感情分析コグニティブ スキル (v3)

2019-05-06-Preview

  • Cosmos DB MongoDB API のインデクサー データ ソースのサポート
  • Blob Storage でのネイティブ BLOB の論理的な削除のインデクサー データ ソース
  • 関連性スコアに関する詳細情報を返す featuresMode パラメーター
  • Azure Machine Learning (AML) コグニティブ スキル
  • 個人識別検出の認知スキル
  • エンリッチされたドキュメントをキャッシュして画像処理 (およびその他の AI エンリッチメント) を保持および再利用する

こちらもご覧ください