Documents - Search Post

Layanan:

Search Service

Versi API:

2025-08-01-preview

Mencari dokumen dalam indeks.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string	URL titik akhir layanan pencarian.
indexName	path	True	string	Nama indeks.
api-version	query	True	string	Versi API Klien.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
x-ms-client-request-id		string (uuid)	ID pelacakan yang dikirim dengan permintaan untuk membantu penelusuran kesalahan.
x-ms-query-source-authorization		string	Token yang mengidentifikasi pengguna tempat kueri sedang dijalankan. Token ini digunakan untuk menegakkan pembatasan keamanan pada dokumen.

Isi Permintaan

Nama	Jenis	Deskripsi
answers	QueryAnswerType	Nilai yang menentukan apakah jawaban harus ditampilkan sebagai bagian dari respons penelusuran.
captions	QueryCaptionType	Nilai yang menentukan apakah teks harus ditampilkan sebagai bagian dari respons penelusuran.
count	boolean	Nilai yang menentukan apakah akan mengambil jumlah total hasil. Secara default adalah false. Menetapkan nilai ini ke true mungkin berdampak pada performa. Perhatikan bahwa hitungan yang dikembalikan adalah perkiraan.
debug	QueryDebugMode	Mengaktifkan alat debugging yang dapat digunakan untuk menjelajahi hasil peringkat ulang Anda lebih lanjut.
facets	string[]	Daftar ekspresi aspek yang akan diterapkan ke kueri pencarian. Setiap ekspresi aspek berisi nama bidang, secara opsional diikuti oleh daftar pasangan nama:nilai yang dipisahkan koma.
filter	string	OData $filter ekspresi untuk diterapkan ke kueri pencarian.
highlight	string	Daftar nama bidang yang dipisahkan koma untuk digunakan untuk sorotan klik. Hanya bidang yang dapat dicari yang dapat digunakan untuk penyorotan klik.
highlightPostTag	string	Tag string yang ditambahkan ke sorotan klik. Harus diatur dengan highlightPreTag. Defaultnya adalah </em>.
highlightPreTag	string	Tag string yang dilanjutkan untuk menekan sorotan. Harus diatur dengan highlightPostTag. Defaultnya adalah <em>.
hybridSearch	HybridSearch	Parameter kueri untuk mengonfigurasi perilaku pencarian hibrid.
minimumCoverage	number (double)	Angka antara 0 dan 100 yang menunjukkan persentase indeks yang harus dicakup oleh kueri pencarian agar kueri dilaporkan sebagai keberhasilan. Parameter ini dapat berguna untuk memastikan ketersediaan pencarian bahkan untuk layanan dengan hanya satu replika. Nilai defaultnya adalah 100.
orderby	string	Daftar ekspresi OData $orderby yang dipisahkan koma untuk mengurutkan hasilnya. Setiap ekspresi dapat berupa nama bidang atau panggilan ke fungsi geo.distance() atau search.score(). Setiap ekspresi dapat diikuti oleh asc untuk menunjukkan naik, atau desc untuk menunjukkan turun. Defaultnya adalah urutan menaik. Ikatan akan diputuskan oleh skor pertandingan dokumen. Jika tidak ada $orderby yang ditentukan, urutan pengurutan default adalah menurun berdasarkan skor kecocokan dokumen. Mungkin ada paling banyak 32 klausa $orderby.
queryLanguage	QueryLanguage	Nilai yang menentukan bahasa kueri pencarian.
queryRewrites	QueryRewritesType	Nilai yang menentukan apakah penulisan ulang kueri harus dihasilkan untuk menambah kueri pencarian.
queryType	QueryType	Nilai yang menentukan sintaks kueri pencarian. Defaultnya adalah 'sederhana'. Gunakan 'full' jika kueri Anda menggunakan sintaks kueri Lucene.
scoringParameters	string[]	Daftar nilai parameter yang akan digunakan dalam fungsi penilaian (misalnya, referencePointParameter) menggunakan format name-values. Misalnya, jika profil penilaian mendefinisikan fungsi dengan parameter yang disebut 'mylocation', string parameter akan menjadi "mylocation--122.2,44.8" (tanpa tanda kutip).
scoringProfile	string	Nama profil penilaian untuk mengevaluasi skor kecocokan untuk dokumen yang cocok untuk mengurutkan hasil.
scoringStatistics	ScoringStatistics	Nilai yang menentukan apakah kita ingin menghitung statistik penilaian (seperti frekuensi dokumen) secara global untuk penilaian yang lebih konsisten, atau secara lokal, untuk latensi yang lebih rendah. Defaultnya adalah 'lokal'. Gunakan 'global' untuk menggabungkan statistik penilaian secara global sebelum mencetak gol. Menggunakan statistik penilaian global dapat meningkatkan latensi kueri pencarian.
search	string	Ekspresi kueri pencarian teks lengkap; Gunakan "*" atau hilangkan parameter ini agar cocok dengan semua dokumen.
searchFields	string	Daftar nama bidang yang dipisahkan koma untuk mencakupan pencarian teks lengkap. Saat menggunakan pencarian bidang (fieldName:searchExpression) dalam kueri Lucene penuh, nama bidang dari setiap ekspresi pencarian kolom lebih diutamakan daripada nama bidang apa pun yang tercantum dalam parameter ini.
searchMode	SearchMode	Nilai yang menentukan apakah salah satu atau semua istilah pencarian harus dicocokkan untuk menghitung dokumen sebagai kecocokan.
select	string	Daftar bidang yang dipisahkan koma untuk diambil. Jika tidak ditentukan, semua bidang yang ditandai sebagai dapat diambil dalam skema disertakan.
semanticConfiguration	string	Nama konfigurasi semantik yang akan digunakan saat memproses dokumen untuk kueri jenis semantik.
semanticErrorHandling	SemanticErrorMode	Memungkinkan pengguna untuk memilih apakah panggilan semantik harus gagal sepenuhnya (perilaku default / saat ini), atau untuk mengembalikan hasil parsial.
semanticFields	string	Daftar nama bidang yang dipisahkan koma yang digunakan untuk peringkat semantik.
semanticMaxWaitInMilliseconds	integer (int32) minimum: 700	Memungkinkan pengguna untuk menetapkan batas atas pada jumlah waktu yang dibutuhkan pengayaan semantik untuk menyelesaikan pemrosesan sebelum permintaan gagal.
semanticQuery	string	Memungkinkan pengaturan kueri pencarian terpisah yang hanya akan digunakan untuk peringkat ulang semantik, keterangan semantik, dan jawaban semantik. Berguna untuk skenario di mana ada kebutuhan untuk menggunakan kueri yang berbeda antara fase pengambilan dasar dan peringkat, dan fase semantik L2.
sessionId	string	Nilai yang akan digunakan untuk membuat sesi lengket, yang dapat membantu mendapatkan hasil yang lebih konsisten. Selama sessionId yang sama digunakan, upaya upaya terbaik akan dilakukan untuk menargetkan set replika yang sama. Berhati-hatilah karena menggunakan kembali nilai sessionID yang sama berulang kali dapat mengganggu penyeimbangan beban permintaan di seluruh replika dan berdampak buruk pada performa layanan pencarian. Nilai yang digunakan sebagai sessionId tidak dapat dimulai dengan karakter '_'.
skip	integer (int32)	Jumlah hasil pencarian yang harus dilewati. Nilai ini tidak boleh lebih besar dari 100.000. Jika Anda perlu memindai dokumen secara berurutan, tetapi tidak dapat menggunakan lewati karena batasan ini, pertimbangkan untuk menggunakan orderby pada kunci yang diurutkan sepenuhnya dan filter dengan kueri rentang.
speller	QuerySpellerType	Nilai yang menentukan jenis ejaan yang akan digunakan untuk mengoreksi ejaan istilah kueri pencarian individual.
top	integer (int32)	Jumlah hasil pencarian yang akan diambil. Ini dapat digunakan bersama dengan $skip untuk menerapkan paging hasil pencarian sisi klien. Jika hasil terpotong karena paging sisi server, respons akan menyertakan token kelanjutan yang dapat digunakan untuk mengeluarkan permintaan Pencarian lain untuk halaman hasil berikutnya.
vectorFilterMode	VectorFilterMode	Menentukan apakah filter diterapkan sebelum atau sesudah pencarian vektor dilakukan atau tidak. Defaultnya adalah 'preFilter' untuk indeks baru.
vectorQueries	VectorQuery[]: RawVectorQuery[] VectorizableTextQuery[] VectorizableImageUrlQuery[] VectorizableImageBinaryQuery[]	Parameter kueri untuk kueri pencarian vektor dan hibrid.

