Azure AI Search のプレビュー機能
この記事では、パブリック プレビューでのデータ プレーンとコントロール プレーンのすべての機能について説明します。 この一覧は、機能の状態を確認する際に役立ちます。 また、プレビュー REST API を呼び出す方法についても説明します。
プレビュー API バージョンは累積的であり、次のプレビューにロール アップされます。 すべてのプレビュー機能に完全にアクセスするには、常に最新のプレビュー API を使うことをお勧めします。
プレビュー機能は、廃止されたり、一般提供に移行されたりすると、この一覧から削除されます。 一般公開については、サービスの更新情報または新機能に関する記事で確認できます。
データ プレーンのプレビュー機能
特徴量 | カテゴリ | 説明 | 可用性 |
---|---|---|---|
セマンティック再ランカーでのクエリの再生成 | 関連性 (スコアリング) | セマンティック クエリには、L2 ランカーからよりも関連性の高い結果を生成する変更済みまたは展開済みのクエリにクエリ入力を再書き込みするオプションを設定できます。 | ドキュメントの検索 (プレビュー)。 |
ドキュメント レイアウト スキル | 応用 AI (スキル) | 構造や構造対応のチャンクのドキュメントの分析に使用する新しいスキル。 | スキルセットの作成または更新 (プレビュー)。 |
Azure AI スキル処理のキーレス課金。 | 応用 AI (スキル) | 組み込みのスキル処理を目的とした Azure AI サービスへのキーレス接続にマネージド ID とロールを使用できるようになりました。 この機能を使用すると、同じリージョン内での検索サービスと AI サービスの両方の利用に対する制限がなくなります。 | スキルセットの作成または更新 (プレビュー)。 |
Markdown 解析モード | インデクサー データ ソース | この解析モードでは、インデクサーを使用して、一対一または一対多の検索ドキュメントを Azure Storage 内の Markdown ファイルから生成できます。 | インデクサーの作成または更新 (プレビュー)。 |
圧縮ベクトルの再スコアリング オプション | 関連性 (スコアリング) | 圧縮ベクトルではなく元のベクトルを使用して再スコアリングするオプションを設定できます。 バイナリとスカラー圧縮を使用して、HNSW アルゴリズムと完全な KNN ベクトル アルゴリズムに適用します。 | インデックスの作成または更新 (プレビュー)。 |
Azure OpenAI の MRL トレーニング済みテキスト埋め込みモデルの次元要件を下げる | インデックス | Text-embedding-3-small と Text-embedding-3-large は、Matryoshka Representation Learning (MRL) を使用してトレーニングされます。 これにより、埋め込みベクトルをより少ない次元に切り詰めて、ベクトル インデックス サイズの使用量と取得品質のバランスを調整できます。 新しい truncationDimension には、ベクトル圧縮構成の追加パラメーターとして MRL 動作が用意されています。 これは、新しいベクトル フィールドに対してのみ構成できます。 |
インデックスの作成または更新 (プレビュー)。 |
@search.score をアンパックしてハイブリッド検索結果のサブスコアを表示する |
関連性 (スコアリング) | Reciprocal Rank Fusion (RRF) でランク付けされた結果を、マージされスコア付けされた最終的な結果の個々のクエリ サブスコアを表示することで調査できます。 新しい debug プロパティによって、検索スコアがアンパックされます。 QueryResultDocumentSubscores 、QueryResultDocumentRerankerInput 、QueryResultDocumentSemanticField によって、追加の詳細が提供されます。 |
ドキュメントの検索 (プレビュー)。 |
ベクトル クエリのみを対象とするハイブリッド検索のターゲット フィルター | クエリ | ハイブリッド クエリのフィルターには、種類に関係なく、要求のすべてのサブクエリが含まれます。 グローバル フィルターをオーバーライドして、フィルターのスコープを特定のサブクエリに設定できます。 新しい filterOverride パラメーターによってその動作が提供されます。 |
ドキュメントの検索 (プレビュー)。 |
テキスト分割スキル (トークンのチャンキング) | 応用 AI (スキル) | このスキルには、埋め込みモデルのデータのチャンキングを改善する新しいパラメーターがあります。 新しい unit パラメーターを使用することにより、トークンのチャンキングを指定できます。 トークンの長さを埋め込みモデルに適した値に設定することで、トークン長でチャンクを作成できるようになりました。 また、トークナイザーと、データのチャンキング中に分割すべきではないトークンを指定することもできます。 |
スキルセットの作成または更新 (プレビュー)。 |
Azure AI Vision マルチモーダル埋め込みスキル | 応用 AI (スキル) | Azure AI Vision マルチモーダル API を呼び出して、インデックス作成中にテキストまたは画像の埋め込みを生成する新しいスキルの種類。 | スキルセットの作成または更新 (プレビュー)。 |
Azure Machine Learning (AML) スキル | 応用 AI (スキル) | AML スキルは、Azure Machine Learning からの推論エンドポイントを統合します。 以前のプレビュー API では、AML ワークスペースにデプロイされたカスタム モデルへの接続がサポートされています。 2024-05-01-preview 以降では、Azure AI Studio モデル カタログの埋め込みモデルに接続するワークフローでこのスキルを使用できます。 Azure AI 検索と Azure Machine Learning service が同じサブスクリプションにデプロイされている場合、ポータルのスキルセット設計でも使用できます。 | スキルセットの作成または更新 (プレビュー)。 |
増分エンリッチメント キャッシュ | 応用 AI (スキル) | エンリッチメント パイプラインにキャッシュが追加され、スキルセットや別のオブジェクトに対する更新など、目的の変更によってコンテンツが変更されない場合に既存の出力を再利用できます。 キャッシュは、スキルセットによって生成されるエンリッチされたドキュメントにのみ適用されます。 | インデクサーの作成または更新 (プレビュー)。 |
OneLake ファイル インデクサー | インデクサー データ ソース | OneLake 上の lakehouse から検索可能なデータとメタデータ データを抽出するための新しいデータ ソース | データ ソースの作成または更新 (プレビュー)。 |
Azure Files インデクサー | インデクサー データ ソース | Azure Files からのインデクサー ベースのインデックス付け用の新しいデータ ソース | データ ソースの作成または更新 (プレビュー)。 |
SharePoint Online インデクサー | インデクサー データ ソース | SharePoint コンテンツのインデクサーベースのインデックス作成用の新しいデータソースです。 | サインアップして機能を有効にします。 データ ソースの作成または更新 (プレビュー) または Azure portal。 |
MySQL インデクサー | インデクサー データ ソース | Azure MySQL データ ソースのインデクサー ベースのインデックス付け用の新しいデータ ソース。 | サインアップして機能を有効にします。 データ ソースの作成または更新 (プレビュー)、.NET SDK 11.2.1、Azure portal。 |
Azure Cosmos DB for MongoDB インデクサー | インデクサー データ ソース | Azure Cosmos DB の MongoDB API を使用したインデクサー ベースのインデックス付け用の新しいデータ ソース。 | サインアップして機能を有効にします。 データ ソースの作成または更新 (プレビュー) または Azure portal。 |
Azure Cosmos DB for Apache Gremlin インデクサー | インデクサー データ ソース | Azure Cosmos DB の Apache Gremlin API を使用したインデクサーベースのインデックス付け用の新しいデータ ソース。 | サインアップして機能を有効にします。 データ ソースの作成または更新 (プレビュー)。 |
ネイティブ BLOB の論理的な削除 | インデクサー データ ソース | Azure Blob Storage インデクサーに適用します。 論理的に削除された状態の BLOB を認識し、インデックス付け中に対応する検索ドキュメントを削除します。 | データ ソースの作成または更新 (プレビュー)。 |
ドキュメントのリセット | Indexer | インデクサー ワークロードで個別に選択された検索ドキュメントを再処理します。 | ドキュメントのリセット (プレビュー)。 |
スペル チェック | クエリ | 単純、完全、およびセマンティック クエリのクエリ用語入力に対するスペル修正 (オプション)。 | ドキュメントの検索 (プレビュー)。 |
ノーマライザー | クエリ | ノーマライザーでは、完全なテキスト分析チェーンを呼び出さずに、一貫した大文字と小文字の区別、アクセントの削除、ASCII フォールディングなど、単純なテキストの事前処理が提供されます。 | ドキュメントの検索 (プレビュー)。 |
featuresMode パラメーター | 関連性 (スコアリング) | フィールドごとの類似性スコア、フィールドごとの用語の頻度、およびフィールドごとの一致した一意のトークン数の詳細を含む BM25 関連性スコアの拡張。 これらのデータ ポイントは、カスタム スコアリング ソリューションで使用できます。 | ドキュメントの検索 (プレビュー)。 |
vectorQueries.threshold のパラメーター | 関連性 (スコアリング) | 最小スコアに基づいて、スコアの低い検索結果を除外します。 | ドキュメントの検索 (プレビュー)。 |
hybridSearch.maxTextRecallSize および countAndFacetMode のパラメーター | 関連性 (スコアリング) | ハイブリッド ランク付けモデルに送られる BM25 ランク付け結果の量を制御して、ハイブリッド クエリへの入力を調整します。 | ドキュメントの検索 (プレビュー)。 |
moreLikeThis | クエリ | 特定のドキュメントに関連する別のドキュメントを検索します。 この機能は、以前のプレビューからありました。 | ドキュメントの検索 (プレビュー)。 |
コントロール プレーンのプレビュー機能
特徴量 | カテゴリ | 説明 | 可用性 |
---|---|---|---|
ネットワーク セキュリティ境界 | サービス | 検索サービスをネットワーク セキュリティ境界に参加させて、利用中の検索サービスへのネットワーク アクセスを制御します。 | Azure portal とネットワーク セキュリティ境界 API 2024-06-01-preview。 |
ユーザー割り当てマネージド ID での検索サービス | サービス | 以前に作成したユーザー割り当てマネージド ID を使用するように検索サービスを構成します。 | サービス - 更新、2021-04-01-preview、または最新のプレビュー バージョン。 最新のプレビュー バージョンの使用をお勧めします。 |
Azure SDK のプレビュー機能
各 Azure SDK チームは、独自のタイムラインでベータ版パッケージをリリースします。 ベータ版パッケージの新機能に関する情報については、次の変更ログを確認してください。
- Azure SDK for .NET の変更ログ
- Azure SDK for Java の変更ログ
- Azure SDK for JavaScript の変更ログ
- Azure SDK for Python の変更ログ
プレビュー機能の使用
実験的な機能は、最初にプレビュー REST API、Azure portal、Azure SDK を通じて利用できます。
プレビュー機能には、次のステートメントが適用されます。
- プレビュー機能は、サービス レベル アグリーメントなしで、追加使用条件に基づいて利用できます。
- 再設計が必要な場合、プレビュー機能は破壊的変更が行われる可能性があります。
- プレビュー機能では、GA リリースにできない場合があります。
プレビュー API を使ってコードを記述する場合は、新しい API バージョンがロールアウトされたらそのコードをアップグレードできるようにしておく必要があります。Upgrade REST API のドキュメントは、そのステップを簡単に実行できるように保守されています。
プレビューの REST API を呼び出す方法
プレビュー REST API は、URI の api-version パラメータを使用してアクセスします。 以前のプレビューは引き続き動作しますが、時間の経過と共に時代遅れになり、新機能やバグ修正の更新が行われません。
コンテンツのデータ プレーン操作の場合、2024-05-01-preview
は最新のプレビュー バージョンです。 次に示す例は、インデックス GET (プレビュー) の構文です。
GET {endpoint}/indexes('{indexName}')?api-version=2024-05-01-Preview
検索サービスの管理操作の場合、2024-06-01-preview
は最新のプレビュー バージョンです。 次に示す例は、サービスの更新 2024-06-01-preview バージョンの構文です。
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-06-01-preview
{
"tags": {
"app-name": "My e-commerce app",
"new-tag": "Adding a new tag"
},
"properties": {
"replicaCount": 2
}
}