Documents - Search Post

サービス:: Search Service

API バージョン:: 2026-04-01

インデックス内のドキュメントを検索します。

POST {endpoint}/indexes('{indexName}')/docs/search.post.search?api-version=2026-04-01

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string (uri)	検索サービスのエンドポイント URL。
indexName	path	True	string	インデックスの名前。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求ヘッダー

名前	必須	型	説明
Accept		Accept	Acceptヘッダーです。
x-ms-client-request-id		string (uuid)	要求の非透過的なグローバルに一意のクライアント生成文字列識別子。

要求本文

名前	型	説明
answers	QueryAnswerType	検索応答の一部として回答を返す必要があるかどうかを指定する値。
captions	QueryCaptionType	キャプションを検索応答の一部として返す必要があるかどうかを指定する値。
count	boolean	結果の合計数をフェッチするかどうかを指定する値。既定値は falseです。この値を true に設定すると、パフォーマンスに影響する可能性があります。返されるカウントは近似値であることに注意してください。
debug	QueryDebugMode	ランク付けされた結果をさらに調査するために使用できるデバッグツールを有効にします。
facets	string[]	検索クエリに適用するファセット式の一覧。各ファセット式にはフィールド名が含まれます。必要に応じて、名前と値のペアのコンマ区切りのリストが続きます。
filter	string	検索クエリに適用する OData $filter式。
highlight	string	ヒット強調表示に使用するフィールド名のコンマ区切りのリスト。検索可能なフィールドのみを、ヒット強調表示に使用できます。
highlightPostTag	string	ヒットハイライトに追加される文字列タグ。 highlightPreTag を使用して設定する必要があります。既定値は /em<>です。
highlightPreTag	string	強調表示をヒットする前に付加される文字列タグ。 highlightPostTag を使用して設定する必要があります。既定値は <em>です。
minimumCoverage	number (double)	クエリを成功として報告するために検索クエリでカバーする必要があるインデックスの割合を示す 0 ~ 100 の数値。このパラメーターは、レプリカが 1 つだけのサービスでも検索の可用性を確保するのに役立ちます。既定値は 100 です。
orderby	string	結果を並べ替えるための OData $orderby式のコンマ区切りリスト。各式には、フィールド名または geo.distance() 関数または search.score() 関数の呼び出しを指定できます。各式の後に asc を付けて昇順を示すか、降順を示す desc を指定できます。既定値は昇順です。同点は、ドキュメントのマッチスコアによって分割されます。 $orderbyが指定されていない場合、既定の並べ替え順序はドキュメントの一致スコアの降順になります。最大で 32 個の$orderby句があります。
queryType	QueryType	検索クエリの構文を指定する値。既定値は "simple" です。クエリで Lucene クエリ構文を使用する場合は、'full' を使用します。
scoringParameters	string[]	形式名と値を使用してスコアリング関数 (referencePointParameter など) で使用するパラメーター値の一覧。たとえば、スコアリングプロファイルで "mylocation" というパラメーターを持つ関数が定義されている場合、パラメーター文字列は "mylocation-122.2,44.8" になります (引用符は使用しません)。
scoringProfile	string	結果を並べ替えるために一致するドキュメントの一致スコアを評価するスコアリングプロファイルの名前。
scoringStatistics	ScoringStatistics	スコアリングの統計情報 (ドキュメントの頻度など) をグローバルに計算して、より一貫性のあるスコアリングを行うか、ローカルに計算するかを指定する値。待機時間を短縮します。デフォルトは「local」です。スコアリングの前にスコアリング統計をグローバルに集計するには、「global」を使用します。グローバルスコアリング統計を使用すると、検索クエリの待機時間が長くなる可能性があります。
search	string	全文検索クエリ式。「*」を使用するか、このパラメータを省略して、すべてのドキュメントに一致させます。
searchFields	string	フルテキスト検索の範囲を指定するフィールド名のコンマ区切りのリスト。完全な Lucene クエリでフィールド検索 (fieldName:searchExpression) を使用する場合、各フィールド検索式のフィールド名は、このパラメーターに記載されているフィールド名よりも優先されます。
searchMode	SearchMode	ドキュメントを一致としてカウントするために、検索語句の一部またはすべてを照合する必要があるかどうかを指定する値。
select	string	取得するフィールドのコンマ区切りリスト。指定しない場合、スキーマで取得可能としてマークされているすべてのフィールドが含まれます。
semanticConfiguration	string	セマンティック型のクエリのドキュメントを処理するときに使用されるセマンティック構成の名前。
semanticErrorHandling	SemanticErrorMode	セマンティック呼び出しを完全に失敗させるか (既定/現在の動作)、部分的な結果を返すかを選択できます。
semanticMaxWaitInMilliseconds	integer (int32) minimum: 700	ユーザーが、セマンティックエンリッチメントが要求が失敗するまでの処理が完了するまでにかかる時間の上限を設定できるようにします。
semanticQuery	string	セマンティックの再ランク付け、セマンティックキャプション、セマンティック回答にのみ使用される個別の検索クエリを設定できます。基本取得フェーズとランク付けフェーズと L2 セマンティックフェーズの間で異なるクエリを使用する必要があるシナリオに役立ちます。
sessionId	string	より一貫性のある結果を得るのに役立つスティッキーセッションを作成するために使用される値。同じ sessionId が使用されている限り、同じレプリカセットをターゲットにするためのベストエフォート試行が行われます。同じ sessionID 値を繰り返し再利用すると、レプリカ間での要求の負荷分散が妨げられる可能性があり、検索サービスのパフォーマンスに悪影響を及ぼす可能性があります。 sessionId として使用される値は、'_' 文字で始めることはできません。
skip	integer (int32)	スキップする検索結果の数。この値を 100,000 より大きくすることはできません。ドキュメントを順番にスキャンする必要があるが、この制限のためにスキップを使用できない場合は、完全に順序付けられたキーで orderby を使用し、代わりに範囲クエリでフィルター処理することを検討してください。
top	integer (int32)	取得する検索結果の数。これを$skipと組み合わせて使用して、検索結果のクライアント側ページングを実装できます。サーバー側のページングが原因で結果が切り捨てられた場合、応答には、結果の次のページに対して別の検索要求を発行するために使用できる継続トークンが含まれます。
vectorFilterMode	VectorFilterMode	ベクトル検索の実行前または実行後にフィルターを適用するかどうかを決定します。新しいインデックスのデフォルトは 'preFilter' です。
vectorQueries	VectorQuery[]: VectorizableImageBinaryQuery[] VectorizableImageUrlQuery[] VectorizableTextQuery[] VectorizedQuery[]	ベクター検索クエリとハイブリッド検索クエリのクエリパラメーター。