Respons

Nama	Jenis	Deskripsi
200 OK	SearchDocumentsResult	Respons yang berisi dokumen yang cocok dengan kriteria pencarian.
Other Status Codes	SearchDocumentsResult	Respons yang berisi dokumen parsial yang cocok dengan kriteria pencarian.
Other Status Codes	ErrorResponse	Respons kesalahan.

Contoh

SearchIndexSearchDocumentsPost

SearchIndexSearchDocumentsSemanticPost

SearchIndexSearchDocumentsPost

Permintaan sampel

HTTP

POST https://previewexampleservice.search.windows.net/indexes('preview-test')/docs/search.post.search?api-version=2025-08-01-preview



{
  "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",
  "queryLanguage": "en-us",
  "speller": "lexicon",
  "select": "id,name,description,category,ownerId",
  "skip": 0,
  "top": 10,
  "semanticConfiguration": "testconfig",
  "semanticErrorHandling": "partial",
  "semanticMaxWaitInMilliseconds": 5000,
  "semanticQuery": "find all purple",
  "answers": "extractive",
  "captions": "extractive",
  "queryRewrites": "generative",
  "vectorQueries": [
    {
      "vector": [
        0,
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9
      ],
      "kind": "vector",
      "k": 50,
      "fields": "vector22, vector1b",
      "oversampling": 20,
      "weight": 1,
      "threshold": {
        "value": 0.984,
        "kind": "vectorSimilarity"
      },
      "filterOverride": "ownerId eq 'sam'"
    }
  ],
  "vectorFilterMode": "preFilter",
  "hybridSearch": {
    "maxTextRecallSize": 100,
    "countAndFacetMode": "countAllResults"
  }
}

Respon sampel

Kode status:

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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 27.725889205932617
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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>"
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 21.559860229492188
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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>"
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 39.23316955566406
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 21.559860229492188
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 23.01456642150879
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "11",
      "name": "test",
      "description": "test11 hello",
      "category": "purple",
      "ownerId": "sam"
    }
  ]
}

Kode status:

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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 27.725889205932617
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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>"
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 21.559860229492188
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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>"
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 39.23316955566406
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 21.559860229492188
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 23.01456642150879
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "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": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "11",
      "name": "test",
      "description": "test11 hello",
      "category": "purple",
      "ownerId": "sam"
    }
  ]
}

SearchIndexSearchDocumentsSemanticPost

Permintaan sampel

HTTP

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

{
  "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
}

Respon sampel

Kode status:

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=2025-05-01-preview"
}

Kode status:

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=2025-05-01-preview"
}

Definisi

Nama	Deskripsi
AnswerResult	Jawaban adalah bagian teks yang diekstraksi dari konten dokumen paling relevan yang cocok dengan kueri. Jawaban diekstraksi dari hasil pencarian teratas. Kandidat jawaban dinilai dan jawaban teratas dipilih.
CaptionResult	Keterangan adalah bagian yang paling representatif dari dokumen relatif terhadap kueri pencarian. Mereka sering digunakan sebagai ringkasan dokumen. Keterangan hanya dikembalikan untuk kueri jenis semantic.
DebugInfo	Berisi informasi penelusuran kesalahan yang dapat digunakan untuk menjelajahi hasil pencarian Anda lebih lanjut.
DocumentDebugInfo	Berisi informasi penelusuran kesalahan yang dapat digunakan untuk menjelajahi hasil pencarian Anda lebih lanjut.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
HybridCountAndFacetMode	Menentukan apakah jumlah dan aspek harus menyertakan semua dokumen yang cocok dengan kueri pencarian, atau hanya dokumen yang diambil dalam jendela 'maxTextRecallSize'. Nilai defaultnya adalah 'countAllResults'.
HybridSearch	Parameter kueri untuk mengonfigurasi perilaku pencarian hibrid.
QueryAnswerType	Nilai yang menentukan apakah jawaban harus ditampilkan sebagai bagian dari respons penelusuran.
QueryCaptionType	Nilai yang menentukan apakah teks harus ditampilkan sebagai bagian dari respons penelusuran.
QueryDebugMode	Mengaktifkan alat debugging yang dapat digunakan untuk menjelajahi hasil pencarian Anda lebih lanjut. Anda dapat mengaktifkan beberapa mode debug secara bersamaan dengan memisahkannya dengan | karakter, misalnya: semantic|queryRewrites.
QueryLanguage	Bahasa kueri.
QueryResultDocumentRerankerInput	String gabungan mentah yang dikirim ke proses pengayaan semantik.
QueryResultDocumentSemanticField	Deskripsi bidang yang dikirim ke proses pengayaan semantik, serta bagaimana bidang tersebut digunakan
QueryResultDocumentSubscores	Perincian subskor antara komponen kueri teks dan vektor dari kueri pencarian untuk dokumen ini. Setiap kueri vektor ditampilkan sebagai objek terpisah dalam urutan yang sama dengan yang diterima.
QueryRewritesDebugInfo	Berisi informasi penelusuran kesalahan khusus untuk penulisan ulang kueri.
QueryRewritesType	Nilai yang menentukan apakah penulisan ulang kueri harus dihasilkan untuk menambah kueri pencarian.
QueryRewritesValuesDebugInfo	Berisi informasi penelusuran kesalahan khusus untuk penulisan ulang kueri.
QuerySpellerType	Nilai yang menentukan jenis ejaan yang akan digunakan untuk mengoreksi ejaan istilah kueri pencarian individual.
QueryType	Menentukan sintaks kueri pencarian. Defaultnya adalah 'sederhana'. Gunakan 'full' jika kueri Anda menggunakan sintaks kueri Lucene dan 'semantik' jika sintaks kueri tidak diperlukan.
RawVectorQuery	Parameter kueri yang akan digunakan untuk pencarian vektor saat nilai vektor mentah disediakan.
ScoringStatistics	Nilai yang menentukan apakah kita ingin menghitung statistik penilaian (seperti frekuensi dokumen) secara global untuk penilaian yang lebih konsisten, atau secara lokal, untuk latensi yang lebih rendah. Defaultnya adalah 'lokal'. Gunakan 'global' untuk menggabungkan statistik penilaian secara global sebelum mencetak gol. Menggunakan statistik penilaian global dapat meningkatkan latensi kueri pencarian.
SearchDocumentsResult	Respons yang berisi hasil pencarian dari indeks.
SearchMode	Menentukan apakah salah satu atau semua istilah pencarian harus dicocokkan untuk menghitung dokumen sebagai kecocokan.
SearchRequest	Parameter untuk pemfilteran, pengurutan, faset, paging, dan perilaku kueri pencarian lainnya.
SearchResult	Berisi dokumen yang ditemukan oleh kueri pencarian, ditambah metadata terkait.
SearchScoreThreshold	Hasil kueri vektor akan memfilter berdasarkan nilai '@search.score'. Perhatikan bahwa ini adalah yang @search.score dikembalikan sebagai bagian dari respons pencarian. Arah ambang batas akan dipilih untuk .@search.score
SemanticDebugInfo
SemanticErrorMode	Memungkinkan pengguna untuk memilih apakah panggilan semantik harus gagal sepenuhnya (perilaku default / saat ini), atau untuk mengembalikan hasil parsial.
SemanticErrorReason	Alasan bahwa respons parsial dikembalikan untuk permintaan peringkat semantik.
SemanticFieldState	Cara bidang digunakan untuk proses pengayaan semantik (digunakan sepenuhnya, digunakan sebagian, atau tidak digunakan)
SemanticQueryRewritesResultType	Jenis penulisan ulang kueri yang digunakan untuk permintaan ini.
SemanticSearchResultsType	Jenis respons parsial yang dikembalikan untuk permintaan peringkat semantik.
SingleVectorFieldResult	Hasil bidang vektor tunggal. Keduanya @search.score dan nilai kesamaan vektor dikembalikan. Kesamaan vektor terkait dengan @search.score persamaan.
TextResult	Skor BM25 atau Klasik untuk bagian teks kueri.
VectorFilterMode	Menentukan apakah filter diterapkan sebelum atau sesudah pencarian vektor dilakukan atau tidak.
VectorizableImageBinaryQuery	Parameter kueri yang akan digunakan untuk pencarian vektor ketika biner yang dikodekan basis 64 dari gambar yang perlu divektorkan disediakan.
VectorizableImageUrlQuery	Parameter kueri yang akan digunakan untuk pencarian vektor ketika url yang mewakili nilai gambar yang perlu divektorkan disediakan.
VectorizableTextQuery	Parameter kueri yang akan digunakan untuk pencarian vektor saat nilai teks yang perlu divektorkan disediakan.
VectorQueryKind	Jenis kueri vektor yang sedang dilakukan.
VectorsDebugInfo
VectorSimilarityThreshold	Hasil kueri vektor akan difilter berdasarkan metrik kesamaan vektor. Perhatikan ini adalah definisi kanonik dari metrik kesamaan, bukan versi 'jarak'. Arah ambang batas (lebih besar atau lebih kecil) akan dipilih secara otomatis sesuai dengan metrik yang digunakan oleh bidang.
VectorThresholdKind	Jenis kueri vektor yang sedang dilakukan.

AnswerResult

Objek

Jawaban adalah bagian teks yang diekstraksi dari konten dokumen paling relevan yang cocok dengan kueri. Jawaban diekstraksi dari hasil pencarian teratas. Kandidat jawaban dinilai dan jawaban teratas dipilih.

Nama	Jenis	Deskripsi
highlights	string	Bagian teks yang sama seperti di properti Teks dengan frasa teks yang disorot yang paling relevan dengan kueri.
key	string	Kunci dokumen yang diekstraksi jawabannya.
score	number (double)	Nilai skor mewakili seberapa relevan jawaban terhadap kueri relatif terhadap jawaban lain yang ditampilkan untuk kueri.
text	string	Bagian teks yang diekstrak dari isi dokumen sebagai jawabannya.

CaptionResult

Objek

Keterangan adalah bagian yang paling representatif dari dokumen relatif terhadap kueri pencarian. Mereka sering digunakan sebagai ringkasan dokumen. Keterangan hanya dikembalikan untuk kueri jenis semantic.

Nama	Jenis	Deskripsi
highlights	string	Bagian teks yang sama seperti di properti Teks dengan frasa yang disorot yang paling relevan dengan kueri.
text	string	Bagian teks representatif yang diekstrak dari dokumen yang paling relevan dengan kueri pencarian.

DebugInfo

Objek

Berisi informasi penelusuran kesalahan yang dapat digunakan untuk menjelajahi hasil pencarian Anda lebih lanjut.

Nama	Jenis	Deskripsi
queryRewrites	QueryRewritesDebugInfo	Berisi informasi penelusuran kesalahan khusus untuk penulisan ulang kueri.

DocumentDebugInfo

Objek

Berisi informasi penelusuran kesalahan yang dapat digunakan untuk menjelajahi hasil pencarian Anda lebih lanjut.

Nama	Jenis	Deskripsi
innerHits	object	Berisi informasi penelusuran kesalahan khusus untuk vektor yang cocok dalam kumpulan jenis kompleks.
semantic	SemanticDebugInfo	Berisi informasi penelusuran kesalahan khusus untuk permintaan peringkat semantik.
vectors	VectorsDebugInfo	Berisi informasi penelusuran kesalahan khusus untuk pencarian vektor dan hibrida.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

HybridCountAndFacetMode

Enumeration

Menentukan apakah jumlah dan aspek harus menyertakan semua dokumen yang cocok dengan kueri pencarian, atau hanya dokumen yang diambil dalam jendela 'maxTextRecallSize'. Nilai defaultnya adalah 'countAllResults'.

Nilai	Deskripsi
countRetrievableResults	Hanya sertakan dokumen yang cocok dalam jendela pengambilan 'maxTextRecallSize' saat menghitung 'jumlah' dan 'aspek'.
countAllResults	Sertakan semua dokumen yang dicocokkan dengan kueri pencarian saat menghitung 'jumlah' dan 'aspek', terlepas dari apakah dokumen tersebut berada dalam jendela pengambilan 'maxTextRecallSize' atau tidak.

HybridSearch

Objek

Parameter kueri untuk mengonfigurasi perilaku pencarian hibrid.

Nama	Jenis	Deskripsi
countAndFacetMode	HybridCountAndFacetMode	Menentukan apakah jumlah dan aspek harus menyertakan semua dokumen yang cocok dengan kueri pencarian, atau hanya dokumen yang diambil dalam jendela 'maxTextRecallSize'.
maxTextRecallSize	integer (int32)	Menentukan jumlah maksimum dokumen yang akan diambil oleh bagian kueri teks dari permintaan pencarian hibrid. Dokumen-dokumen tersebut akan digabungkan dengan dokumen yang cocok dengan kueri vektor untuk menghasilkan satu daftar hasil akhir. Memilih nilai maxTextRecallSize yang lebih besar akan memungkinkan pengambilan dan paging melalui lebih banyak dokumen (menggunakan parameter atas dan lewati), dengan mengorbankan pemanfaatan sumber daya yang lebih tinggi dan latensi yang lebih tinggi. Nilainya harus antara 1 dan 10.000. Nilai default adalah 1000.

QueryAnswerType

Enumeration

Nilai yang menentukan apakah jawaban harus ditampilkan sebagai bagian dari respons penelusuran.

Nilai	Deskripsi
none	Jangan mengembalikan jawaban untuk kueri.
extractive	Mengekstrak kandidat jawaban dari konten dokumen yang dikembalikan sebagai tanggapan atas pertanyaan yang dinyatakan sebagai pertanyaan dalam bahasa alami.

QueryCaptionType

Enumeration

Nilai yang menentukan apakah teks harus ditampilkan sebagai bagian dari respons penelusuran.

Nilai	Deskripsi
none	Jangan mengembalikan teks untuk kueri.
extractive	Mengekstrak teks dari dokumen yang cocok yang berisi bagian yang relevan dengan kueri pencarian.

QueryDebugMode

Enumeration

Mengaktifkan alat debugging yang dapat digunakan untuk menjelajahi hasil pencarian Anda lebih lanjut. Anda dapat mengaktifkan beberapa mode debug secara bersamaan dengan memisahkannya dengan | karakter, misalnya: semantic|queryRewrites.

Nilai	Deskripsi
disabled	Tidak ada informasi debugging kueri yang akan dikembalikan.
semantic	Memungkinkan pengguna untuk menjelajahi lebih lanjut hasil peringkat ulang mereka.
vector	Memungkinkan pengguna untuk menjelajahi lebih lanjut hasil kueri hibrida dan vektor mereka.
queryRewrites	Memungkinkan pengguna menjelajahi daftar penulisan ulang kueri yang dihasilkan untuk permintaan pencarian mereka.
innerHits	Memungkinkan pengguna untuk mengambil informasi penilaian mengenai vektor yang cocok dalam kumpulan jenis yang kompleks.
all	Aktifkan semua opsi debug.

QueryLanguage

Enumeration

Bahasa kueri.