応答

名前	型	説明
200 OK	SearchDocumentsResult	要求は成功しました。
Other Status Codes	SearchDocumentsResult	成功
Other Status Codes	ErrorResponse	予期しないエラー応答。

セキュリティ

api-key

型: apiKey
/: header

OAuth2Auth

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/v2.0/authorize

スコープ

名前	説明
https://search.azure.com/.default

例

SearchIndexSearchDocumentsPost

SearchIndexSearchDocumentsSemanticPost

SearchIndexSearchDocumentsPost

要求のサンプル

HTTP

POST https://exampleservice.search.windows.net/indexes('test-index')/docs/search.post.search?api-version=2026-04-01


{
  "count": true,
  "facets": [
    "ownerId",
    "price,metric:sum,default:10"
  ],
  "filter": "category eq 'purple' or category eq 'pink'",
  "highlight": "category",
  "highlightPostTag": "</em>",
  "highlightPreTag": "</em>",
  "minimumCoverage": 100,
  "queryType": "semantic",
  "scoringStatistics": "global",
  "sessionId": "mysessionid",
  "scoringParameters": [
    "categoryTag:desiredCategoryValue"
  ],
  "scoringProfile": "stringFieldBoost",
  "debug": "vector",
  "search": "purple",
  "searchFields": "id,name,description,category,ownerId",
  "searchMode": "any",
  "select": "id,name,description,category,ownerId",
  "skip": 0,
  "top": 10,
  "semanticConfiguration": "testconfig",
  "semanticErrorHandling": "partial",
  "semanticMaxWaitInMilliseconds": 5000,
  "semanticQuery": "find all purple",
  "answers": "extractive",
  "captions": "extractive",
  "vectorQueries": [
    {
      "vector": [
        0,
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9
      ],
      "kind": "vector",
      "k": 50,
      "fields": "vector22, vector1b",
      "oversampling": 20,
      "weight": 1
    }
  ],
  "vectorFilterMode": "preFilter"
}

応答のサンプル

状態コード:: 200

{
  "@odata.count": 27,
  "@search.coverage": 100,
  "@search.facets": {
    "ownerId": [
      {
        "count": 16,
        "value": "sam"
      },
      {
        "count": 8,
        "value": "ryan"
      },
      {
        "count": 3,
        "value": "benny"
      }
    ],
    "price": [
      {
        "sum": 320
      }
    ]
  },
  "@search.answers": [],
  "value": [
    {
      "@search.score": 0.015625,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7178425788879395,
      "@search.rerankerBoostedScore": 1.7178425788879395,
      "@search.captions": [
        {
          "text": "test10 hello.",
          "highlights": ""
        }
      ],
      "id": "10",
      "name": "test",
      "description": "test10 hello",
      "category": "purple",
      "ownerId": "benny"
    },
    {
      "@search.score": 0.012820512987673283,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7079174518585205,
      "@search.rerankerBoostedScore": 1.7079174518585205,
      "@search.captions": [
        {
          "text": "no vector.",
          "highlights": "</em>no vector.</em>"
        }
      ],
      "id": "empty-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.011627906933426857,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7079174518585205,
      "@search.rerankerBoostedScore": 1.7079174518585205,
      "@search.captions": [
        {
          "text": "no vector.",
          "highlights": "</em>no vector.</em>"
        }
      ],
      "id": "no-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.011904762126505375,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6994102001190186,
      "@search.rerankerBoostedScore": 1.6994102001190186,
      "@search.captions": [
        {
          "text": "test4 hello.",
          "highlights": ""
        }
      ],
      "id": "4",
      "name": "test",
      "description": "test4 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.012345679104328156,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6937386989593506,
      "@search.rerankerBoostedScore": 1.6937386989593506,
      "@search.captions": [
        {
          "text": "test2 hello.",
          "highlights": ""
        }
      ],
      "id": "2",
      "name": "test",
      "description": "test2 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.0117647061124444,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6923208236694336,
      "@search.rerankerBoostedScore": 1.6923208236694336,
      "@search.captions": [
        {
          "text": "test5 hello.",
          "highlights": ""
        }
      ],
      "id": "5",
      "name": "test",
      "description": "test5 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.01666666753590107,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.691611886024475,
      "@search.rerankerBoostedScore": 1.691611886024475,
      "@search.captions": [
        {
          "text": "test7 hello.",
          "highlights": ""
        }
      ],
      "id": "7",
      "name": "test",
      "description": "test7 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.013698630034923553,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6781420707702637,
      "@search.rerankerBoostedScore": 1.6781420707702637,
      "@search.captions": [
        {
          "text": "test0 hello.",
          "highlights": ""
        }
      ],
      "id": "0",
      "name": "test",
      "description": "test0 hello",
      "category": "purple",
      "ownerId": "benny"
    },
    {
      "@search.score": 0.013888888992369175,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6653810739517212,
      "@search.rerankerBoostedScore": 1.6653810739517212,
      "@search.captions": [
        {
          "text": "test8 hello.",
          "highlights": ""
        }
      ],
      "id": "8",
      "name": "test",
      "description": "test8 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.012658228166401386,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6618363857269287,
      "@search.rerankerBoostedScore": 1.6618363857269287,
      "@search.captions": [
        {
          "text": "test11 hello.",
          "highlights": ""
        }
      ],
      "id": "11",
      "name": "test",
      "description": "test11 hello",
      "category": "purple",
      "ownerId": "sam"
    }
  ]
}

状態コード:: 206