Nilai	Deskripsi
none	Bahasa kueri tidak ditentukan.
en-us	Nilai bahasa kueri untuk bahasa Inggris (Amerika Serikat).
en-gb	Nilai bahasa kueri untuk bahasa Inggris (Inggris Raya).
en-in	Nilai bahasa kueri untuk bahasa Inggris (India).
en-ca	Nilai bahasa kueri untuk bahasa Inggris (Kanada).
en-au	Nilai bahasa kueri untuk bahasa Inggris (Australia).
fr-fr	Nilai bahasa kueri untuk bahasa Prancis (Prancis).
fr-ca	Nilai bahasa kueri untuk bahasa Prancis (Kanada).
de-de	Nilai bahasa kueri untuk bahasa Jerman (Jerman).
es-es	Nilai bahasa kueri untuk bahasa Spanyol (Spanyol).
es-mx	Nilai bahasa kueri untuk bahasa Spanyol (Meksiko).
zh-cn	Nilai bahasa kueri untuk bahasa Cina (Cina).
zh-tw	Nilai bahasa kueri untuk bahasa Cina (Taiwan).
pt-br	Nilai bahasa kueri untuk Portugis (Brasil).
pt-pt	Nilai bahasa kueri untuk Portugis (Portugal).
it-it	Nilai bahasa kueri untuk bahasa Italia (Italia).
ja-jp	Nilai bahasa kueri untuk bahasa Jepang (Jepang).
ko-kr	Nilai bahasa kueri untuk bahasa Korea (Korea).
ru-ru	Nilai bahasa kueri untuk bahasa Rusia (Rusia).
cs-cz	Nilai bahasa kueri untuk Ceko (Republik Ceko).
nl-be	Nilai bahasa kueri untuk Belanda (Belgia).
nl-nl	Nilai bahasa kueri untuk bahasa Belanda (Belanda).
hu-hu	Nilai bahasa kueri untuk bahasa Hongaria (Hongaria).
pl-pl	Nilai bahasa kueri untuk Polandia (Polandia).
sv-se	Nilai bahasa kueri untuk Swedia (Swedia).
tr-tr	Nilai bahasa kueri untuk bahasa Turki (Turki).
hi-in	Nilai bahasa kueri untuk Hindi (India).
ar-sa	Nilai bahasa kueri untuk bahasa Arab (Arab Saudi).
ar-eg	Nilai bahasa kueri untuk bahasa Arab (Mesir).
ar-ma	Nilai bahasa kueri untuk bahasa Arab (Maroko).
ar-kw	Nilai bahasa kueri untuk bahasa Arab (Kuwait).
ar-jo	Nilai bahasa kueri untuk bahasa Arab (Yordania).
da-dk	Nilai bahasa kueri untuk Denmark (Denmark).
no-no	Nilai bahasa kueri untuk bahasa Norwegia (Norwegia).
bg-bg	Nilai bahasa kueri untuk bahasa Bulgaria (Bulgaria).
hr-hr	Nilai bahasa kueri untuk bahasa Kroasia (Kroasia).
hr-ba	Nilai bahasa kueri untuk bahasa Kroasia (Bosnia dan Herzegovina).
ms-my	Nilai bahasa kueri untuk Bahasa Melayu (Malaysia).
ms-bn	Nilai bahasa kueri untuk bahasa Melayu (Brunei Darussalam).
sl-sl	Nilai bahasa kueri untuk bahasa Slovenia (Slovenia).
ta-in	Nilai bahasa kueri untuk Tamil (India).
vi-vn	Nilai bahasa kueri untuk bahasa Vietnam (Vietnam).
el-gr	Nilai bahasa kueri untuk bahasa Yunani (Yunani).
ro-ro	Nilai bahasa kueri untuk bahasa Rumania (Rumania).
is-is	Nilai bahasa kueri untuk bahasa Islandia (Islandia).
id-id	Nilai bahasa kueri untuk bahasa Indonesia (Indonesia).
th-th	Nilai bahasa kueri untuk bahasa Thailand (Thailand).
lt-lt	Nilai bahasa kueri untuk bahasa Lituania (Lituania).
uk-ua	Nilai bahasa kueri untuk bahasa Ukraina (Ukraina).
lv-lv	Nilai bahasa kueri untuk bahasa Latvia (Latvia).
et-ee	Nilai bahasa kueri untuk bahasa Estonia (Estonia).
ca-es	Nilai bahasa kueri untuk Catalan.
fi-fi	Nilai bahasa kueri untuk bahasa Finlandia (Finlandia).
sr-ba	Nilai bahasa kueri untuk bahasa Serbia (Bosnia dan Herzegovina).
sr-me	Nilai bahasa kueri untuk bahasa Serbia (Montenegro).
sr-rs	Nilai bahasa kueri untuk bahasa Serbia (Serbia).
sk-sk	Nilai bahasa kueri untuk bahasa Slovakia (Slovakia).
nb-no	Nilai bahasa kueri untuk bahasa Norwegia (Norwegia).
hy-am	Nilai bahasa kueri untuk bahasa Armenia (Armenia).
bn-in	Nilai bahasa kueri untuk Bengali (India).
eu-es	Nilai bahasa kueri untuk Basque.
gl-es	Nilai bahasa kueri untuk bahasa Galicia.
gu-in	Nilai bahasa kueri untuk Gujarati (India).
he-il	Nilai bahasa kueri untuk bahasa Ibrani (Israel).
ga-ie	Nilai bahasa kueri untuk Irlandia (Irlandia).
kn-in	Nilai bahasa kueri untuk Kannada (India).
ml-in	Nilai bahasa kueri untuk Malayalam (India).
mr-in	Nilai bahasa kueri untuk Marathi (India).
fa-ae	Nilai bahasa kueri untuk Persia (UEA).
pa-in	Nilai bahasa kueri untuk Punjabi (India).
te-in	Nilai bahasa kueri untuk Telugu (India).
ur-pk	Nilai bahasa kueri untuk Urdu (Pakistan).

QueryResultDocumentRerankerInput

Objek

String gabungan mentah yang dikirim ke proses pengayaan semantik.

Nama	Jenis	Deskripsi
content	string	String gabungan mentah untuk bidang konten yang digunakan untuk pengayaan semantik.
keywords	string	String gabungan mentah untuk bidang kata kunci yang digunakan untuk pengayaan semantik.
title	string	String mentah untuk bidang judul yang digunakan untuk pengayaan semantik.

QueryResultDocumentSemanticField

Objek

Deskripsi bidang yang dikirim ke proses pengayaan semantik, serta bagaimana bidang tersebut digunakan

Nama	Jenis	Deskripsi
name	string	Nama bidang yang dikirim ke proses pengayaan semantik
state	SemanticFieldState	Cara bidang digunakan untuk proses pengayaan semantik (digunakan sepenuhnya, digunakan sebagian, atau tidak digunakan)

QueryResultDocumentSubscores

Objek

Perincian subskor antara komponen kueri teks dan vektor dari kueri pencarian untuk dokumen ini. Setiap kueri vektor ditampilkan sebagai objek terpisah dalam urutan yang sama dengan yang diterima.

Nama	Jenis	Deskripsi
documentBoost	number (double)	Skor BM25 atau Klasik untuk bagian teks kueri.
text	TextResult	Skor BM25 atau Klasik untuk bagian teks kueri.
vectors	<string,  SingleVectorFieldResult>	Kesamaan @search.score dan nilai vektor untuk setiap kueri vektor.

QueryRewritesDebugInfo

Objek

Berisi informasi penelusuran kesalahan khusus untuk penulisan ulang kueri.

Nama	Jenis	Deskripsi
text	QueryRewritesValuesDebugInfo	Daftar penulisan ulang kueri yang dihasilkan untuk kueri teks.
vectors	QueryRewritesValuesDebugInfo[]	Daftar penulisan ulang kueri yang dihasilkan untuk kueri teks yang dapat divektorkan.

QueryRewritesType

Enumeration

Nilai yang menentukan apakah penulisan ulang kueri harus dihasilkan untuk menambah kueri pencarian.

Nilai	Deskripsi
none	Jangan membuat penulisan ulang kueri tambahan untuk kueri ini.
generative	Hasilkan istilah kueri alternatif untuk meningkatkan penarikan permintaan pencarian.

QueryRewritesValuesDebugInfo

Objek

Berisi informasi penelusuran kesalahan khusus untuk penulisan ulang kueri.

Nama	Jenis	Deskripsi
inputQuery	string	Teks input ke model penulisan ulang kueri generatif. Mungkin ada kasus di mana kueri pengguna dan input ke model generatif tidak identik.
rewrites	string[]	Daftar penulisan ulang kueri.

QuerySpellerType

Enumeration

Nilai yang menentukan jenis ejaan yang akan digunakan untuk mengoreksi ejaan istilah kueri pencarian individual.

Nilai	Deskripsi
none	Ejaan tidak diaktifkan.
lexicon	Ejaan mengoreksi istilah kueri individual menggunakan leksikon statis untuk bahasa yang ditentukan oleh parameter queryLanguage.

QueryType

Enumeration

Menentukan sintaks kueri pencarian. Defaultnya adalah 'sederhana'. Gunakan 'full' jika kueri Anda menggunakan sintaks kueri Lucene dan 'semantik' jika sintaks kueri tidak diperlukan.

Nilai	Deskripsi
simple	Menggunakan sintaks kueri sederhana untuk pencarian. Teks pencarian ditafsirkan menggunakan bahasa kueri sederhana yang memungkinkan simbol seperti +, * dan "". Kueri dievaluasi di semua bidang yang dapat dicari secara default, kecuali parameter searchFields ditentukan.
full	Menggunakan sintaks kueri Lucene lengkap untuk pencarian. Teks pencarian ditafsirkan menggunakan bahasa kueri Lucene yang memungkinkan pencarian khusus bidang dan berbobot, serta fitur lanjutan lainnya.
semantic	Paling cocok untuk kueri yang diekspresikan dalam bahasa alami dibandingkan dengan kata kunci. Meningkatkan presisi hasil pencarian dengan memberi peringkat ulang hasil pencarian teratas menggunakan model peringkat yang dilatih pada korpus Web.

RawVectorQuery

Objek

Parameter kueri yang akan digunakan untuk pencarian vektor saat nilai vektor mentah disediakan.

Nama	Jenis	Deskripsi
exhaustive	boolean	Jika true, memicu pencarian k-tetangga terdekat yang lengkap di semua vektor dalam indeks vektor. Berguna untuk skenario di mana kecocokan persis sangat penting, seperti menentukan nilai kebenaran dasar.
fields	string	Bidang Vektor jenis Collection(Edm.Single) untuk disertakan dalam vektor yang dicari.
filterOverride	string	Ekspresi filter OData untuk diterapkan ke kueri vektor khusus ini. Jika tidak ada ekspresi filter yang ditentukan di tingkat vektor, ekspresi yang ditentukan dalam parameter filter tingkat atas akan digunakan sebagai gantinya.
k	integer (int32)	Jumlah tetangga terdekat yang kembali sebagai hit teratas.
kind	string: vector	Jenis kueri vektor yang sedang dilakukan.
oversampling	number (double)	Faktor oversampling. Nilai minimum adalah 1. Ini mengganti parameter 'defaultOversampling' yang dikonfigurasi dalam definisi indeks. Ini hanya dapat diatur ketika 'rerankWithOriginalVectors' benar. Parameter ini hanya diizinkan ketika metode kompresi digunakan pada bidang vektor yang mendasarinya.
perDocumentVectorLimit	integer (int32)	Mengontrol berapa banyak vektor yang dapat dicocokkan dari setiap dokumen dalam kueri pencarian vektor. Mengaturnya ke 1 memastikan paling banyak satu vektor per dokumen cocok, menjamin hasil berasal dari dokumen yang berbeda. Mengaturnya ke 0 (tidak terbatas) memungkinkan beberapa vektor yang relevan dari dokumen yang sama untuk dicocokkan. Nilai bawaan adalah 0.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Ambang batas yang digunakan untuk kueri vektor. Perhatikan bahwa ini hanya dapat diatur jika semua 'bidang' menggunakan metrik kesamaan yang sama.
vector	number[] (float)	Representasi vektor dari kueri pencarian.
weight	number (float)	Bobot relatif kueri vektor jika dibandingkan dengan kueri vektor lain dan/atau kueri teks dalam permintaan pencarian yang sama. Nilai ini digunakan saat menggabungkan hasil beberapa daftar peringkat yang dihasilkan oleh kueri vektor yang berbeda dan/atau hasil yang diambil melalui kueri teks. Semakin tinggi bobotnya, semakin tinggi dokumen yang cocok dengan kueri tersebut akan berada di peringkat akhir. Defaultnya adalah 1.0 dan nilainya harus berupa bilangan positif yang lebih besar dari nol.

ScoringStatistics

Enumeration

Nilai yang menentukan apakah kita ingin menghitung statistik penilaian (seperti frekuensi dokumen) secara global untuk penilaian yang lebih konsisten, atau secara lokal, untuk latensi yang lebih rendah. Defaultnya adalah 'lokal'. Gunakan 'global' untuk menggabungkan statistik penilaian secara global sebelum mencetak gol. Menggunakan statistik penilaian global dapat meningkatkan latensi kueri pencarian.

Nilai	Deskripsi
local	Statistik penilaian akan dihitung secara lokal untuk latensi yang lebih rendah.
global	Statistik penilaian akan dihitung secara global untuk penilaian yang lebih konsisten.

SearchDocumentsResult

Objek

Respons yang berisi hasil pencarian dari indeks.

Nama	Jenis	Deskripsi
@odata.count	integer (int64)	Jumlah total hasil yang ditemukan oleh operasi pencarian, atau null jika hitungan tidak diminta. Jika ada, hitungannya mungkin lebih besar dari jumlah hasil dalam respons ini. Hal ini dapat terjadi jika Anda menggunakan parameter $top atau $skip, atau jika kueri tidak dapat mengembalikan semua dokumen yang diminta dalam satu respons.
@odata.nextLink	string	URL kelanjutan ditampilkan saat kueri tidak dapat mengembalikan semua hasil yang diminta dalam satu respons. Anda dapat menggunakan URL ini untuk merumuskan permintaan GET atau POST Search lainnya untuk mendapatkan bagian berikutnya dari respons penelusuran. Pastikan untuk menggunakan kata kerja yang sama (GET atau POST) dengan permintaan yang menghasilkan respons ini.
@search.answers	AnswerResult[]	Hasil kueri jawaban untuk operasi pencarian; null jika parameter kueri jawaban tidak ditentukan atau diatur ke 'none'.
@search.coverage	number (double)	Nilai yang menunjukkan persentase indeks yang disertakan dalam kueri, atau null jika minimumCoverage tidak ditentukan dalam permintaan.
@search.debug	DebugInfo	Men-debug informasi yang berlaku untuk hasil pencarian secara keseluruhan.
@search.facets	object	Hasil kueri aspek untuk operasi pencarian, diatur sebagai kumpulan bucket untuk setiap bidang segi; null jika kueri tidak menyertakan ekspresi aspek apa pun.
@search.nextPageParameters	SearchRequest	Payload JSON kelanjutan dikembalikan ketika kueri tidak dapat mengembalikan semua hasil yang diminta dalam satu respons. Anda dapat menggunakan JSON ini bersama dengan @odata.nextLink untuk merumuskan permintaan POST Search lain untuk mendapatkan bagian berikutnya dari respons pencarian.
@search.semanticPartialResponseReason	SemanticErrorReason	Alasan bahwa respons parsial dikembalikan untuk permintaan peringkat semantik.
@search.semanticPartialResponseType	SemanticSearchResultsType	Jenis respons parsial yang dikembalikan untuk permintaan peringkat semantik.
@search.semanticQueryRewritesResultType	SemanticQueryRewritesResultType	Jenis penulisan ulang kueri yang digunakan untuk mengambil dokumen.
value	SearchResult[]	Urutan hasil yang ditampilkan oleh kueri.

SearchMode

Enumeration

Menentukan apakah salah satu atau semua istilah pencarian harus dicocokkan untuk menghitung dokumen sebagai kecocokan.

Nilai	Deskripsi
any	Salah satu istilah pencarian harus cocok untuk menghitung dokumen sebagai kecocokan.
all	Semua istilah pencarian harus cocok untuk menghitung dokumen sebagai kecocokan.

SearchRequest

Objek

Parameter untuk pemfilteran, pengurutan, faset, paging, dan perilaku kueri pencarian lainnya.