{
  "@odata.count": 27,
  "@search.coverage": 100,
  "@search.facets": {
    "ownerId": [
      {
        "count": 16,
        "value": "sam"
      },
      {
        "count": 8,
        "value": "ryan"
      },
      {
        "count": 3,
        "value": "benny"
      }
    ],
    "price": [
      {
        "sum": 320
      }
    ]
  },
  "@search.answers": [],
  "value": [
    {
      "@search.score": 0.015625,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7178425788879395,
      "@search.rerankerBoostedScore": 1.7178425788879395,
      "@search.captions": [
        {
          "text": "test10 hello.",
          "highlights": ""
        }
      ],
      "id": "10",
      "name": "test",
      "description": "test10 hello",
      "category": "purple",
      "ownerId": "benny"
    },
    {
      "@search.score": 0.012820512987673283,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7079174518585205,
      "@search.rerankerBoostedScore": 1.7079174518585205,
      "@search.captions": [
        {
          "text": "no vector.",
          "highlights": "</em>no vector.</em>"
        }
      ],
      "id": "empty-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.011627906933426857,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7079174518585205,
      "@search.rerankerBoostedScore": 1.7079174518585205,
      "@search.captions": [
        {
          "text": "no vector.",
          "highlights": "</em>no vector.</em>"
        }
      ],
      "id": "no-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.011904762126505375,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6994102001190186,
      "@search.rerankerBoostedScore": 1.6994102001190186,
      "@search.captions": [
        {
          "text": "test4 hello.",
          "highlights": ""
        }
      ],
      "id": "4",
      "name": "test",
      "description": "test4 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.012345679104328156,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6937386989593506,
      "@search.rerankerBoostedScore": 1.6937386989593506,
      "@search.captions": [
        {
          "text": "test2 hello.",
          "highlights": ""
        }
      ],
      "id": "2",
      "name": "test",
      "description": "test2 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.0117647061124444,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6923208236694336,
      "@search.rerankerBoostedScore": 1.6923208236694336,
      "@search.captions": [
        {
          "text": "test5 hello.",
          "highlights": ""
        }
      ],
      "id": "5",
      "name": "test",
      "description": "test5 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.01666666753590107,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.691611886024475,
      "@search.rerankerBoostedScore": 1.691611886024475,
      "@search.captions": [
        {
          "text": "test7 hello.",
          "highlights": ""
        }
      ],
      "id": "7",
      "name": "test",
      "description": "test7 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.013698630034923553,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6781420707702637,
      "@search.rerankerBoostedScore": 1.6781420707702637,
      "@search.captions": [
        {
          "text": "test0 hello.",
          "highlights": ""
        }
      ],
      "id": "0",
      "name": "test",
      "description": "test0 hello",
      "category": "purple",
      "ownerId": "benny"
    },
    {
      "@search.score": 0.013888888992369175,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6653810739517212,
      "@search.rerankerBoostedScore": 1.6653810739517212,
      "@search.captions": [
        {
          "text": "test8 hello.",
          "highlights": ""
        }
      ],
      "id": "8",
      "name": "test",
      "description": "test8 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.012658228166401386,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6618363857269287,
      "@search.rerankerBoostedScore": 1.6618363857269287,
      "@search.captions": [
        {
          "text": "This is a caption from the document.",
          "highlights": "This is a <em>caption</em> from the document."
        }
      ],
      "id": "11",
      "name": "test",
      "description": "test11 hello",
      "category": "purple",
      "ownerId": "sam"
    }
  ]
}

SearchIndexSearchDocumentsSemanticPost

要求のサンプル

HTTP

POST https://myservice.search.windows.net/indexes('myindex')/docs/search.post.search?api-version=2026-04-01

{
  "count": true,
  "highlightPostTag": "</em>",
  "highlightPreTag": "<em>",
  "queryType": "semantic",
  "search": "how do clouds form",
  "semanticConfiguration": "my-semantic-config",
  "answers": "extractive|count-3",
  "captions": "extractive|highlight-true",
  "semanticErrorHandling": "partial",
  "semanticMaxWaitInMilliseconds": 780
}

応答のサンプル

状態コード:: 200

{
  "@odata.count": 25,
  "@search.answers": [
    {
      "key": "4123",
      "text": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form where air is ascending (over land in this case),   but not where it is descending (over the river).",
      "highlights": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form<em> where air is ascending</em> (over land in this case),   but not where it is<em> descending</em> (over the river).",
      "score": 0.94639826
    }
  ],
  "@search.nextPageParameters": {
    "count": true,
    "highlightPostTag": "</em>",
    "highlightPreTag": "<em>",
    "queryType": "semantic",
    "search": "how do clouds form",
    "semanticConfiguration": "my-semantic-config",
    "answers": "extractive|count-3",
    "captions": "extractive|highlight-true",
    "semanticErrorHandling": "partial",
    "semanticMaxWaitInMilliseconds": 780,
    "skip": 2,
    "top": 8
  },
  "value": [
    {
      "@search.score": 0.5479723,
      "@search.rerankerScore": 1.0321671911515296,
      "@search.captions": [
        {
          "text": "Like all clouds, it forms when the air reaches its dew point—the temperature at which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley fog, which is common in the Pacific Northwest of North America.",
          "highlights": "Like all<em> clouds</em>, it<em> forms</em> when the air reaches its dew point—the temperature at    which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley<em> fog</em>, which is common in the Pacific Northwest of North America."
        }
      ],
      "id": "4123",
      "title": "Earth Atmosphere",
      "content": "Fog is essentially a cloud lying on the ground. Like all clouds, it forms when the air reaches its dew point—the temperature at  \n\nwhich an air mass is cool enough for its water vapor to condense into liquid droplets.\n\nThis false-color image shows valley fog, which is common in the Pacific Northwest of North America. On clear winter nights, the \n\nground and overlying air cool off rapidly, especially at high elevations. Cold air is denser than warm air, and it sinks down into the \n\nvalleys. The moist air in the valleys gets chilled to its dew point, and fog forms. If undisturbed by winds, such fog may persist for \n\ndays. The Terra satellite captured this image of foggy valleys northeast of Vancouver in February 2010.\n\n\n",
      "locations": [
        "Pacific Northwest",
        "North America",
        "Vancouver"
      ]
    }
  ],
  "@odata.nextLink": "https://myservice.search.windows.net/indexes('myindex')/docs/search.post.search?api-version=2026-04-01"
}

状態コード:: 206