Nama	Jenis	Deskripsi
answers	QueryAnswerType	Nilai yang menentukan apakah jawaban harus ditampilkan sebagai bagian dari respons penelusuran.
captions	QueryCaptionType	Nilai yang menentukan apakah teks harus ditampilkan sebagai bagian dari respons penelusuran.
count	boolean	Nilai yang menentukan apakah akan mengambil jumlah total hasil. Secara default adalah false. Menetapkan nilai ini ke true mungkin berdampak pada performa. Perhatikan bahwa hitungan yang dikembalikan adalah perkiraan.
debug	QueryDebugMode	Mengaktifkan alat debugging yang dapat digunakan untuk menjelajahi hasil peringkat ulang Anda lebih lanjut.
facets	string[]	Daftar ekspresi aspek yang akan diterapkan ke kueri pencarian. Setiap ekspresi aspek berisi nama bidang, secara opsional diikuti oleh daftar pasangan nama:nilai yang dipisahkan koma.
filter	string	OData $filter ekspresi untuk diterapkan ke kueri pencarian.
highlight	string	Daftar nama bidang yang dipisahkan koma untuk digunakan untuk sorotan klik. Hanya bidang yang dapat dicari yang dapat digunakan untuk penyorotan klik.
highlightPostTag	string	Tag string yang ditambahkan ke sorotan klik. Harus diatur dengan highlightPreTag. Defaultnya adalah </em>.
highlightPreTag	string	Tag string yang dilanjutkan untuk menekan sorotan. Harus diatur dengan highlightPostTag. Defaultnya adalah <em>.
hybridSearch	HybridSearch	Parameter kueri untuk mengonfigurasi perilaku pencarian hibrid.
minimumCoverage	number (double)	Angka antara 0 dan 100 yang menunjukkan persentase indeks yang harus dicakup oleh kueri pencarian agar kueri dilaporkan sebagai keberhasilan. Parameter ini dapat berguna untuk memastikan ketersediaan pencarian bahkan untuk layanan dengan hanya satu replika. Nilai defaultnya adalah 100.
orderby	string	Daftar ekspresi OData $orderby yang dipisahkan koma untuk mengurutkan hasilnya. Setiap ekspresi dapat berupa nama bidang atau panggilan ke fungsi geo.distance() atau search.score(). Setiap ekspresi dapat diikuti oleh asc untuk menunjukkan naik, atau desc untuk menunjukkan turun. Defaultnya adalah urutan menaik. Ikatan akan diputuskan oleh skor pertandingan dokumen. Jika tidak ada $orderby yang ditentukan, urutan pengurutan default adalah menurun berdasarkan skor kecocokan dokumen. Mungkin ada paling banyak 32 klausa $orderby.
queryLanguage	QueryLanguage	Nilai yang menentukan bahasa kueri pencarian.
queryRewrites	QueryRewritesType	Nilai yang menentukan apakah penulisan ulang kueri harus dihasilkan untuk menambah kueri pencarian.
queryType	QueryType	Nilai yang menentukan sintaks kueri pencarian. Defaultnya adalah 'sederhana'. Gunakan 'full' jika kueri Anda menggunakan sintaks kueri Lucene.
scoringParameters	string[]	Daftar nilai parameter yang akan digunakan dalam fungsi penilaian (misalnya, referencePointParameter) menggunakan format name-values. Misalnya, jika profil penilaian mendefinisikan fungsi dengan parameter yang disebut 'mylocation', string parameter akan menjadi "mylocation--122.2,44.8" (tanpa tanda kutip).
scoringProfile	string	Nama profil penilaian untuk mengevaluasi skor kecocokan untuk dokumen yang cocok untuk mengurutkan hasil.
scoringStatistics	ScoringStatistics	Nilai yang menentukan apakah kita ingin menghitung statistik penilaian (seperti frekuensi dokumen) secara global untuk penilaian yang lebih konsisten, atau secara lokal, untuk latensi yang lebih rendah. Defaultnya adalah 'lokal'. Gunakan 'global' untuk menggabungkan statistik penilaian secara global sebelum mencetak gol. Menggunakan statistik penilaian global dapat meningkatkan latensi kueri pencarian.
search	string	Ekspresi kueri pencarian teks lengkap; Gunakan "*" atau hilangkan parameter ini agar cocok dengan semua dokumen.
searchFields	string	Daftar nama bidang yang dipisahkan koma untuk mencakupan pencarian teks lengkap. Saat menggunakan pencarian bidang (fieldName:searchExpression) dalam kueri Lucene penuh, nama bidang dari setiap ekspresi pencarian kolom lebih diutamakan daripada nama bidang apa pun yang tercantum dalam parameter ini.
searchMode	SearchMode	Nilai yang menentukan apakah salah satu atau semua istilah pencarian harus dicocokkan untuk menghitung dokumen sebagai kecocokan.
select	string	Daftar bidang yang dipisahkan koma untuk diambil. Jika tidak ditentukan, semua bidang yang ditandai sebagai dapat diambil dalam skema disertakan.
semanticConfiguration	string	Nama konfigurasi semantik yang akan digunakan saat memproses dokumen untuk kueri jenis semantik.
semanticErrorHandling	SemanticErrorMode	Memungkinkan pengguna untuk memilih apakah panggilan semantik harus gagal sepenuhnya (perilaku default / saat ini), atau untuk mengembalikan hasil parsial.
semanticFields	string	Daftar nama bidang yang dipisahkan koma yang digunakan untuk peringkat semantik.
semanticMaxWaitInMilliseconds	integer (int32) minimum: 700	Memungkinkan pengguna untuk menetapkan batas atas pada jumlah waktu yang dibutuhkan pengayaan semantik untuk menyelesaikan pemrosesan sebelum permintaan gagal.
semanticQuery	string	Memungkinkan pengaturan kueri pencarian terpisah yang hanya akan digunakan untuk peringkat ulang semantik, keterangan semantik, dan jawaban semantik. Berguna untuk skenario di mana ada kebutuhan untuk menggunakan kueri yang berbeda antara fase pengambilan dasar dan peringkat, dan fase semantik L2.
sessionId	string	Nilai yang akan digunakan untuk membuat sesi lengket, yang dapat membantu mendapatkan hasil yang lebih konsisten. Selama sessionId yang sama digunakan, upaya upaya terbaik akan dilakukan untuk menargetkan set replika yang sama. Berhati-hatilah karena menggunakan kembali nilai sessionID yang sama berulang kali dapat mengganggu penyeimbangan beban permintaan di seluruh replika dan berdampak buruk pada performa layanan pencarian. Nilai yang digunakan sebagai sessionId tidak dapat dimulai dengan karakter '_'.
skip	integer (int32)	Jumlah hasil pencarian yang harus dilewati. Nilai ini tidak boleh lebih besar dari 100.000. Jika Anda perlu memindai dokumen secara berurutan, tetapi tidak dapat menggunakan lewati karena batasan ini, pertimbangkan untuk menggunakan orderby pada kunci yang diurutkan sepenuhnya dan filter dengan kueri rentang.
speller	QuerySpellerType	Nilai yang menentukan jenis ejaan yang akan digunakan untuk mengoreksi ejaan istilah kueri pencarian individual.
top	integer (int32)	Jumlah hasil pencarian yang akan diambil. Ini dapat digunakan bersama dengan $skip untuk menerapkan paging hasil pencarian sisi klien. Jika hasil terpotong karena paging sisi server, respons akan menyertakan token kelanjutan yang dapat digunakan untuk mengeluarkan permintaan Pencarian lain untuk halaman hasil berikutnya.
vectorFilterMode	VectorFilterMode	Menentukan apakah filter diterapkan sebelum atau sesudah pencarian vektor dilakukan atau tidak. Defaultnya adalah 'preFilter' untuk indeks baru.
vectorQueries	VectorQuery[]: RawVectorQuery[] VectorizableImageBinaryQuery[] VectorizableImageUrlQuery[] VectorizableTextQuery[]	Parameter kueri untuk kueri pencarian vektor dan hibrid.

SearchResult

Objek

Berisi dokumen yang ditemukan oleh kueri pencarian, ditambah metadata terkait.

Nama	Jenis	Deskripsi
@search.captions	CaptionResult[]	Keterangan adalah bagian yang paling representatif dari dokumen relatif terhadap kueri pencarian. Mereka sering digunakan sebagai ringkasan dokumen. Keterangan hanya dikembalikan untuk kueri jenis 'semantik'.
@search.documentDebugInfo	DocumentDebugInfo	Berisi informasi penelusuran kesalahan yang dapat digunakan untuk menjelajahi hasil pencarian Anda lebih lanjut.
@search.highlights	object	Fragmen teks dari dokumen yang menunjukkan istilah pencarian yang cocok, diatur berdasarkan setiap bidang yang berlaku; null jika penyorotan hit tidak diaktifkan untuk kueri.
@search.rerankerBoostedScore	number (double)	Skor relevansi dihitung dengan meningkatkan Skor Reranker. Hasil pencarian diurutkan berdasarkan RerankerScore/RerankerBoostedScore berdasarkan useScoringProfileBoostedRanking di Semantic Config. RerankerBoostedScore hanya dikembalikan untuk kueri jenis 'semantik'
@search.rerankerScore	number (double)	Skor relevansi yang dihitung oleh peringkat semantik untuk hasil pencarian teratas. Hasil pencarian diurutkan berdasarkan RerankerScore terlebih dahulu dan kemudian berdasarkan Skor. RerankerScore hanya dikembalikan untuk kueri jenis 'semantik'.
@search.score	number (double)	Skor relevansi dokumen dibandingkan dengan dokumen lain yang ditampilkan oleh kueri.