{
  "@odata.count": 25,
  "@search.answers": [
    {
      "key": "4123",
      "text": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form where air is ascending (over land in this case),   but not where it is descending (over the river).",
      "highlights": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form<em> where air is ascending</em> (over land in this case),   but not where it is<em> descending</em> (over the river).",
      "score": 0.94639826
    }
  ],
  "@search.nextPageParameters": {
    "count": true,
    "highlightPostTag": "</em>",
    "highlightPreTag": "<em>",
    "queryType": "semantic",
    "search": "how do clouds form",
    "semanticConfiguration": "my-semantic-config",
    "answers": "extractive|count-3",
    "captions": "extractive|highlight-true",
    "semanticErrorHandling": "partial",
    "semanticMaxWaitInMilliseconds": 780,
    "skip": 2,
    "top": 8
  },
  "value": [
    {
      "@search.score": 0.5479723,
      "@search.rerankerScore": 1.0321671911515296,
      "@search.captions": [
        {
          "text": "Like all clouds, it forms when the air reaches its dew point—the temperature at which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley fog, which is common in the Pacific Northwest of North America.",
          "highlights": "Like all<em> clouds</em>, it<em> forms</em> when the air reaches its dew point—the temperature at    which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley<em> fog</em>, which is common in the Pacific Northwest of North America."
        }
      ],
      "id": "4123",
      "title": "Earth Atmosphere",
      "content": "Fog is essentially a cloud lying on the ground. Like all clouds, it forms when the air reaches its dew point—the temperature at  \n\nwhich an air mass is cool enough for its water vapor to condense into liquid droplets.\n\nThis false-color image shows valley fog, which is common in the Pacific Northwest of North America. On clear winter nights, the \n\nground and overlying air cool off rapidly, especially at high elevations. Cold air is denser than warm air, and it sinks down into the \n\nvalleys. The moist air in the valleys gets chilled to its dew point, and fog forms. If undisturbed by winds, such fog may persist for \n\ndays. The Terra satellite captured this image of foggy valleys northeast of Vancouver in February 2010.\n\n\n",
      "locations": [
        "Pacific Northwest",
        "North America",
        "Vancouver"
      ]
    }
  ],
  "@odata.nextLink": "https://myservice.search.windows.net/indexes('myindex')/docs/search.post.search?api-version=2026-04-01"
}

定義

名前	説明
Accept	Acceptヘッダーです。
DocumentDebugInfo	検索結果をさらに探索するために使用できるデバッグ情報が含まれています。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。
QueryAnswerResult	回答は、クエリに一致した最も関連性の高いドキュメントの内容から抽出されたテキストの一節です。回答は上位の検索結果から抽出されます。回答候補がスコア付けされ、上位の回答が選択されます。
QueryAnswerType	このパラメータは、クエリタイプが `semantic`の場合にのみ有効です。設定した場合、クエリは、最もランクの高いドキュメントの主要な一節から抽出された回答を返します。返される回答の数は、パイプ文字 `\|` の後に answers パラメーター値の後に `count-<number of answers>` オプション ( `extractive\|count-3` など) を追加することで構成できます。デフォルトのカウントは 1 です。信頼度のしきい値は、パイプ文字 `\|` を付けて、answers パラメーター値の後に `threshold-<confidence threshold>` オプション ( `extractive\|threshold-0.9` など) を追加することで構成できます。デフォルトのしきい値は 0.7 です。回答の最大文字数は、パイプ文字 '\|' の後に 'count-<number of maximum character length>' (例: 'extractive\|maxcharlength-600') を追加することで構成できます。
QueryCaptionResult	キャプションは、ドキュメントから検索クエリまでの最も代表的な一節です。多くの場合、ドキュメントの概要として使用されます。キャプションは、`semantic`型のクエリに対してのみ返されます。
QueryCaptionType	このパラメータは、クエリタイプが `semantic`の場合にのみ有効です。設定した場合、クエリは、最もランクの高いドキュメントの主要な通路から抽出されたキャプションを返します。キャプションが `extractive` に設定されている場合、強調表示はデフォルトで有効になり、パイプ文字`\|`の後に `highlight-<true/false>` などの`extractive\|highlight-true` オプションを追加することで構成できます。既定値は `None` です。キャプションの最大文字長は、パイプ文字 '\|' の後に 'count-<number of maximum character length>' (例: 'extractive\|maxcharlength-600') を追加することで構成できます。
QueryDebugMode	検索結果をさらに調べるために使用できるデバッグツールを有効にします。複数のデバッグモードを \|文字 (例: semantic\|queryRewrites) です。
QueryResultDocumentSubscores	このドキュメントの検索クエリのテキストクエリコンポーネントとベクタークエリコンポーネント間のサブスコアの内訳。各ベクタークエリは、受信したのと同じ順序で個別のオブジェクトとして表示されます。
QueryType	検索クエリの構文を指定します。既定値は "simple" です。クエリで Lucene クエリ構文を使用する場合は 'full' を使用し、クエリ構文が必要ない場合は 'semantic' を使用します。
ScoringStatistics	スコアリングの統計情報 (ドキュメントの頻度など) をグローバルに計算して、より一貫性のあるスコアリングを行うか、ローカルに計算するかを指定する値。待機時間を短縮します。デフォルトは「local」です。スコアリングの前にスコアリング統計をグローバルに集計するには、「global」を使用します。グローバルスコアリング統計を使用すると、検索クエリの待機時間が長くなる可能性があります。
SearchDocumentsResult	インデックスからの検索結果を含む応答。
SearchMode	ドキュメントを一致としてカウントするために、検索語のいずれかまたはすべてを一致させる必要があるかどうかを指定します。
SearchRequest	フィルター処理、並べ替え、ファセット、ページング、およびその他の検索クエリ動作のパラメーター。
SearchResult	検索クエリによって検出されたドキュメントと、関連するメタデータが含まれます。
SemanticErrorMode	セマンティックコールを完全に失敗させるか、部分的な結果を返すかをユーザーが選択できます。
SemanticErrorReason	セマンティックランク付け要求に対して部分的な応答が返された理由。
SemanticSearchResultsType	セマンティックランク付け要求に対して返された部分応答の種類。
SingleVectorFieldResult	1 つのベクターフィールドの結果。両方
TextResult	クエリのテキスト部分の BM25 またはクラシックスコア。
VectorFilterMode	ベクトル検索の実行前または実行後にフィルターを適用するかどうかを決定します。
VectorizableImageBinaryQuery	ベクター化する必要があるイメージの base 64 でエンコードされたバイナリが指定されている場合に、ベクター検索に使用するクエリパラメーター。
VectorizableImageUrlQuery	ベクター化する必要がある画像値を表す URL が指定されている場合に、ベクター検索に使用するクエリパラメーター。
VectorizableTextQuery	ベクター化する必要があるテキスト値が指定されている場合にベクター検索に使用するクエリパラメーター。
VectorizedQuery	生のベクター値が指定されたときにベクター検索に使用するクエリパラメーター。
VectorQueryKind	実行されているベクトルクエリの種類。
VectorsDebugInfo	「ベクトルおよびハイブリッド探索に特化したデバッグ情報を含みます。」)

Accept

列挙

Acceptヘッダーです。

値	説明
application/json;odata.metadata=none

DocumentDebugInfo

Object

検索結果をさらに探索するために使用できるデバッグ情報が含まれています。

名前	型	説明
vectors	VectorsDebugInfo	ベクター検索とハイブリッド検索に固有のデバッグ情報が含まれています。

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info		追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

QueryAnswerResult

Object

回答は、クエリに一致した最も関連性の高いドキュメントの内容から抽出されたテキストの一節です。回答は上位の検索結果から抽出されます。回答候補がスコア付けされ、上位の回答が選択されます。

名前	型	説明
highlights	string	クエリに最も関連性の高い強調表示されたテキストフレーズを含む Text プロパティと同じテキストの一節。
key	string	回答が抽出されたドキュメントのキー。
score	number (double)	スコア値は、クエリに対して返される他の回答に対するクエリに対する回答の関連性を表します。
text	string	ドキュメントの内容から回答として抽出されたテキストの一節。

QueryAnswerType

列挙

このパラメータは、クエリタイプが semanticの場合にのみ有効です。設定した場合、クエリは、最もランクの高いドキュメントの主要な一節から抽出された回答を返します。返される回答の数は、パイプ文字 | の後に answers パラメーター値の後に count-<number of answers> オプション ( extractive|count-3 など) を追加することで構成できます。デフォルトのカウントは 1 です。信頼度のしきい値は、パイプ文字 | を付けて、answers パラメーター値の後に threshold-<confidence threshold> オプション ( extractive|threshold-0.9 など) を追加することで構成できます。デフォルトのしきい値は 0.7 です。回答の最大文字数は、パイプ文字 '|' の後に 'count-<number of maximum character length>' (例: 'extractive|maxcharlength-600') を追加することで構成できます。

値	説明
none	クエリの回答を返さないでください。
extractive	自然言語で質問として表現されたクエリに応答して返されたドキュメントの内容から回答候補を抽出します。

QueryCaptionResult

Object

キャプションは、ドキュメントから検索クエリまでの最も代表的な一節です。多くの場合、ドキュメントの概要として使用されます。キャプションは、semantic型のクエリに対してのみ返されます。

名前	型	説明
highlights	string	クエリに最も関連する強調表示された語句を含む Text プロパティと同じテキストの一節。
text	string	検索クエリに最も関連性の高いドキュメントから抽出された代表的なテキストの一節。

QueryCaptionType

列挙

このパラメータは、クエリタイプが semanticの場合にのみ有効です。設定した場合、クエリは、最もランクの高いドキュメントの主要な通路から抽出されたキャプションを返します。キャプションが extractive に設定されている場合、強調表示はデフォルトで有効になり、パイプ文字|の後に highlight-<true/false> などのextractive|highlight-true オプションを追加することで構成できます。既定値は None です。キャプションの最大文字長は、パイプ文字 '|' の後に 'count-<number of maximum character length>' (例: 'extractive|maxcharlength-600') を追加することで構成できます。

値	説明
none	クエリのキャプションを返さないでください。
extractive	検索クエリに関連する一節を含む一致するドキュメントからキャプションを抽出します。

QueryDebugMode

列挙

検索結果をさらに調べるために使用できるデバッグツールを有効にします。複数のデバッグモードを |文字 (例: semantic|queryRewrites) です。

値	説明
disabled	クエリデバッグ情報は返されません。
semantic	ユーザーが再ランク付けされた結果をさらに探索できるようにします。
vector	ユーザーがハイブリッドクエリとベクタークエリの結果をさらに探索できるようにします。
queryRewrites	ユーザーが検索要求に対して生成されたクエリ書き換えの一覧を調べることができます。
innerHits	ユーザーは、複合型のコレクション内で一致するベクトルに関するスコアリング情報を取得できます。
all	すべてのデバッグオプションをオンにします。

QueryResultDocumentSubscores

Object

このドキュメントの検索クエリのテキストクエリコンポーネントとベクタークエリコンポーネント間のサブスコアの内訳。各ベクタークエリは、受信したのと同じ順序で個別のオブジェクトとして表示されます。

名前	型	説明
documentBoost	number (double)	クエリのテキスト部分の BM25 またはクラシックスコア。
text	TextResult	クエリのテキスト部分の BM25 またはクラシックスコア。
vectors	<string, SingleVectorFieldResult>	ベクトル類似性と

QueryType

列挙

検索クエリの構文を指定します。既定値は "simple" です。クエリで Lucene クエリ構文を使用する場合は 'full' を使用し、クエリ構文が必要ない場合は 'semantic' を使用します。

値	説明
simple	検索には単純なクエリ構文を使用します。検索テキストは、+、*、"" などの記号を使用できる単純なクエリ言語を使用して解釈されます。クエリは、searchFields パラメーターが指定されていない限り、既定ですべての検索可能なフィールドで評価されます。
full	検索に完全なLuceneクエリ構文を使用します。検索テキストは、フィールド固有の重み付けされた検索やその他の高度な機能を可能にするLuceneクエリ言語を使用して解釈されます。
semantic	キーワードではなく自然言語で表現されるクエリに最適です。 Webコーパスで学習したランキングモデルを使用して、上位の検索結果を再ランク付けすることで、検索結果の精度を向上させます。

ScoringStatistics

列挙

スコアリングの統計情報 (ドキュメントの頻度など) をグローバルに計算して、より一貫性のあるスコアリングを行うか、ローカルに計算するかを指定する値。待機時間を短縮します。デフォルトは「local」です。スコアリングの前にスコアリング統計をグローバルに集計するには、「global」を使用します。グローバルスコアリング統計を使用すると、検索クエリの待機時間が長くなる可能性があります。

値	説明
local	スコアリング統計は、待機時間を短縮するためにローカルで計算されます。
global	スコアリング統計は、より一貫したスコアリングのためにグローバルに計算されます。