SearchScoreThreshold

Objek

Hasil kueri vektor akan memfilter berdasarkan nilai '@search.score'. Perhatikan bahwa ini adalah yang @search.score dikembalikan sebagai bagian dari respons pencarian. Arah ambang batas akan dipilih untuk .@search.score

Nama	Jenis	Deskripsi
kind	string: searchScore	Jenis ambang batas yang digunakan untuk memfilter kueri vektor
value	number (double)	Ambang batas akan difilter berdasarkan nilai '@search.score'. Perhatikan bahwa ini adalah yang @search.score dikembalikan sebagai bagian dari respons pencarian. Arah ambang batas akan dipilih untuk .@search.score

SemanticDebugInfo

Objek

Nama	Jenis	Deskripsi
contentFields	QueryResultDocumentSemanticField[]	Bidang konten yang dikirim ke proses pengayaan semantik, serta cara penggunaannya
keywordFields	QueryResultDocumentSemanticField[]	Bidang kata kunci yang dikirim ke proses pengayaan semantik, serta cara penggunaannya
rerankerInput	QueryResultDocumentRerankerInput	String gabungan mentah yang dikirim ke proses pengayaan semantik.
titleField	QueryResultDocumentSemanticField	Bidang judul yang dikirim ke proses pengayaan semantik, serta cara penggunaannya

SemanticErrorMode

Enumeration

Memungkinkan pengguna untuk memilih apakah panggilan semantik harus gagal sepenuhnya (perilaku default / saat ini), atau untuk mengembalikan hasil parsial.

Nilai	Deskripsi
partial	Jika pemrosesan semantik gagal, hasil parsial masih kembali. Definisi hasil parsial tergantung pada langkah semantik apa yang gagal dan apa alasan kegagalan.
fail	Jika ada pengecualian selama langkah pemrosesan semantik, kueri akan gagal dan mengembalikan kode HTTP yang sesuai tergantung pada kesalahan.

SemanticErrorReason

Enumeration

Alasan bahwa respons parsial dikembalikan untuk permintaan peringkat semantik.

Nilai	Deskripsi
maxWaitExceeded	Jika semanticMaxWaitInMilliseconds diatur dan durasi pemrosesan semantik melebihi nilai tersebut. Hanya hasil dasar yang dikembalikan.
capacityOverloaded	Permintaan itu dibatasi. Hanya hasil dasar yang dikembalikan.
transient	Setidaknya satu langkah proses semantik gagal.

SemanticFieldState

Enumeration

Cara bidang digunakan untuk proses pengayaan semantik (digunakan sepenuhnya, digunakan sebagian, atau tidak digunakan)

Nilai	Deskripsi
used	Bidang ini sepenuhnya digunakan untuk pengayaan semantik.
unused	Bidang ini tidak digunakan untuk pengayaan semantik.
partial	Bidang ini sebagian digunakan untuk pengayaan semantik.

SemanticQueryRewritesResultType

Enumeration

Jenis penulisan ulang kueri yang digunakan untuk permintaan ini.

Nilai	Deskripsi
originalQueryOnly	Penulisan ulang kueri tidak berhasil dihasilkan untuk permintaan ini. Hanya kueri asli yang digunakan untuk mengambil hasilnya.

SemanticSearchResultsType

Enumeration

Jenis respons parsial yang dikembalikan untuk permintaan peringkat semantik.

Nilai	Deskripsi
baseResults	Hasil tanpa pengayaan semantik atau peringkat ulang.
rerankedResults	Hasil telah diberi peringkat ulang dengan model reranker dan akan menyertakan keterangan semantik. Mereka tidak akan menyertakan jawaban, sorotan jawaban, atau sorotan keterangan.

SingleVectorFieldResult

Objek

Hasil bidang vektor tunggal. Keduanya @search.score dan nilai kesamaan vektor dikembalikan. Kesamaan vektor terkait dengan @search.score persamaan.

Nama	Jenis	Deskripsi
searchScore	number (double)	Nilai @search.score yang dihitung dari skor kesamaan vektor. Ini adalah skor yang terlihat dalam kueri vektor tunggal bidang tunggal murni.
vectorSimilarity	number (double)	Skor kesamaan vektor untuk dokumen ini. Perhatikan ini adalah definisi kanonik dari metrik kesamaan, bukan versi 'jarak'. Misalnya, kesamaan kosinus alih-alih jarak kosinus.

TextResult

Objek

Skor BM25 atau Klasik untuk bagian teks kueri.

Nama	Jenis	Deskripsi
searchScore	number (double)	Skor BM25 atau Klasik untuk bagian teks kueri.

VectorFilterMode

Enumeration

Menentukan apakah filter diterapkan sebelum atau sesudah pencarian vektor dilakukan atau tidak.

Nilai	Deskripsi
postFilter	Filter akan diterapkan setelah kumpulan kandidat hasil vektor dikembalikan. Bergantung pada selektivitas filter, ini dapat menghasilkan hasil yang lebih sedikit daripada yang diminta oleh parameter 'k'.
preFilter	Filter akan diterapkan sebelum kueri pencarian.
strictPostFilter	Filter akan diterapkan setelah kumpulan hasil vektor kandidat top-k global dikembalikan. Ini akan menghasilkan hasil yang lebih sedikit daripada yang diminta oleh parameter 'k'.

VectorizableImageBinaryQuery

Objek

Parameter kueri yang akan digunakan untuk pencarian vektor ketika biner yang dikodekan basis 64 dari gambar yang perlu divektorkan disediakan.

Nama	Jenis	Deskripsi
base64Image	string	Biner yang dikodekan basis 64 dari gambar yang akan divektorkan untuk melakukan kueri pencarian vektor.
exhaustive	boolean	Jika true, memicu pencarian k-tetangga terdekat yang lengkap di semua vektor dalam indeks vektor. Berguna untuk skenario di mana kecocokan persis sangat penting, seperti menentukan nilai kebenaran dasar.
fields	string	Bidang Vektor jenis Collection(Edm.Single) untuk disertakan dalam vektor yang dicari.
filterOverride	string	Ekspresi filter OData untuk diterapkan ke kueri vektor khusus ini. Jika tidak ada ekspresi filter yang ditentukan di tingkat vektor, ekspresi yang ditentukan dalam parameter filter tingkat atas akan digunakan sebagai gantinya.
k	integer (int32)	Jumlah tetangga terdekat yang kembali sebagai hit teratas.
kind	string: imageBinary	Jenis kueri vektor yang sedang dilakukan.
oversampling	number (double)	Faktor oversampling. Nilai minimum adalah 1. Ini mengganti parameter 'defaultOversampling' yang dikonfigurasi dalam definisi indeks. Ini hanya dapat diatur ketika 'rerankWithOriginalVectors' benar. Parameter ini hanya diizinkan ketika metode kompresi digunakan pada bidang vektor yang mendasarinya.
perDocumentVectorLimit	integer (int32)	Mengontrol berapa banyak vektor yang dapat dicocokkan dari setiap dokumen dalam kueri pencarian vektor. Mengaturnya ke 1 memastikan paling banyak satu vektor per dokumen cocok, menjamin hasil berasal dari dokumen yang berbeda. Mengaturnya ke 0 (tidak terbatas) memungkinkan beberapa vektor yang relevan dari dokumen yang sama untuk dicocokkan. Nilai bawaan adalah 0.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Ambang batas yang digunakan untuk kueri vektor. Perhatikan bahwa ini hanya dapat diatur jika semua 'bidang' menggunakan metrik kesamaan yang sama.
weight	number (float)	Bobot relatif kueri vektor jika dibandingkan dengan kueri vektor lain dan/atau kueri teks dalam permintaan pencarian yang sama. Nilai ini digunakan saat menggabungkan hasil beberapa daftar peringkat yang dihasilkan oleh kueri vektor yang berbeda dan/atau hasil yang diambil melalui kueri teks. Semakin tinggi bobotnya, semakin tinggi dokumen yang cocok dengan kueri tersebut akan berada di peringkat akhir. Defaultnya adalah 1.0 dan nilainya harus berupa bilangan positif yang lebih besar dari nol.