SearchDocumentsResult

Object

インデックスからの検索結果を含む応答。

名前	型	説明
@odata.count	integer (int64)	検索操作によって検出された結果の合計数。カウントが要求されなかった場合は null。存在する場合は、この応答の結果の数よりもカウントが大きくなる可能性があります。これは、$top パラメーターまたは $skip パラメーターを使用する場合、またはクエリが 1 つの応答で要求されたすべてのドキュメントを返すことができない場合に発生する可能性があります。
@odata.nextLink	string	クエリが要求されたすべての結果を 1 つの応答で返すことができない場合に返される継続 URL。この URL を使用して、別の GET または POST 検索要求を作成し、検索応答の次の部分を取得できます。この応答を生成した要求と同じ動詞 (GET または POST) を使用してください。
@search.answers	QueryAnswerResult[]	検索操作のクエリ結果に回答します。応答クエリパラメーターが指定されていない場合、または 'none' に設定されている場合は null。
@search.coverage	number (double)	クエリに含まれていたインデックスの割合を示す値。minimumCoverage が要求で指定されていない場合は null。
@search.facets	object	各ファセットフィールドのバケットのコレクションとして編成された検索操作のファセットクエリ結果。クエリにファセット式が含まれていない場合は null。
@search.nextPageParameters	SearchRequest	継続 JSON ペイロードは、クエリが要求されたすべての結果を 1 つの応答で返すことができない場合に返されます。このJSONを以下と組み合わせて使うことができます。
@search.semanticPartialResponseReason	SemanticErrorReason	セマンティックランク付け要求に対して部分的な応答が返された理由。
@search.semanticPartialResponseType	SemanticSearchResultsType	セマンティックランク付け要求に対して返された部分応答の種類。
value	SearchResult[]	クエリによって返される結果のシーケンス。

SearchMode

列挙

ドキュメントを一致としてカウントするために、検索語のいずれかまたはすべてを一致させる必要があるかどうかを指定します。

値	説明
any	ドキュメントを一致としてカウントするには、いずれかの検索語が一致する必要があります。
all	ドキュメントを一致としてカウントするには、すべての検索用語が一致する必要があります。

SearchRequest

Object

フィルター処理、並べ替え、ファセット、ページング、およびその他の検索クエリ動作のパラメーター。

名前	型	説明
answers	QueryAnswerType	検索応答の一部として回答を返す必要があるかどうかを指定する値。
captions	QueryCaptionType	キャプションを検索応答の一部として返す必要があるかどうかを指定する値。
count	boolean	結果の合計数をフェッチするかどうかを指定する値。既定値は falseです。この値を true に設定すると、パフォーマンスに影響する可能性があります。返されるカウントは近似値であることに注意してください。
debug	QueryDebugMode	ランク付けされた結果をさらに調査するために使用できるデバッグツールを有効にします。
facets	string[]	検索クエリに適用するファセット式の一覧。各ファセット式にはフィールド名が含まれます。必要に応じて、名前と値のペアのコンマ区切りのリストが続きます。
filter	string	検索クエリに適用する OData $filter式。
highlight	string	ヒット強調表示に使用するフィールド名のコンマ区切りのリスト。検索可能なフィールドのみを、ヒット強調表示に使用できます。
highlightPostTag	string	ヒットハイライトに追加される文字列タグ。 highlightPreTag を使用して設定する必要があります。既定値は /em<>です。
highlightPreTag	string	強調表示をヒットする前に付加される文字列タグ。 highlightPostTag を使用して設定する必要があります。既定値は <em>です。
minimumCoverage	number (double)	クエリを成功として報告するために検索クエリでカバーする必要があるインデックスの割合を示す 0 ~ 100 の数値。このパラメーターは、レプリカが 1 つだけのサービスでも検索の可用性を確保するのに役立ちます。既定値は 100 です。
orderby	string	結果を並べ替えるための OData $orderby式のコンマ区切りリスト。各式には、フィールド名または geo.distance() 関数または search.score() 関数の呼び出しを指定できます。各式の後に asc を付けて昇順を示すか、降順を示す desc を指定できます。既定値は昇順です。同点は、ドキュメントのマッチスコアによって分割されます。 $orderbyが指定されていない場合、既定の並べ替え順序はドキュメントの一致スコアの降順になります。最大で 32 個の$orderby句があります。
queryType	QueryType	検索クエリの構文を指定する値。既定値は "simple" です。クエリで Lucene クエリ構文を使用する場合は、'full' を使用します。
scoringParameters	string[]	形式名と値を使用してスコアリング関数 (referencePointParameter など) で使用するパラメーター値の一覧。たとえば、スコアリングプロファイルで "mylocation" というパラメーターを持つ関数が定義されている場合、パラメーター文字列は "mylocation-122.2,44.8" になります (引用符は使用しません)。
scoringProfile	string	結果を並べ替えるために一致するドキュメントの一致スコアを評価するスコアリングプロファイルの名前。
scoringStatistics	ScoringStatistics	スコアリングの統計情報 (ドキュメントの頻度など) をグローバルに計算して、より一貫性のあるスコアリングを行うか、ローカルに計算するかを指定する値。待機時間を短縮します。デフォルトは「local」です。スコアリングの前にスコアリング統計をグローバルに集計するには、「global」を使用します。グローバルスコアリング統計を使用すると、検索クエリの待機時間が長くなる可能性があります。
search	string	全文検索クエリ式。「*」を使用するか、このパラメータを省略して、すべてのドキュメントに一致させます。
searchFields	string	フルテキスト検索の範囲を指定するフィールド名のコンマ区切りのリスト。完全な Lucene クエリでフィールド検索 (fieldName:searchExpression) を使用する場合、各フィールド検索式のフィールド名は、このパラメーターに記載されているフィールド名よりも優先されます。
searchMode	SearchMode	ドキュメントを一致としてカウントするために、検索語句の一部またはすべてを照合する必要があるかどうかを指定する値。
select	string	取得するフィールドのコンマ区切りリスト。指定しない場合、スキーマで取得可能としてマークされているすべてのフィールドが含まれます。
semanticConfiguration	string	セマンティック型のクエリのドキュメントを処理するときに使用されるセマンティック構成の名前。
semanticErrorHandling	SemanticErrorMode	セマンティック呼び出しを完全に失敗させるか (既定/現在の動作)、部分的な結果を返すかを選択できます。
semanticMaxWaitInMilliseconds	integer (int32) minimum: 700	ユーザーが、セマンティックエンリッチメントが要求が失敗するまでの処理が完了するまでにかかる時間の上限を設定できるようにします。
semanticQuery	string	セマンティックの再ランク付け、セマンティックキャプション、セマンティック回答にのみ使用される個別の検索クエリを設定できます。基本取得フェーズとランク付けフェーズと L2 セマンティックフェーズの間で異なるクエリを使用する必要があるシナリオに役立ちます。
sessionId	string	より一貫性のある結果を得るのに役立つスティッキーセッションを作成するために使用される値。同じ sessionId が使用されている限り、同じレプリカセットをターゲットにするためのベストエフォート試行が行われます。同じ sessionID 値を繰り返し再利用すると、レプリカ間での要求の負荷分散が妨げられる可能性があり、検索サービスのパフォーマンスに悪影響を及ぼす可能性があります。 sessionId として使用される値は、'_' 文字で始めることはできません。
skip	integer (int32)	スキップする検索結果の数。この値を 100,000 より大きくすることはできません。ドキュメントを順番にスキャンする必要があるが、この制限のためにスキップを使用できない場合は、完全に順序付けられたキーで orderby を使用し、代わりに範囲クエリでフィルター処理することを検討してください。
top	integer (int32)	取得する検索結果の数。これを$skipと組み合わせて使用して、検索結果のクライアント側ページングを実装できます。サーバー側のページングが原因で結果が切り捨てられた場合、応答には、結果の次のページに対して別の検索要求を発行するために使用できる継続トークンが含まれます。
vectorFilterMode	VectorFilterMode	ベクトル検索の実行前または実行後にフィルターを適用するかどうかを決定します。新しいインデックスのデフォルトは 'preFilter' です。
vectorQueries	VectorQuery[]: VectorizableImageBinaryQuery[] VectorizableImageUrlQuery[] VectorizableTextQuery[] VectorizedQuery[]	ベクター検索クエリとハイブリッド検索クエリのクエリパラメーター。