VectorizableImageUrlQuery

Objek

Parameter kueri yang akan digunakan untuk pencarian vektor ketika url yang mewakili nilai gambar yang perlu divektorkan disediakan.

Nama	Jenis	Deskripsi
exhaustive	boolean	Jika true, memicu pencarian k-tetangga terdekat yang lengkap di semua vektor dalam indeks vektor. Berguna untuk skenario di mana kecocokan persis sangat penting, seperti menentukan nilai kebenaran dasar.
fields	string	Bidang Vektor jenis Collection(Edm.Single) untuk disertakan dalam vektor yang dicari.
filterOverride	string	Ekspresi filter OData untuk diterapkan ke kueri vektor khusus ini. Jika tidak ada ekspresi filter yang ditentukan di tingkat vektor, ekspresi yang ditentukan dalam parameter filter tingkat atas akan digunakan sebagai gantinya.
k	integer (int32)	Jumlah tetangga terdekat yang kembali sebagai hit teratas.
kind	string: imageUrl	Jenis kueri vektor yang sedang dilakukan.
oversampling	number (double)	Faktor oversampling. Nilai minimum adalah 1. Ini mengganti parameter 'defaultOversampling' yang dikonfigurasi dalam definisi indeks. Ini hanya dapat diatur ketika 'rerankWithOriginalVectors' benar. Parameter ini hanya diizinkan ketika metode kompresi digunakan pada bidang vektor yang mendasarinya.
perDocumentVectorLimit	integer (int32)	Mengontrol berapa banyak vektor yang dapat dicocokkan dari setiap dokumen dalam kueri pencarian vektor. Mengaturnya ke 1 memastikan paling banyak satu vektor per dokumen cocok, menjamin hasil berasal dari dokumen yang berbeda. Mengaturnya ke 0 (tidak terbatas) memungkinkan beberapa vektor yang relevan dari dokumen yang sama untuk dicocokkan. Nilai bawaan adalah 0.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Ambang batas yang digunakan untuk kueri vektor. Perhatikan bahwa ini hanya dapat diatur jika semua 'bidang' menggunakan metrik kesamaan yang sama.
url	string	URL gambar yang akan divektorkan untuk melakukan kueri pencarian vektor.
weight	number (float)	Bobot relatif kueri vektor jika dibandingkan dengan kueri vektor lain dan/atau kueri teks dalam permintaan pencarian yang sama. Nilai ini digunakan saat menggabungkan hasil beberapa daftar peringkat yang dihasilkan oleh kueri vektor yang berbeda dan/atau hasil yang diambil melalui kueri teks. Semakin tinggi bobotnya, semakin tinggi dokumen yang cocok dengan kueri tersebut akan berada di peringkat akhir. Defaultnya adalah 1.0 dan nilainya harus berupa bilangan positif yang lebih besar dari nol.

VectorizableTextQuery

Objek

Parameter kueri yang akan digunakan untuk pencarian vektor saat nilai teks yang perlu divektorkan disediakan.

Nama	Jenis	Deskripsi
exhaustive	boolean	Jika true, memicu pencarian k-tetangga terdekat yang lengkap di semua vektor dalam indeks vektor. Berguna untuk skenario di mana kecocokan persis sangat penting, seperti menentukan nilai kebenaran dasar.
fields	string	Bidang Vektor jenis Collection(Edm.Single) untuk disertakan dalam vektor yang dicari.
filterOverride	string	Ekspresi filter OData untuk diterapkan ke kueri vektor khusus ini. Jika tidak ada ekspresi filter yang ditentukan di tingkat vektor, ekspresi yang ditentukan dalam parameter filter tingkat atas akan digunakan sebagai gantinya.
k	integer (int32)	Jumlah tetangga terdekat yang kembali sebagai hit teratas.
kind	string: text	Jenis kueri vektor yang sedang dilakukan.
oversampling	number (double)	Faktor oversampling. Nilai minimum adalah 1. Ini mengganti parameter 'defaultOversampling' yang dikonfigurasi dalam definisi indeks. Ini hanya dapat diatur ketika 'rerankWithOriginalVectors' benar. Parameter ini hanya diizinkan ketika metode kompresi digunakan pada bidang vektor yang mendasarinya.
perDocumentVectorLimit	integer (int32)	Mengontrol berapa banyak vektor yang dapat dicocokkan dari setiap dokumen dalam kueri pencarian vektor. Mengaturnya ke 1 memastikan paling banyak satu vektor per dokumen cocok, menjamin hasil berasal dari dokumen yang berbeda. Mengaturnya ke 0 (tidak terbatas) memungkinkan beberapa vektor yang relevan dari dokumen yang sama untuk dicocokkan. Nilai bawaan adalah 0.
queryRewrites	QueryRewritesType	Dapat dikonfigurasi untuk memungkinkan model generatif menulis ulang kueri sebelum mengirimkannya untuk divektorkan.
text	string	Teks yang akan divektorkan untuk melakukan kueri pencarian vektor.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Ambang batas yang digunakan untuk kueri vektor. Perhatikan bahwa ini hanya dapat diatur jika semua 'bidang' menggunakan metrik kesamaan yang sama.
weight	number (float)	Bobot relatif kueri vektor jika dibandingkan dengan kueri vektor lain dan/atau kueri teks dalam permintaan pencarian yang sama. Nilai ini digunakan saat menggabungkan hasil beberapa daftar peringkat yang dihasilkan oleh kueri vektor yang berbeda dan/atau hasil yang diambil melalui kueri teks. Semakin tinggi bobotnya, semakin tinggi dokumen yang cocok dengan kueri tersebut akan berada di peringkat akhir. Defaultnya adalah 1.0 dan nilainya harus berupa bilangan positif yang lebih besar dari nol.

VectorQueryKind

Enumeration

Jenis kueri vektor yang sedang dilakukan.

Nilai	Deskripsi
vector	Kueri vektor di mana nilai vektor mentah disediakan.
text	Kueri vektor di mana nilai teks yang perlu divektorkan disediakan.
imageUrl	Kueri vektor di mana url yang mewakili nilai gambar yang perlu divektorkan disediakan.
imageBinary	Kueri vektor di mana biner yang dikodekan basis 64 dari gambar yang perlu divektorkan disediakan.

VectorsDebugInfo

Objek

Nama	Jenis	Deskripsi
subscores	QueryResultDocumentSubscores	Perincian subskor dokumen sebelum metode fusi/kombinasi set hasil yang dipilih seperti RRF.

VectorSimilarityThreshold

Objek

Hasil kueri vektor akan difilter berdasarkan metrik kesamaan vektor. Perhatikan ini adalah definisi kanonik dari metrik kesamaan, bukan versi 'jarak'. Arah ambang batas (lebih besar atau lebih kecil) akan dipilih secara otomatis sesuai dengan metrik yang digunakan oleh bidang.

Nama	Jenis	Deskripsi
kind	string: vectorSimilarity	Jenis ambang batas yang digunakan untuk memfilter kueri vektor
value	number (double)	Ambang batas akan memfilter berdasarkan nilai metrik kesamaan. Perhatikan ini adalah definisi kanonik dari metrik kesamaan, bukan versi 'jarak'. Arah ambang batas (lebih besar atau lebih kecil) akan dipilih secara otomatis sesuai dengan metrik yang digunakan oleh bidang.

VectorThresholdKind

Enumeration

Jenis kueri vektor yang sedang dilakukan.

Nilai	Deskripsi
vectorSimilarity	Hasil kueri vektor akan difilter berdasarkan metrik kesamaan vektor. Perhatikan ini adalah definisi kanonik dari metrik kesamaan, bukan versi 'jarak'. Arah ambang batas (lebih besar atau lebih kecil) akan dipilih secara otomatis sesuai dengan metrik yang digunakan oleh bidang.
searchScore	Hasil kueri vektor akan memfilter berdasarkan nilai '@search.score'. Perhatikan bahwa ini adalah yang @search.score dikembalikan sebagai bagian dari respons pencarian. Arah ambang batas akan dipilih untuk .@search.score