SearchResult

Object

検索クエリによって検出されたドキュメントと、関連するメタデータが含まれます。

名前	型	説明
@search.captions	QueryCaptionResult[]	キャプションは、ドキュメントから検索クエリまでの最も代表的な一節です。多くの場合、ドキュメントの概要として使用されます。キャプションは、'semantic' 型のクエリに対してのみ返されます。
@search.documentDebugInfo	DocumentDebugInfo	検索結果をさらに探索するために使用できるデバッグ情報が含まれています。
@search.highlights	object	一致する検索語を示すドキュメントからのテキストフラグメントを、該当する各フィールドで整理します。クエリでヒットの強調表示が有効になっていない場合は null。
@search.rerankerBoostedScore	number (double)	リランカースコアをブーストして計算された関連性スコア。検索結果は、セマンティック設定内のuseScoringProfileBoostedRankingに基づいてRerankerScore/RerankerBoostedScoreで並べ替えられます。RerankerBoostedScoreは「semantic」型のクエリにのみ返されます。
@search.rerankerScore	number (double)	上位の検索結果のセマンティックランカーによって計算された関連性スコア。検索結果は、最初に RerankerScore で並べ替えられ、次に Score で並べ替えられます。 RerankerScore は、'semantic' 型のクエリに対してのみ返されます。
@search.score	number (double)	クエリによって返された他のドキュメントと比較したドキュメントの関連性スコア。

SemanticErrorMode

列挙

セマンティックコールを完全に失敗させるか、部分的な結果を返すかをユーザーが選択できます。

値	説明
partial	セマンティック処理が失敗した場合でも、部分的な結果が返されます。部分的な結果の定義は、失敗したセマンティックステップと失敗の理由によって異なります。
fail	セマンティック処理手順中に例外がある場合、クエリは失敗し、エラーに応じて適切な HTTP コードが返されます。

SemanticErrorReason

列挙

セマンティックランク付け要求に対して部分的な応答が返された理由。

値	説明
maxWaitExceeded	`semanticMaxWaitInMilliseconds` が設定され、セマンティック処理期間がその値を超えた場合。基本結果のみが返されました。
capacityOverloaded	要求が調整されました。基本結果のみが返されました。
transient	セマンティックプロセスの少なくとも 1 つのステップが失敗しました。

SemanticSearchResultsType

列挙

セマンティックランク付け要求に対して返された部分応答の種類。

値	説明
baseResults	セマンティックエンリッチメントや再ランク付けのない結果。
rerankedResults	結果は再ランカーモデルで再ランク付けされ、セマンティックキャプションが含まれます。回答、回答のハイライト、キャプションの強調表示は含まれません。

SingleVectorFieldResult

Object

1 つのベクターフィールドの結果。両方

名前	型	説明
searchScore	number (double)	その
vectorSimilarity	number (double)	このドキュメントのベクトル類似性スコア。これは、'distance' バージョンではなく、類似性メトリックの正規の定義であることに注意してください。たとえば、コサイン距離の代わりにコサイン類似度などです。

TextResult

Object

クエリのテキスト部分の BM25 またはクラシックスコア。

名前	型	説明
searchScore	number (double)	クエリのテキスト部分の BM25 またはクラシックスコア。

VectorFilterMode

列挙

ベクトル検索の実行前または実行後にフィルターを適用するかどうかを決定します。

値	説明
postFilter	フィルターは、ベクター結果の候補セットが返された後に適用されます。フィルターの選択度によっては、パラメーター 'k' によって要求された結果よりも結果が少なくなる可能性があります。
preFilter	フィルターは、検索クエリの前に適用されます。
strictPostFilter	フィルターは、ベクトル結果のグローバルトップ k 候補セットが返された後に適用されます。これにより、パラメーター 'k' によって要求される結果よりも少なくなります。

VectorizableImageBinaryQuery

Object

ベクター化する必要があるイメージの base 64 でエンコードされたバイナリが指定されている場合に、ベクター検索に使用するクエリパラメーター。

名前	型	説明
base64Image	string	ベクトル検索クエリを実行するためにベクトル化される画像の基数 64 でエンコードされたバイナリ。
exhaustive	boolean	true の場合、ベクトルインデックス内のすべてのベクトルに対して、完全な k ニアレストネイバー検索がトリガーされます。地上の真偽値の決定など、完全一致が重要なシナリオに役立ちます。
fields	string	検索されるベクトルに含める Collection(Edm.Single) 型のベクターフィールド。
k	integer (int32)	トップヒットとして返される最も近いネイバーの数。
kind	string: imageBinary	クエリの種類。
oversampling	number (double)	オーバーサンプリング係数。最低値が1です。インデックス定義で構成されている 'defaultOversampling' パラメーターをオーバーライドします。 'rerankWithOriginalVectors' が true の場合にのみ設定できます。このパラメーターは、基になるベクターフィールドで圧縮メソッドを使用する場合にのみ使用できます。
weight	number (float)	同じ検索要求内の他のベクタークエリやテキストクエリと比較した場合のベクタークエリの相対的な重み。この値は、さまざまなベクタークエリによって生成された複数のランク付けリストの結果や、テキストクエリを使用して取得された結果を組み合わせる場合に使用されます。重みが大きいほど、そのクエリに一致したドキュメントが最終的なランク付けになります。既定値は 1.0 で、値は 0 より大きい正の数値である必要があります。

VectorizableImageUrlQuery

Object

ベクター化する必要がある画像値を表す URL が指定されている場合に、ベクター検索に使用するクエリパラメーター。

名前	型	説明
exhaustive	boolean	true の場合、ベクトルインデックス内のすべてのベクトルに対して、完全な k ニアレストネイバー検索がトリガーされます。地上の真偽値の決定など、完全一致が重要なシナリオに役立ちます。
fields	string	検索されるベクトルに含める Collection(Edm.Single) 型のベクターフィールド。
k	integer (int32)	トップヒットとして返される最も近いネイバーの数。
kind	string: imageUrl	クエリの種類。
oversampling	number (double)	オーバーサンプリング係数。最低値が1です。インデックス定義で構成されている 'defaultOversampling' パラメーターをオーバーライドします。 'rerankWithOriginalVectors' が true の場合にのみ設定できます。このパラメーターは、基になるベクターフィールドで圧縮メソッドを使用する場合にのみ使用できます。
url	string	ベクトル検索クエリを実行するためにベクトル化される画像の URL。
weight	number (float)	同じ検索要求内の他のベクタークエリやテキストクエリと比較した場合のベクタークエリの相対的な重み。この値は、さまざまなベクタークエリによって生成された複数のランク付けリストの結果や、テキストクエリを使用して取得された結果を組み合わせる場合に使用されます。重みが大きいほど、そのクエリに一致したドキュメントが最終的なランク付けになります。既定値は 1.0 で、値は 0 より大きい正の数値である必要があります。

VectorizableTextQuery

Object

ベクター化する必要があるテキスト値が指定されている場合にベクター検索に使用するクエリパラメーター。

名前	型	説明
exhaustive	boolean	true の場合、ベクトルインデックス内のすべてのベクトルに対して、完全な k ニアレストネイバー検索がトリガーされます。地上の真偽値の決定など、完全一致が重要なシナリオに役立ちます。
fields	string	検索されるベクトルに含める Collection(Edm.Single) 型のベクターフィールド。
k	integer (int32)	トップヒットとして返される最も近いネイバーの数。
kind	string: text	クエリの種類。
oversampling	number (double)	オーバーサンプリング係数。最低値が1です。インデックス定義で構成されている 'defaultOversampling' パラメーターをオーバーライドします。 'rerankWithOriginalVectors' が true の場合にのみ設定できます。このパラメーターは、基になるベクターフィールドで圧縮メソッドを使用する場合にのみ使用できます。
text	string	ベクター検索クエリを実行するためにベクター化されるテキスト。
weight	number (float)	同じ検索要求内の他のベクタークエリやテキストクエリと比較した場合のベクタークエリの相対的な重み。この値は、さまざまなベクタークエリによって生成された複数のランク付けリストの結果や、テキストクエリを使用して取得された結果を組み合わせる場合に使用されます。重みが大きいほど、そのクエリに一致したドキュメントが最終的なランク付けになります。既定値は 1.0 で、値は 0 より大きい正の数値である必要があります。

VectorizedQuery

Object

生のベクター値が指定されたときにベクター検索に使用するクエリパラメーター。

名前	型	説明
exhaustive	boolean	true の場合、ベクトルインデックス内のすべてのベクトルに対して、完全な k ニアレストネイバー検索がトリガーされます。地上の真偽値の決定など、完全一致が重要なシナリオに役立ちます。
fields	string	検索されるベクトルに含める Collection(Edm.Single) 型のベクターフィールド。
k	integer (int32)	トップヒットとして返される最も近いネイバーの数。
kind	string: vector	クエリの種類。
oversampling	number (double)	オーバーサンプリング係数。最低値が1です。インデックス定義で構成されている 'defaultOversampling' パラメーターをオーバーライドします。 'rerankWithOriginalVectors' が true の場合にのみ設定できます。このパラメーターは、基になるベクターフィールドで圧縮メソッドを使用する場合にのみ使用できます。
vector	number[] (float)	検索クエリのベクター表現。
weight	number (float)	同じ検索要求内の他のベクタークエリやテキストクエリと比較した場合のベクタークエリの相対的な重み。この値は、さまざまなベクタークエリによって生成された複数のランク付けリストの結果や、テキストクエリを使用して取得された結果を組み合わせる場合に使用されます。重みが大きいほど、そのクエリに一致したドキュメントが最終的なランク付けになります。既定値は 1.0 で、値は 0 より大きい正の数値である必要があります。

VectorQueryKind

列挙

実行されているベクトルクエリの種類。

値	説明
vector	生のベクター値が提供されるベクタークエリ。
text	ベクター化する必要があるテキスト値が提供されるベクタークエリ。
imageUrl	ベクトル化が必要な画像値を表すURLを提供するベクトルクエリ。
imageBinary	ベクトル化が必要な画像の基64でエンコードされたバイナリを提供するベクトルクエリ。

VectorsDebugInfo

Object

「ベクトルおよびハイブリッド探索に特化したデバッグ情報を含みます。」)

名前	型	説明
subscores	QueryResultDocumentSubscores	RRF などの選択した結果セットの融合/組み合わせ方法の前のドキュメントのサブスコアの内訳。