Documents - Search Post

Dienst:

Search Service

API-Version:

2024-11-01-preview

Sucht nach Dokumenten im Index.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string	Die Endpunkt-URL des Suchdiensts.
indexName	path	True	string	Der Name des Indexes.
api-version	query	True	string	Client-API-Version.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
x-ms-client-request-id		string uuid	Die Tracking-ID, die mit der Anforderung gesendet wurde, um beim Debuggen zu helfen.

Anforderungstext

Name	Typ	Beschreibung
answers	QueryAnswerType	Ein Wert, der angibt, ob Antworten als Teil der Suchantwort zurückgegeben werden sollen.
captions	QueryCaptionType	Ein Wert, der angibt, ob Beschriftungen als Teil der Suchantwort zurückgegeben werden sollen.
count	boolean	Ein Wert, der angibt, ob die Gesamtanzahl der Ergebnisse abgerufen werden soll. Der Standardwert ist "false". Das Festlegen dieses Werts auf "true" hat möglicherweise auswirkungen auf die Leistung. Beachten Sie, dass die zurückgegebene Anzahl eine Annäherung ist.
debug	QueryDebugMode	Ermöglicht ein Debuggingtool, das verwendet werden kann, um Ihre neu bewerteten Ergebnisse weiter zu untersuchen.
facets	string[]	Die Liste der Facetausdrücke, die auf die Suchabfrage angewendet werden sollen. Jeder Facetausdruck enthält einen Feldnamen, optional gefolgt von einer durch Trennzeichen getrennten Liste von Name:Wert-Paaren.
filter	string	Der OData-$filter Ausdruck, der auf die Suchabfrage angewendet werden soll.
highlight	string	Die durch Trennzeichen getrennte Liste der Feldnamen, die für Trefferhighlights verwendet werden sollen. Nur durchsuchbare Felder können zum Hervorheben von Treffern verwendet werden.
highlightPostTag	string	Ein Zeichenfolgentag, das an Trefferhighlights angefügt wird. Muss mit highlightPreTag festgelegt werden. Der Standardwert ist </em>.
highlightPreTag	string	Ein Zeichenfolgentag, das den Trefferhighlights vorangestellt ist. Muss mit highlightPostTag festgelegt werden. Der Standardwert ist <em>.
hybridSearch	HybridSearch	Die Abfrageparameter zum Konfigurieren von Hybridsuchverhalten.
minimumCoverage	number	Eine Zahl zwischen 0 und 100, die den Prozentsatz des Indexes angibt, der von einer Suchabfrage abgedeckt werden muss, damit die Abfrage als Erfolg gemeldet werden kann. Dieser Parameter kann hilfreich sein, um die Suchverfügbarkeit auch für Dienste mit nur einem Replikat sicherzustellen. Der Standardwert ist 100.
orderby	string	Die durch Trennzeichen getrennte Liste der OData-$orderby Ausdrücke, nach denen die Ergebnisse sortiert werden sollen. Jeder Ausdruck kann entweder ein Feldname oder ein Aufruf der Funktionen geo.distance() oder search.score() sein. Jedem Ausdruck kann asc folgen, um aufsteigend oder desc anzuzeigen, um absteigend anzugeben. Der Standardwert ist die aufsteigende Reihenfolge. Die Verknüpfungen werden durch die Übereinstimmungsergebnisse von Dokumenten unterbrochen. Wenn keine $orderby angegeben ist, wird die Standardsortierreihenfolge nach Dokumentabgleichsbewertung absteigend ausgeführt. Es können höchstens 32 $orderby Klauseln vorhanden sein.
queryLanguage	QueryLanguage	Ein Wert, der die Sprache der Suchabfrage angibt.
queryRewrites	QueryRewritesType	Ein Wert, der angibt, ob Abfrageumschreibungen generiert werden sollen, um die Suchabfrage zu erweitern.
queryType	QueryType	Ein Wert, der die Syntax der Suchabfrage angibt. Der Standardwert ist "einfach". Verwenden Sie "vollständig", wenn Ihre Abfrage die Lucene-Abfragesyntax verwendet.
scoringParameters	string[]	Die Liste der Parameterwerte, die in Bewertungsfunktionen (z. B. referencePointParameter) mit den Formatnamenwerten verwendet werden sollen. Wenn das Bewertungsprofil beispielsweise eine Funktion mit einem Parameter namens "mylocation" definiert, lautet die Parameterzeichenfolge "mylocation--122.2,44.8" (ohne anführungszeichen).
scoringProfile	string	Der Name eines Bewertungsprofils, um Übereinstimmungsergebnisse für übereinstimmende Dokumente auszuwerten, um die Ergebnisse zu sortieren.
scoringStatistics	ScoringStatistics	Ein Wert, der angibt, ob wir Bewertungsstatistiken (z. B. Dokumenthäufigkeit) global für eine konsistentere Bewertung oder lokal für niedrigere Latenz berechnen möchten. Der Standardwert ist "local". Verwenden Sie "global", um Bewertungsstatistiken global vor der Bewertung zu aggregieren. Die Verwendung von globalen Bewertungsstatistiken kann die Latenz von Suchabfragen erhöhen.
search	string	Ein Volltext-Suchabfrageausdruck; Verwenden Sie "*", oder lassen Sie diesen Parameter aus, um alle Dokumente abzugleichen.
searchFields	string	Die durch Trennzeichen getrennte Liste der Feldnamen, auf die die Volltextsuche angewendet werden soll. Bei Verwendung der feldbezogenen Suche (fieldName:searchExpression) in einer vollständigen Lucene-Abfrage haben die Feldnamen jedes feldbezogenen Suchausdrucks Vorrang vor allen feldnamen, die in diesem Parameter aufgeführt sind.
searchMode	SearchMode	Ein Wert, der angibt, ob eine oder alle Suchbegriffe übereinstimmen müssen, um das Dokument als Übereinstimmung zu zählen.
select	string	Die durch Trennzeichen getrennte Liste der abzurufenden Felder. Wenn nicht angegeben, sind alle Felder enthalten, die im Schema als abrufbar gekennzeichnet sind.
semanticConfiguration	string	Der Name einer semantischen Konfiguration, die beim Verarbeiten von Dokumenten für Abfragen der Typsemantik verwendet wird.
semanticErrorHandling	SemanticErrorMode	Ermöglicht dem Benutzer auszuwählen, ob ein semantischer Aufruf vollständig fehlschlagen soll (Standard-/aktuelles Verhalten) oder partielle Ergebnisse zurückzugeben.
semanticFields	string	Die durch Trennzeichen getrennte Liste der Feldnamen, die für die semantische Rangfolge verwendet werden.
semanticMaxWaitInMilliseconds	integer	Ermöglicht es dem Benutzer, eine obere Grenze für die Zeitspanne festzulegen, die für die semantische Anreicherung benötigt wird, um die Verarbeitung abzuschließen, bevor die Anforderung fehlschlägt.
semanticQuery	string	Ermöglicht das Festlegen einer separaten Suchabfrage, die ausschließlich für semantische Reranking, semantische Beschriftungen und semantische Antworten verwendet wird. Ist nützlich für Szenarien, in denen verschiedene Abfragen zwischen der Basisabruf- und Rangfolgephase und der L2-Semantikphase verwendet werden müssen.
sessionId	string	Ein Wert, der zum Erstellen einer Haftsitzung verwendet werden soll, was dazu beitragen kann, konsistentere Ergebnisse zu erzielen. Solange dieselbe sessionId verwendet wird, wird versucht, denselben Replikatsatz als Ziel zu verwenden. Seien Sie vorsichtig, dass die Wiederverwendung der gleichen SessionID-Werte wiederholt den Lastenausgleich der Anforderungen über Replikate hinweg beeinträchtigen und die Leistung des Suchdiensts beeinträchtigen kann. Der wert, der als sessionId verwendet wird, kann nicht mit einem '_'-Zeichen beginnen.
skip	integer	Die Anzahl der zu überspringenden Suchergebnisse. Dieser Wert darf nicht größer als 100.000 sein. Wenn Sie Dokumente sequenzieren müssen, aber aufgrund dieser Einschränkung nicht überspringen können, sollten Sie stattdessen "orderby" für einen vollständig sortierten Schlüssel verwenden und stattdessen mit einer Bereichsabfrage filtern.
speller	QuerySpellerType	Ein Wert, der den Typ der Rechtschreibprüfung angegeben hat, die für die Rechtschreibkorrektur einzelner Suchabfragebegriffe verwendet werden soll.
top	integer	Die Anzahl der abzurufenden Suchergebnisse. Dies kann in Verbindung mit $skip verwendet werden, um clientseitige Paging von Suchergebnissen zu implementieren. Wenn Ergebnisse aufgrund der serverseitigen Auslagerung abgeschnitten werden, enthält die Antwort ein Fortsetzungstoken, das verwendet werden kann, um eine andere Suchanforderung für die nächste Seite der Ergebnisse auszuweisen.
vectorFilterMode	VectorFilterMode	Bestimmt, ob Filter vor oder nach der Vektorsuche angewendet werden. Der Standardwert ist 'preFilter' für neue Indizes.
vectorQueries	VectorQuery[]: RawVectorQuery[] VectorizableTextQuery[] VectorizableImageUrlQuery[] VectorizableImageBinaryQuery[]	Die Abfrageparameter für Vektor- und Hybridsuchabfragen.

Antworten

Name	Typ	Beschreibung
200 OK	SearchDocumentsResult	Antwort, die Dokumente enthält, die den Suchkriterien entsprechen.
Other Status Codes	ErrorResponse	Fehlerantwort.

Beispiele

SearchIndexSearchDocumentsPost

SearchIndexSearchDocumentsSemanticPost

SearchIndexSearchDocumentsPost

Beispielanforderung

HTTP

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


{
  "count": true,
  "facets": [
    "ownerId"
  ],
  "filter": "category eq 'purple' or category eq 'pink'",
  "highlight": "category",
  "highlightPostTag": "</em>",
  "highlightPreTag": "</em>",
  "orderby": "id desc",
  "queryType": "simple",
  "scoringStatistics": "global",
  "sessionId": "mysessionid",
  "scoringParameters": [
    "categoryTag:desiredCategoryValue"
  ],
  "scoringProfile": "stringFieldBoost",
  "search": "purple",
  "searchFields": "id,name,description,category,ownerId",
  "searchMode": "any",
  "select": "id,name,description,category,ownerId",
  "skip": 0,
  "top": 10,
  "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"
  }
}

Beispiel für eine Antwort

Statuscode:

200

{
  "@odata.count": 27,
  "@search.facets": {
    "ownerId": [
      {
        "count": 16,
        "value": "sam"
      },
      {
        "count": 8,
        "value": "ryan"
      },
      {
        "count": 3,
        "value": "benny"
      }
    ]
  },
  "value": [
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "no-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "empty-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "9",
      "name": "test",
      "description": "test9 hello",
      "category": "purple",
      "ownerId": "ryan"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "8",
      "name": "test",
      "description": "test8 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "7",
      "name": "test",
      "description": "test7 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "6",
      "name": "test",
      "description": "test6 hello",
      "category": "purple",
      "ownerId": "ryan"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "5",
      "name": "test",
      "description": "test5 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "4",
      "name": "test",
      "description": "test4 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "3",
      "name": "test",
      "description": "test3 hello",
      "category": "purple",
      "ownerId": "ryan"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "24",
      "name": "test",
      "description": "test24 hello",
      "category": "purple",
      "ownerId": "ryan"
    }
  ]
}

SearchIndexSearchDocumentsSemanticPost

Beispielanforderung

HTTP

POST https://myservice.search.windows.net/indexes('myindex')/docs/search.post.search?api-version=2024-11-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
}

Beispiel für eine Antwort

Statuscode:

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=2024-11-01-preview"
}

Definitionen

Name	Beschreibung
AnswerResult	Eine Antwort ist eine Textpassage, die aus dem Inhalt der relevantesten Dokumente extrahiert wurde, die der Abfrage entsprechen. Antworten werden aus den wichtigsten Suchergebnissen extrahiert. Antwortkandidaten werden bewertet, und die wichtigsten Antworten werden ausgewählt.
CaptionResult	Beschriftungen sind die repräsentativsten Passagen aus dem Dokument relativ zur Suchabfrage. Sie werden häufig als Dokumentzusammenfassung verwendet. Beschriftungen werden nur für Abfragen vom Typ semanticzurückgegeben.
DebugInfo	Enthält Debuginformationen, die verwendet werden können, um Ihre Suchergebnisse weiter zu untersuchen.
DocumentDebugInfo	Enthält Debuginformationen, die verwendet werden können, um Ihre Suchergebnisse weiter zu untersuchen.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
HybridCountAndFacetMode	Bestimmt, ob die Anzahl und die Facets alle Dokumente enthalten sollen, die mit der Suchabfrage übereinstimmen, oder nur die Dokumente, die im Fenster "maxTextRecallSize" abgerufen werden. Der Standardwert ist "countAllResults".
HybridSearch	TThe query parameters to configure hybrid search behaviors.
QueryAnswerType	Ein Wert, der angibt, ob Antworten als Teil der Suchantwort zurückgegeben werden sollen.
QueryCaptionType	Ein Wert, der angibt, ob Beschriftungen als Teil der Suchantwort zurückgegeben werden sollen.
QueryDebugMode	Ermöglicht ein Debuggingtool, mit dem Sie Ihre Suchergebnisse weiter untersuchen können. Sie können mehrere Debugmodi gleichzeitig aktivieren, indem Sie sie durch ein | trennen Zeichen, z. B. semantischer|queryRewrites.
QueryLanguage	Die Sprache der Abfrage.
QueryResultDocumentRerankerInput	Die unformatierten verketteten Zeichenfolgen, die an den semantischen Anreicherungsprozess gesendet wurden.
QueryResultDocumentSemanticField	Beschreibung von Feldern, die an den semantischen Anreicherungsprozess gesendet wurden, sowie deren Verwendung
QueryResultDocumentSubscores	Die Aufschlüsselung von Teilergebnissen zwischen den Text- und Vektorabfragekomponenten der Suchabfrage für dieses Dokument. Jede Vektorabfrage wird als separates Objekt in derselben Reihenfolge angezeigt, in der sie empfangen wurden.
QueryRewritesDebugInfo	Enthält Debugginginformationen, die für Abfrageumschreibungen spezifisch sind.
QueryRewritesType	Ein Wert, der angibt, ob Abfrageumschreibungen generiert werden sollen, um die Suchabfrage zu erweitern.
QueryRewritesValuesDebugInfo	Enthält Debugginginformationen, die für Abfrageumschreibungen spezifisch sind.
QuerySpellerType	Ein Wert, der den Typ der Rechtschreibprüfung angegeben hat, die für die Rechtschreibkorrektur einzelner Suchabfragebegriffe verwendet werden soll.
QueryType	Gibt die Syntax der Suchabfrage an. Der Standardwert ist "einfach". Verwenden Sie "vollständig", wenn ihre Abfrage die Lucene-Abfragesyntax und "Semantik" verwendet, wenn keine Abfragesyntax erforderlich ist.
RawVectorQuery	Die Abfrageparameter, die für die Vektorsuche verwendet werden sollen, wenn ein unformatierter Vektorwert bereitgestellt wird.
ScoringStatistics	Ein Wert, der angibt, ob wir Bewertungsstatistiken (z. B. Dokumenthäufigkeit) global für eine konsistentere Bewertung oder lokal für niedrigere Latenz berechnen möchten. Der Standardwert ist "local". Verwenden Sie "global", um Bewertungsstatistiken global vor der Bewertung zu aggregieren. Die Verwendung von globalen Bewertungsstatistiken kann die Latenz von Suchabfragen erhöhen.
SearchDocumentsResult	Antwort, die Suchergebnisse aus einem Index enthält.
SearchMode	Gibt an, ob eine oder alle Suchbegriffe übereinstimmen müssen, um das Dokument als Übereinstimmung zu zählen.
SearchRequest	Parameter zum Filtern, Sortieren, Faceting, Paging und anderen Suchabfrageverhalten.
SearchResult	Enthält ein Dokument, das von einer Suchabfrage gefunden wurde, sowie zugeordnete Metadaten.
SearchScoreThreshold	Die Ergebnisse der Vektorabfrage werden basierend auf dem Wert "@search.score" gefiltert. Beachten Sie, dass dies die @search.score, die als Teil der Suchantwort zurückgegeben wird. Die Schwellenwertrichtung wird für höhere @search.scoreausgewählt.
SemanticDebugInfo
SemanticErrorMode	Ermöglicht dem Benutzer auszuwählen, ob ein semantischer Aufruf vollständig fehlschlagen soll (Standard-/aktuelles Verhalten) oder partielle Ergebnisse zurückzugeben.
SemanticErrorReason	Grund für die Rückgabe einer teilweisen Antwort für eine semantische Bewertungsanforderung.
SemanticFieldState	Die Art und Weise, wie das Feld für den semantischen Anreicherungsprozess verwendet wurde (vollständig verwendet, teilweise verwendet oder nicht verwendet)
SemanticQueryRewritesResultType	Typ der Abfrageumschreibung, die für diese Anforderung verwendet wurde.
SemanticSearchResultsType	Typ der teilweisen Antwort, die für eine semantische Bewertungsanforderung zurückgegeben wurde.
SingleVectorFieldResult	Ein einzelnes Vektorfeldergebnis. Sowohl @search.score- als auch Vektor-Ähnlichkeitswerte werden zurückgegeben. Die Vektorähnlichkeit ist mit @search.score durch eine Formel verknüpft.
TextResult	Die BM25- oder Classic-Bewertung für den Textbereich der Abfrage.
VectorFilterMode	Bestimmt, ob Filter vor oder nach der Vektorsuche angewendet werden.
VectorizableImageBinaryQuery	Die Abfrageparameter, die für die Vektorsuche verwendet werden sollen, wenn eine base64-codierte Binärdatei eines Bilds bereitgestellt wird, das vektorisiert werden muss.
VectorizableImageUrlQuery	Die Abfrageparameter, die für die Vektorsuche verwendet werden sollen, wenn eine URL, die einen Bildwert darstellt, der vektorisiert werden muss, bereitgestellt wird.
VectorizableTextQuery	Die Abfrageparameter, die für die Vektorsuche verwendet werden sollen, wenn ein Textwert bereitgestellt wird, der vektorisiert werden muss.
VectorQueryKind	Die Art der ausgeführten Vektorabfrage.
VectorsDebugInfo
VectorSimilarityThreshold	Die Ergebnisse der Vektorabfrage werden basierend auf der Vektorgleichheitsmetrik gefiltert. Beachten Sie, dass dies die kanonische Definition der Ähnlichkeitsmetrik ist, nicht die Version des Abstands. Die Schwellenwertrichtung (größer oder kleiner) wird automatisch entsprechend der vom Feld verwendeten Metrik ausgewählt.
VectorThresholdKind	Die Art der ausgeführten Vektorabfrage.

AnswerResult

Eine Antwort ist eine Textpassage, die aus dem Inhalt der relevantesten Dokumente extrahiert wurde, die der Abfrage entsprechen. Antworten werden aus den wichtigsten Suchergebnissen extrahiert. Antwortkandidaten werden bewertet, und die wichtigsten Antworten werden ausgewählt.

Name	Typ	Beschreibung
highlights	string	Derselbe Textabschnitt wie in der Texteigenschaft mit hervorgehobenen Textausdrücken, die für die Abfrage am relevantesten sind.
key	string	Der Schlüssel des Dokuments, aus dem die Antwort extrahiert wurde.
score	number	Der Bewertungswert stellt dar, wie relevant die Antwort auf die Abfrage relativ zu anderen Antworten ist, die für die Abfrage zurückgegeben werden.
text	string	Die aus dem Dokumentinhalt extrahierte Textpassage als Antwort.

CaptionResult

Beschriftungen sind die repräsentativsten Passagen aus dem Dokument relativ zur Suchabfrage. Sie werden häufig als Dokumentzusammenfassung verwendet. Beschriftungen werden nur für Abfragen vom Typ semanticzurückgegeben.

Name	Typ	Beschreibung
highlights	string	Derselbe Textabschnitt wie in der Text-Eigenschaft mit hervorgehobenen Ausdrücken, die für die Abfrage am relevantesten sind.
text	string	Ein repräsentativer Textabschnitt, der aus dem Dokument extrahiert wurde, das für die Suchabfrage am relevantesten ist.

DebugInfo

Enthält Debuginformationen, die verwendet werden können, um Ihre Suchergebnisse weiter zu untersuchen.

Name	Typ	Beschreibung
queryRewrites	QueryRewritesDebugInfo	Enthält Debugginginformationen, die für Abfrageumschreibungen spezifisch sind.

DocumentDebugInfo

Enthält Debuginformationen, die verwendet werden können, um Ihre Suchergebnisse weiter zu untersuchen.

Name	Typ	Beschreibung
semantic	SemanticDebugInfo	Enthält Debugginginformationen, die für semantische Rangfolgenanforderungen spezifisch sind.
vectors	VectorsDebugInfo	Enthält Debugginginformationen, die Vektor- und Hybridsuche spezifisch sind.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

HybridCountAndFacetMode

Bestimmt, ob die Anzahl und die Facets alle Dokumente enthalten sollen, die mit der Suchabfrage übereinstimmen, oder nur die Dokumente, die im Fenster "maxTextRecallSize" abgerufen werden. Der Standardwert ist "countAllResults".

Name	Typ	Beschreibung
countAllResults	string	Schließen Sie alle Dokumente ein, die von der Suchabfrage abgeglichen wurden, wenn sie "Anzahl" und "Facets" berechnen, unabhängig davon, ob sich diese Dokumente im Abruffenster "maxTextRecallSize" befinden.
countRetrievableResults	string	Schließen Sie nur Dokumente ein, die im Abruffenster "maxTextRecallSize" abgeglichen wurden, wenn "Anzahl" und "Facets" verarbeitet werden.

HybridSearch

TThe query parameters to configure hybrid search behaviors.

Name	Typ	Beschreibung
countAndFacetMode	HybridCountAndFacetMode	Bestimmt, ob die Anzahl und die Facets alle Dokumente enthalten sollen, die mit der Suchabfrage übereinstimmen, oder nur die Dokumente, die im Fenster "maxTextRecallSize" abgerufen werden.
maxTextRecallSize	integer	Bestimmt die maximale Anzahl von Dokumenten, die vom Textabfrageteil einer Hybridsuchanforderung abgerufen werden sollen. Diese Dokumente werden mit den Dokumenten kombiniert, die den Vektorabfragen entsprechen, um eine einzelne endgültige Liste der Ergebnisse zu erstellen. Wenn Sie einen größeren maxTextRecallSize-Wert auswählen, können Sie mehr Dokumente abrufen und auslagerungen (mit den parametern "top" und "skip"), zu Kosten einer höheren Ressourcenauslastung und höherer Latenz. Der Wert muss zwischen 1 und 10.000 sein. Der Standardwert ist 1000.

QueryAnswerType

Ein Wert, der angibt, ob Antworten als Teil der Suchantwort zurückgegeben werden sollen.

Name	Typ	Beschreibung
extractive	string	Extrahiert Antwortkandidaten aus dem Inhalt der zurückgegebenen Dokumente als Antwort auf eine Abfrage, die als Frage in natürlicher Sprache ausgedrückt wird.
none	string	Geben Sie keine Antworten für die Abfrage zurück.

QueryCaptionType

Ein Wert, der angibt, ob Beschriftungen als Teil der Suchantwort zurückgegeben werden sollen.

Name	Typ	Beschreibung
extractive	string	Extrahiert Beschriftungen aus den übereinstimmenden Dokumenten, die Passagen enthalten, die für die Suchabfrage relevant sind.
none	string	Geben Sie keine Beschriftungen für die Abfrage zurück.

QueryDebugMode

Ermöglicht ein Debuggingtool, mit dem Sie Ihre Suchergebnisse weiter untersuchen können. Sie können mehrere Debugmodi gleichzeitig aktivieren, indem Sie sie durch ein | trennen Zeichen, z. B. semantischer|queryRewrites.

Name	Typ	Beschreibung
all	string	Aktivieren Sie alle Debugoptionen.
disabled	string	Es werden keine Abfragedebugginginformationen zurückgegeben.
queryRewrites	string	Ermöglicht es dem Benutzer, die Liste der Abfrageumschreibungen zu untersuchen, die für ihre Suchanforderung generiert wurden.
semantic	string	Ermöglicht es dem Benutzer, seine neu bewerteten Ergebnisse weiter zu untersuchen.
vector	string	Ermöglicht es dem Benutzer, seine Hybrid- und Vektorabfrageergebnisse weiter zu untersuchen.

QueryLanguage

Die Sprache der Abfrage.

Name	Typ	Beschreibung
ar-eg	string	Abfragesprachenwert für Arabisch (Ägypten).
ar-jo	string	Abfragesprachenwert für Arabisch (Jordanien).
ar-kw	string	Abfragesprachenwert für Arabisch (Kuwait).
ar-ma	string	Abfragesprachenwert für Arabisch (Marokko).
ar-sa	string	Abfragesprachenwert für Arabisch (Saudi-Arabien).
bg-bg	string	Abfragesprachewert für Bulgarisch (Bulgarien).
bn-in	string	Abfragesprachewert für Bengali (Indien).
ca-es	string	Abfragesprachewert für Katalanisch.
cs-cz	string	Abfragesprachewert für Tschechisch (Tschechische Republik).
da-dk	string	Abfragesprachewert für Dänisch (Dänemark).
de-de	string	Abfragesprachewert für Deutsch (Deutschland).
el-gr	string	Abfragesprachewert für Griechisch (Griechenland).
en-au	string	Abfragesprachewert für Englisch (Australien).
en-ca	string	Abfragesprachenwert für Englisch (Kanada).
en-gb	string	Abfragesprachewert für Englisch (Großbritannien).
en-in	string	Abfragesprachewert für Englisch (Indien).
en-us	string	Abfragesprachenwert für Englisch (USA).
es-es	string	Abfragesprachenwert für Spanisch (Spanien).
es-mx	string	Abfragesprachenwert für Spanisch (Mexiko).
et-ee	string	Abfragesprachewert für Estnisch (Estland).
eu-es	string	Abfragesprachewert für Baskisch.
fa-ae	string	Abfragesprachewert für Persisch (U.A.E.).
fi-fi	string	Abfragesprachewert für Finnisch (Finnland).
fr-ca	string	Abfragesprachewert für Französisch (Kanada).
fr-fr	string	Abfragesprachewert für Französisch (Frankreich).
ga-ie	string	Abfragesprachewert für Irisch (Irland).
gl-es	string	Abfragesprachewert für Galizien.
gu-in	string	Abfragesprachewert für Gujarati (Indien).
he-il	string	Abfragesprachenwert für Hebräisch (Israel).
hi-in	string	Abfragesprachewert für Hindi (Indien).
hr-ba	string	Abfragesprachenwert für Kroatisch (Bosnien und Herzegowina).
hr-hr	string	Abfragesprachenwert für Kroatisch (Kroatien).
hu-hu	string	Abfragesprachewert für Ungarisch (Ungarn).
hy-am	string	Abfragesprachewert für Armenisch (Armenien).
id-id	string	Abfragesprachewert für Indonesisch (Indonesien).
is-is	string	Abfragesprachewert für Island (Island).
it-it	string	Abfragesprachewert für Italienisch (Italien).
ja-jp	string	Abfragesprachewert für Japanisch (Japan).
kn-in	string	Abfragesprachewert für Kannada (Indien).
ko-kr	string	Abfragesprachewert für Koreanisch (Korea).
lt-lt	string	Abfragesprachewert für Litauisch (Litauen).
lv-lv	string	Abfragesprachewert für Lettisch (Lettland).
ml-in	string	Abfragesprachewert für Malayalam (Indien).
mr-in	string	Abfragesprachenwert für Marathi (Indien).
ms-bn	string	Abfragesprachewert für Malaiisch (Brunei Darussalam).
ms-my	string	Abfragesprachewert für Malaiisch (Malaysia).
nb-no	string	Abfragesprachewert für Norwegisch (Norwegen).
nl-be	string	Abfragesprachewert für Niederländisch (Belgien).
nl-nl	string	Abfragesprachewert für Niederländisch (Niederlande).
no-no	string	Abfragesprachewert für Norwegisch (Norwegen).
none	string	Abfragesprache nicht angegeben.
pa-in	string	Abfragesprachewert für Punjabi (Indien).
pl-pl	string	Abfragesprachewert für Polnisch (Polen).
pt-br	string	Abfragesprachewert für Portugiesisch (Brasilien).
pt-pt	string	Abfragesprachewert für Portugiesisch (Portugal).
ro-ro	string	Abfragesprachenwert für Rumänisch (Rumänien).
ru-ru	string	Abfragesprachenwert für Russisch (Russland).
sk-sk	string	Abfragesprachewert für Slowakisch (Slowakei).
sl-sl	string	Abfragesprachewert für Slowenisch (Slowenien).
sr-ba	string	Abfragesprachenwert für Serbisch (Bosnien und Herzegowina).
sr-me	string	Abfragesprachewert für Serbisch (Montenegro).
sr-rs	string	Abfragesprachewert für Serbisch (Serbien).
sv-se	string	Abfragesprachewert für Schwedisch (Schweden).
ta-in	string	Abfragesprachewert für Tamil (Indien).
te-in	string	Abfragesprachewert für Telugu (Indien).
th-th	string	Abfragesprachewert für Thailändisch (Thailand).
tr-tr	string	Abfragesprachewert für Türkisch (Türkei).
uk-ua	string	Abfragesprachewert für Ukrainisch (Ukraine).
ur-pk	string	Abfragesprachenwert für Urdu (Pakistan).
vi-vn	string	Abfragesprachenwert für Vietnamesisch (Vietnam).
zh-cn	string	Abfragesprachenwert für Chinesisch (China).
zh-tw	string	Abfragesprachenwert für Chinesisch (Taiwan).

QueryResultDocumentRerankerInput

Die unformatierten verketteten Zeichenfolgen, die an den semantischen Anreicherungsprozess gesendet wurden.

Name	Typ	Beschreibung
content	string	Die unformatierten verketteten Zeichenfolgen für die Inhaltsfelder, die für die semantische Anreicherung verwendet wurden.
keywords	string	Die unformatierten verketteten Zeichenfolgen für die Schlüsselwortfelder, die für die semantische Anreicherung verwendet wurden.
title	string	Die rohe Zeichenfolge für das Titelfeld, das für die semantische Anreicherung verwendet wurde.

QueryResultDocumentSemanticField

Beschreibung von Feldern, die an den semantischen Anreicherungsprozess gesendet wurden, sowie deren Verwendung

Name	Typ	Beschreibung
name	string	Der Name des Felds, das an den semantischen Anreicherungsprozess gesendet wurde
state	SemanticFieldState	Die Art und Weise, wie das Feld für den semantischen Anreicherungsprozess verwendet wurde (vollständig verwendet, teilweise verwendet oder nicht verwendet)

QueryResultDocumentSubscores

Die Aufschlüsselung von Teilergebnissen zwischen den Text- und Vektorabfragekomponenten der Suchabfrage für dieses Dokument. Jede Vektorabfrage wird als separates Objekt in derselben Reihenfolge angezeigt, in der sie empfangen wurden.

Name	Typ	Beschreibung
documentBoost	number	Die BM25- oder Classic-Bewertung für den Textbereich der Abfrage.
text	TextResult	Die BM25- oder Classic-Bewertung für den Textbereich der Abfrage.
vectors	<string,  SingleVectorFieldResult>	Die Vektorähnlichkeit und @search.score Werte für jede Vektorabfrage.

QueryRewritesDebugInfo

Enthält Debugginginformationen, die für Abfrageumschreibungen spezifisch sind.

Name	Typ	Beschreibung
text	QueryRewritesValuesDebugInfo	Liste der für die Textabfrage generierten Abfrageumschreibungen.
vectors	QueryRewritesValuesDebugInfo[]	Liste der für die vektorisierbaren Textabfragen generierten Abfrageumschreibungen.

QueryRewritesType

Ein Wert, der angibt, ob Abfrageumschreibungen generiert werden sollen, um die Suchabfrage zu erweitern.

Name	Typ	Beschreibung
generative	string	Generieren Sie alternative Abfragebegriffe, um den Rückruf einer Suchanforderung zu erhöhen.
none	string	Generieren Sie keine zusätzlichen Abfrageumschreibungen für diese Abfrage.

QueryRewritesValuesDebugInfo

Enthält Debugginginformationen, die für Abfrageumschreibungen spezifisch sind.

Name	Typ	Beschreibung
inputQuery	string	Der Eingabetext für das generative Abfrageumschreibungsmodell. Es kann vorkommen, dass die Benutzerabfrage und die Eingabe für das generative Modell nicht identisch sind.
rewrites	string[]	Liste der Abfrageumschreibungen.

QuerySpellerType

Ein Wert, der den Typ der Rechtschreibprüfung angegeben hat, die für die Rechtschreibkorrektur einzelner Suchabfragebegriffe verwendet werden soll.

Name	Typ	Beschreibung
lexicon	string	Die Rechtschreibprüfung korrigiert einzelne Abfragebegriffe mithilfe eines statischen Lexicons für die sprache, die vom Parameter "queryLanguage" angegeben wird.
none	string	Die Rechtschreibprüfung ist nicht aktiviert.

QueryType

Gibt die Syntax der Suchabfrage an. Der Standardwert ist "einfach". Verwenden Sie "vollständig", wenn ihre Abfrage die Lucene-Abfragesyntax und "Semantik" verwendet, wenn keine Abfragesyntax erforderlich ist.

Name	Typ	Beschreibung
full	string	Verwendet die vollständige Lucene-Abfragesyntax für Suchvorgänge. Suchtext wird mithilfe der Lucene-Abfragesprache interpretiert, die feldspezifische und gewichtete Suchvorgänge sowie andere erweiterte Features ermöglicht.
semantic	string	Am besten geeignet für Abfragen, die in natürlicher Sprache ausgedrückt werden, im Gegensatz zu Schlüsselwörtern. Verbessert die Genauigkeit von Suchergebnissen, indem die wichtigsten Suchergebnisse mithilfe eines bewertungsmodells, das im Webkorpus trainiert wurde, neu sortiert werden.
simple	string	Verwendet die einfache Abfragesyntax für Suchvorgänge. Suchtext wird mithilfe einer einfachen Abfragesprache interpretiert, die Symbole wie +, * und "" zulässt. Abfragen werden standardmäßig für alle durchsuchbaren Felder ausgewertet, es sei denn, der Parameter searchFields ist angegeben.

RawVectorQuery

Die Abfrageparameter, die für die Vektorsuche verwendet werden sollen, wenn ein unformatierter Vektorwert bereitgestellt wird.

Name	Typ	Beschreibung
exhaustive	boolean	Wenn wahr, löst eine vollständige k-nächste Nachbarsuche über alle Vektoren innerhalb des Vektorindex aus. Nützlich für Szenarien, in denen genaue Übereinstimmungen kritisch sind, z. B. das Bestimmen von Boden-Wahrheitswerten.
fields	string	Vektorfelder vom Typ Collection(Edm.Single), die in den durchsuchten Vektor einbezogen werden sollen.
filterOverride	string	Der OData-Filterausdruck, der auf diese spezifische Vektorabfrage angewendet werden soll. Wenn kein Filterausdruck auf Vektorebene definiert ist, wird stattdessen der im Filterparameter der obersten Ebene definierte Ausdruck verwendet.
k	integer	Die Anzahl der nächsten Nachbarn, die als Toptreffer zurückgegeben werden sollen.
kind	string: vector	Die Art der ausgeführten Vektorabfrage.
oversampling	number	Übersamplingfaktor. Der Mindestwert ist 1. Er überschreibt den in der Indexdefinition konfigurierten Parameter "defaultOversampling". Sie kann nur festgelegt werden, wenn "rerankWithOriginalVectors" wahr ist. Dieser Parameter ist nur zulässig, wenn eine Komprimierungsmethode für das zugrunde liegende Vektorfeld verwendet wird.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Der Schwellenwert, der für Vektorabfragen verwendet wird. Beachten Sie, dass dies nur festgelegt werden kann, wenn alle "Felder" dieselbe Ähnlichkeitsmetrik verwenden.
vector	number[]	Die Vektordarstellung einer Suchabfrage.
weight	number	Relative Gewichtung der Vektorabfrage im Vergleich zu anderen Vektorabfragen und/oder der Textabfrage innerhalb derselben Suchanforderung. Dieser Wert wird verwendet, wenn die Ergebnisse mehrerer Bewertungslisten kombiniert werden, die von den verschiedenen Vektorabfragen und/oder den ergebnissen, die über die Textabfrage abgerufen wurden. Je höher die Gewichtung ist, desto höher sind die Dokumente, die dieser Abfrage entsprechen, in der endgültigen Rangfolge. Der Standardwert ist 1,0 und der Wert muss eine positive Zahl größer als 0 sein.

ScoringStatistics

Ein Wert, der angibt, ob wir Bewertungsstatistiken (z. B. Dokumenthäufigkeit) global für eine konsistentere Bewertung oder lokal für niedrigere Latenz berechnen möchten. Der Standardwert ist "local". Verwenden Sie "global", um Bewertungsstatistiken global vor der Bewertung zu aggregieren. Die Verwendung von globalen Bewertungsstatistiken kann die Latenz von Suchabfragen erhöhen.

Name	Typ	Beschreibung
global	string	Die Bewertungsstatistiken werden global für eine konsistentere Bewertung berechnet.
local	string	Die Bewertungsstatistiken werden lokal für niedrigere Latenz berechnet.

SearchDocumentsResult

Antwort, die Suchergebnisse aus einem Index enthält.

Name	Typ	Beschreibung
@odata.count	integer	Die Gesamtanzahl der Ergebnisse, die vom Suchvorgang gefunden wurden, oder NULL, wenn die Anzahl nicht angefordert wurde. Wenn vorhanden, kann die Anzahl größer als die Anzahl der Ergebnisse in dieser Antwort sein. Dies kann passieren, wenn Sie die parameter $top oder $skip verwenden oder wenn die Abfrage nicht alle angeforderten Dokumente in einer einzigen Antwort zurückgeben kann.
@odata.nextLink	string	Die Fortsetzungs-URL wird zurückgegeben, wenn die Abfrage nicht alle angeforderten Ergebnisse in einer einzigen Antwort zurückgeben kann. Sie können diese URL verwenden, um eine andere GET- oder POST-Suchanforderung zu formulieren, um den nächsten Teil der Suchantwort abzurufen. Stellen Sie sicher, dass Sie das gleiche Verb (GET oder POST) wie die Anforderung verwenden, die diese Antwort erstellt hat.
@search.answers	AnswerResult[]	Die Ergebnisse der Antwortabfrage für den Suchvorgang; null, wenn der Antwortabfrageparameter nicht angegeben oder auf 'none' festgelegt wurde.
@search.coverage	number	Ein Wert, der den Prozentsatz des Indexes angibt, der in der Abfrage enthalten war, oder null, wenn minimumCoverage nicht in der Anforderung angegeben wurde.
@search.debug	DebugInfo	Debuggen Sie Informationen, die für die Suchergebnisse als Ganzes gelten.
@search.facets	object	Die Facetabfrageergebnisse für den Suchvorgang, organisiert als Sammlung von Buckets für jedes faceted-Feld; null, wenn die Abfrage keine Facetausdrücke enthält.
@search.nextPageParameters	SearchRequest	Die JSON-Fortsetzungsnutzlast wird zurückgegeben, wenn die Abfrage nicht alle angeforderten Ergebnisse in einer einzigen Antwort zurückgeben kann. Sie können diesen JSON-Code zusammen mit @odata.nextLink verwenden, um eine andere POST-Suchanforderung zu formulieren, um den nächsten Teil der Suchantwort zu erhalten.
@search.semanticPartialResponseReason	SemanticErrorReason	Grund für die Rückgabe einer teilweisen Antwort für eine semantische Bewertungsanforderung.
@search.semanticPartialResponseType	SemanticSearchResultsType	Typ der teilweisen Antwort, die für eine semantische Bewertungsanforderung zurückgegeben wurde.
@search.semanticQueryRewritesResultType	SemanticQueryRewritesResultType	Typ der Abfrageumschreibung, die zum Abrufen von Dokumenten verwendet wurde.
value	SearchResult[]	Die Abfolge der ergebnisse, die von der Abfrage zurückgegeben werden.

SearchMode

Gibt an, ob eine oder alle Suchbegriffe übereinstimmen müssen, um das Dokument als Übereinstimmung zu zählen.

Name	Typ	Beschreibung
all	string	Alle Suchbegriffe müssen übereinstimmen, um das Dokument als Übereinstimmung zu zählen.
any	string	Alle Suchbegriffe müssen übereinstimmen, um das Dokument als Übereinstimmung zu zählen.

SearchRequest

Parameter zum Filtern, Sortieren, Faceting, Paging und anderen Suchabfrageverhalten.

Name	Typ	Beschreibung
answers	QueryAnswerType	Ein Wert, der angibt, ob Antworten als Teil der Suchantwort zurückgegeben werden sollen.
captions	QueryCaptionType	Ein Wert, der angibt, ob Beschriftungen als Teil der Suchantwort zurückgegeben werden sollen.
count	boolean	Ein Wert, der angibt, ob die Gesamtanzahl der Ergebnisse abgerufen werden soll. Der Standardwert ist "false". Das Festlegen dieses Werts auf "true" hat möglicherweise auswirkungen auf die Leistung. Beachten Sie, dass die zurückgegebene Anzahl eine Annäherung ist.
debug	QueryDebugMode	Ermöglicht ein Debuggingtool, das verwendet werden kann, um Ihre neu bewerteten Ergebnisse weiter zu untersuchen.
facets	string[]	Die Liste der Facetausdrücke, die auf die Suchabfrage angewendet werden sollen. Jeder Facetausdruck enthält einen Feldnamen, optional gefolgt von einer durch Trennzeichen getrennten Liste von Name:Wert-Paaren.
filter	string	Der OData-$filter Ausdruck, der auf die Suchabfrage angewendet werden soll.
highlight	string	Die durch Trennzeichen getrennte Liste der Feldnamen, die für Trefferhighlights verwendet werden sollen. Nur durchsuchbare Felder können zum Hervorheben von Treffern verwendet werden.
highlightPostTag	string	Ein Zeichenfolgentag, das an Trefferhighlights angefügt wird. Muss mit highlightPreTag festgelegt werden. Der Standardwert ist </em>.
highlightPreTag	string	Ein Zeichenfolgentag, das den Trefferhighlights vorangestellt ist. Muss mit highlightPostTag festgelegt werden. Der Standardwert ist <em>.
hybridSearch	HybridSearch	Die Abfrageparameter zum Konfigurieren von Hybridsuchverhalten.
minimumCoverage	number	Eine Zahl zwischen 0 und 100, die den Prozentsatz des Indexes angibt, der von einer Suchabfrage abgedeckt werden muss, damit die Abfrage als Erfolg gemeldet werden kann. Dieser Parameter kann hilfreich sein, um die Suchverfügbarkeit auch für Dienste mit nur einem Replikat sicherzustellen. Der Standardwert ist 100.
orderby	string	Die durch Trennzeichen getrennte Liste der OData-$orderby Ausdrücke, nach denen die Ergebnisse sortiert werden sollen. Jeder Ausdruck kann entweder ein Feldname oder ein Aufruf der Funktionen geo.distance() oder search.score() sein. Jedem Ausdruck kann asc folgen, um aufsteigend oder desc anzuzeigen, um absteigend anzugeben. Der Standardwert ist die aufsteigende Reihenfolge. Die Verknüpfungen werden durch die Übereinstimmungsergebnisse von Dokumenten unterbrochen. Wenn keine $orderby angegeben ist, wird die Standardsortierreihenfolge nach Dokumentabgleichsbewertung absteigend ausgeführt. Es können höchstens 32 $orderby Klauseln vorhanden sein.
queryLanguage	QueryLanguage	Ein Wert, der die Sprache der Suchabfrage angibt.
queryRewrites	QueryRewritesType	Ein Wert, der angibt, ob Abfrageumschreibungen generiert werden sollen, um die Suchabfrage zu erweitern.
queryType	QueryType	Ein Wert, der die Syntax der Suchabfrage angibt. Der Standardwert ist "einfach". Verwenden Sie "vollständig", wenn Ihre Abfrage die Lucene-Abfragesyntax verwendet.
scoringParameters	string[]	Die Liste der Parameterwerte, die in Bewertungsfunktionen (z. B. referencePointParameter) mit den Formatnamenwerten verwendet werden sollen. Wenn das Bewertungsprofil beispielsweise eine Funktion mit einem Parameter namens "mylocation" definiert, lautet die Parameterzeichenfolge "mylocation--122.2,44.8" (ohne anführungszeichen).
scoringProfile	string	Der Name eines Bewertungsprofils, um Übereinstimmungsergebnisse für übereinstimmende Dokumente auszuwerten, um die Ergebnisse zu sortieren.
scoringStatistics	ScoringStatistics	Ein Wert, der angibt, ob wir Bewertungsstatistiken (z. B. Dokumenthäufigkeit) global für eine konsistentere Bewertung oder lokal für niedrigere Latenz berechnen möchten. Der Standardwert ist "local". Verwenden Sie "global", um Bewertungsstatistiken global vor der Bewertung zu aggregieren. Die Verwendung von globalen Bewertungsstatistiken kann die Latenz von Suchabfragen erhöhen.
search	string	Ein Volltext-Suchabfrageausdruck; Verwenden Sie "*", oder lassen Sie diesen Parameter aus, um alle Dokumente abzugleichen.
searchFields	string	Die durch Trennzeichen getrennte Liste der Feldnamen, auf die die Volltextsuche angewendet werden soll. Bei Verwendung der feldbezogenen Suche (fieldName:searchExpression) in einer vollständigen Lucene-Abfrage haben die Feldnamen jedes feldbezogenen Suchausdrucks Vorrang vor allen feldnamen, die in diesem Parameter aufgeführt sind.
searchMode	SearchMode	Ein Wert, der angibt, ob eine oder alle Suchbegriffe übereinstimmen müssen, um das Dokument als Übereinstimmung zu zählen.
select	string	Die durch Trennzeichen getrennte Liste der abzurufenden Felder. Wenn nicht angegeben, sind alle Felder enthalten, die im Schema als abrufbar gekennzeichnet sind.
semanticConfiguration	string	Der Name einer semantischen Konfiguration, die beim Verarbeiten von Dokumenten für Abfragen der Typsemantik verwendet wird.
semanticErrorHandling	SemanticErrorMode	Ermöglicht dem Benutzer auszuwählen, ob ein semantischer Aufruf vollständig fehlschlagen soll (Standard-/aktuelles Verhalten) oder partielle Ergebnisse zurückzugeben.
semanticFields	string	Die durch Trennzeichen getrennte Liste der Feldnamen, die für die semantische Rangfolge verwendet werden.
semanticMaxWaitInMilliseconds	integer	Ermöglicht es dem Benutzer, eine obere Grenze für die Zeitspanne festzulegen, die für die semantische Anreicherung benötigt wird, um die Verarbeitung abzuschließen, bevor die Anforderung fehlschlägt.
semanticQuery	string	Ermöglicht das Festlegen einer separaten Suchabfrage, die ausschließlich für semantische Reranking, semantische Beschriftungen und semantische Antworten verwendet wird. Ist nützlich für Szenarien, in denen verschiedene Abfragen zwischen der Basisabruf- und Rangfolgephase und der L2-Semantikphase verwendet werden müssen.
sessionId	string	Ein Wert, der zum Erstellen einer Haftsitzung verwendet werden soll, was dazu beitragen kann, konsistentere Ergebnisse zu erzielen. Solange dieselbe sessionId verwendet wird, wird versucht, denselben Replikatsatz als Ziel zu verwenden. Seien Sie vorsichtig, dass die Wiederverwendung der gleichen SessionID-Werte wiederholt den Lastenausgleich der Anforderungen über Replikate hinweg beeinträchtigen und die Leistung des Suchdiensts beeinträchtigen kann. Der wert, der als sessionId verwendet wird, kann nicht mit einem '_'-Zeichen beginnen.
skip	integer	Die Anzahl der zu überspringenden Suchergebnisse. Dieser Wert darf nicht größer als 100.000 sein. Wenn Sie Dokumente sequenzieren müssen, aber aufgrund dieser Einschränkung nicht überspringen können, sollten Sie stattdessen "orderby" für einen vollständig sortierten Schlüssel verwenden und stattdessen mit einer Bereichsabfrage filtern.
speller	QuerySpellerType	Ein Wert, der den Typ der Rechtschreibprüfung angegeben hat, die für die Rechtschreibkorrektur einzelner Suchabfragebegriffe verwendet werden soll.
top	integer	Die Anzahl der abzurufenden Suchergebnisse. Dies kann in Verbindung mit $skip verwendet werden, um clientseitige Paging von Suchergebnissen zu implementieren. Wenn Ergebnisse aufgrund der serverseitigen Auslagerung abgeschnitten werden, enthält die Antwort ein Fortsetzungstoken, das verwendet werden kann, um eine andere Suchanforderung für die nächste Seite der Ergebnisse auszuweisen.
vectorFilterMode	VectorFilterMode	Bestimmt, ob Filter vor oder nach der Vektorsuche angewendet werden. Der Standardwert ist 'preFilter' für neue Indizes.
vectorQueries	VectorQuery[]: RawVectorQuery[] VectorizableImageBinaryQuery[] VectorizableImageUrlQuery[] VectorizableTextQuery[]	Die Abfrageparameter für Vektor- und Hybridsuchabfragen.

SearchResult

Enthält ein Dokument, das von einer Suchabfrage gefunden wurde, sowie zugeordnete Metadaten.

Name	Typ	Beschreibung
@search.captions	CaptionResult[]	Beschriftungen sind die repräsentativsten Passagen aus dem Dokument relativ zur Suchabfrage. Sie werden häufig als Dokumentzusammenfassung verwendet. Beschriftungen werden nur für Abfragen vom Typ "Semantik" zurückgegeben.
@search.documentDebugInfo	DocumentDebugInfo[]	Enthält Debuginformationen, die verwendet werden können, um Ihre Suchergebnisse weiter zu untersuchen.
@search.highlights	object	Textfragmente aus dem Dokument, die die übereinstimmenden Suchbegriffe angeben, sortiert nach jedem anwendbaren Feld; null, wenn die Treffermarkierung für die Abfrage nicht aktiviert war.
@search.rerankerScore	number	Die Relevanzbewertung, die vom semantischen Rangfolger für die wichtigsten Suchergebnisse berechnet wird. Suchergebnisse werden zuerst nach "RerankerScore" und dann nach der Bewertung sortiert. RerankerScore wird nur für Abfragen vom Typ 'Semantik' zurückgegeben.
@search.score	number	Die Relevanzbewertung des Dokuments im Vergleich zu anderen Dokumenten, die von der Abfrage zurückgegeben werden.

SearchScoreThreshold

Die Ergebnisse der Vektorabfrage werden basierend auf dem Wert "@search.score" gefiltert. Beachten Sie, dass dies die @search.score, die als Teil der Suchantwort zurückgegeben wird. Die Schwellenwertrichtung wird für höhere @search.scoreausgewählt.

Name	Typ	Beschreibung
kind	string: searchScore	Die Art des Schwellenwerts zum Filtern von Vektorabfragen
value	number	Der Schwellenwert wird basierend auf dem Wert "@search.score" gefiltert. Beachten Sie, dass dies die @search.score, die als Teil der Suchantwort zurückgegeben wird. Die Schwellenwertrichtung wird für höhere @search.scoreausgewählt.

SemanticDebugInfo

Name	Typ	Beschreibung
contentFields	QueryResultDocumentSemanticField[]	Die Inhaltsfelder, die an den semantischen Anreicherungsprozess gesendet wurden, sowie deren Verwendung
keywordFields	QueryResultDocumentSemanticField[]	Die Schlüsselwortfelder, die an den semantischen Anreicherungsprozess gesendet wurden, sowie deren Verwendung
rerankerInput	QueryResultDocumentRerankerInput	Die unformatierten verketteten Zeichenfolgen, die an den semantischen Anreicherungsprozess gesendet wurden.
titleField	QueryResultDocumentSemanticField	Das Titelfeld, das an den semantischen Anreicherungsprozess gesendet wurde und wie es verwendet wurde

SemanticErrorMode

Ermöglicht dem Benutzer auszuwählen, ob ein semantischer Aufruf vollständig fehlschlagen soll (Standard-/aktuelles Verhalten) oder partielle Ergebnisse zurückzugeben.

Name	Typ	Beschreibung
fail	string	Wenn während des semantischen Verarbeitungsschritts eine Ausnahme auftritt, schlägt die Abfrage fehl und gibt abhängig vom Fehler den entsprechenden HTTP-Code zurück.
partial	string	Wenn die semantische Verarbeitung fehlschlägt, werden weiterhin Teilergebnisse zurückgegeben. Die Definition von Teilergebnissen hängt davon ab, welcher semantische Schritt fehlgeschlagen ist und was der Grund für einen Fehler war.

SemanticErrorReason

Grund für die Rückgabe einer teilweisen Antwort für eine semantische Bewertungsanforderung.

Name	Typ	Beschreibung
capacityOverloaded	string	Die Anforderung wurde gedrosselt. Es wurden nur die Basisergebnisse zurückgegeben.
maxWaitExceeded	string	Wenn semanticMaxWaitInMilliseconds festgelegt wurde und die Semantikverarbeitungsdauer diesen Wert überschritten hat. Es wurden nur die Basisergebnisse zurückgegeben.
transient	string	Mindestens ein Schritt des semantischen Prozesses ist fehlgeschlagen.

SemanticFieldState

Die Art und Weise, wie das Feld für den semantischen Anreicherungsprozess verwendet wurde (vollständig verwendet, teilweise verwendet oder nicht verwendet)

Name	Typ	Beschreibung
partial	string	Das Feld wurde teilweise für semantische Anreicherung verwendet.
unused	string	Das Feld wurde nicht für semantische Anreicherung verwendet.
used	string	Das Feld wurde vollständig für semantische Anreicherung verwendet.

SemanticQueryRewritesResultType

Typ der Abfrageumschreibung, die für diese Anforderung verwendet wurde.

Name	Typ	Beschreibung
originalQueryOnly	string	Abfrageumschreibungen wurden für diese Anforderung nicht erfolgreich generiert. Nur die ursprüngliche Abfrage wurde zum Abrufen der Ergebnisse verwendet.

SemanticSearchResultsType

Typ der teilweisen Antwort, die für eine semantische Bewertungsanforderung zurückgegeben wurde.

Name	Typ	Beschreibung
baseResults	string	Ergebnisse ohne semantische Anreicherung oder Reranking.
rerankedResults	string	Die Ergebnisse wurden mit dem Reranker-Modell neu bewertet und enthalten semantische Beschriftungen. Sie enthalten keine Antworten, Antworthighlights oder Beschriftungshighlights.

SingleVectorFieldResult

Ein einzelnes Vektorfeldergebnis. Sowohl @search.score- als auch Vektor-Ähnlichkeitswerte werden zurückgegeben. Die Vektorähnlichkeit ist mit @search.score durch eine Formel verknüpft.

Name	Typ	Beschreibung
searchScore	number	Der @search.score Wert, der aus dem Vektor-Ähnlichkeitsbewertung berechnet wird. Dies ist die Bewertung, die in einer reinen Einzelfeld-Einzelvektorabfrage sichtbar ist.
vectorSimilarity	number	Die Vektor-Ähnlichkeitsbewertung für dieses Dokument. Beachten Sie, dass dies die kanonische Definition der Ähnlichkeitsmetrik ist, nicht die Version des Abstands. Beispiel: Kosinusähnlichkeit anstelle des Kosinusabstands.

TextResult

Die BM25- oder Classic-Bewertung für den Textbereich der Abfrage.

Name	Typ	Beschreibung
searchScore	number	Die BM25- oder Classic-Bewertung für den Textbereich der Abfrage.

VectorFilterMode

Bestimmt, ob Filter vor oder nach der Vektorsuche angewendet werden.

Name	Typ	Beschreibung
postFilter	string	Der Filter wird angewendet, nachdem der Kandidatensatz von Vektorergebnissen zurückgegeben wurde. Je nach Filterauswahl kann dies zu weniger Ergebnissen führen als vom Parameter "k" angefordert.
preFilter	string	Der Filter wird vor der Suchabfrage angewendet.

VectorizableImageBinaryQuery

Die Abfrageparameter, die für die Vektorsuche verwendet werden sollen, wenn eine base64-codierte Binärdatei eines Bilds bereitgestellt wird, das vektorisiert werden muss.

Name	Typ	Beschreibung
base64Image	string	Die base64-codierte Binärdatei eines Bilds, das vektorisiert werden soll, um eine Vektorsuchabfrage auszuführen.
exhaustive	boolean	Wenn wahr, löst eine vollständige k-nächste Nachbarsuche über alle Vektoren innerhalb des Vektorindex aus. Nützlich für Szenarien, in denen genaue Übereinstimmungen kritisch sind, z. B. das Bestimmen von Boden-Wahrheitswerten.
fields	string	Vektorfelder vom Typ Collection(Edm.Single), die in den durchsuchten Vektor einbezogen werden sollen.
filterOverride	string	Der OData-Filterausdruck, der auf diese spezifische Vektorabfrage angewendet werden soll. Wenn kein Filterausdruck auf Vektorebene definiert ist, wird stattdessen der im Filterparameter der obersten Ebene definierte Ausdruck verwendet.
k	integer	Die Anzahl der nächsten Nachbarn, die als Toptreffer zurückgegeben werden sollen.
kind	string: imageBinary	Die Art der ausgeführten Vektorabfrage.
oversampling	number	Übersamplingfaktor. Der Mindestwert ist 1. Er überschreibt den in der Indexdefinition konfigurierten Parameter "defaultOversampling". Sie kann nur festgelegt werden, wenn "rerankWithOriginalVectors" wahr ist. Dieser Parameter ist nur zulässig, wenn eine Komprimierungsmethode für das zugrunde liegende Vektorfeld verwendet wird.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Der Schwellenwert, der für Vektorabfragen verwendet wird. Beachten Sie, dass dies nur festgelegt werden kann, wenn alle "Felder" dieselbe Ähnlichkeitsmetrik verwenden.
weight	number	Relative Gewichtung der Vektorabfrage im Vergleich zu anderen Vektorabfragen und/oder der Textabfrage innerhalb derselben Suchanforderung. Dieser Wert wird verwendet, wenn die Ergebnisse mehrerer Bewertungslisten kombiniert werden, die von den verschiedenen Vektorabfragen und/oder den ergebnissen, die über die Textabfrage abgerufen wurden. Je höher die Gewichtung ist, desto höher sind die Dokumente, die dieser Abfrage entsprechen, in der endgültigen Rangfolge. Der Standardwert ist 1,0 und der Wert muss eine positive Zahl größer als 0 sein.

VectorizableImageUrlQuery

Die Abfrageparameter, die für die Vektorsuche verwendet werden sollen, wenn eine URL, die einen Bildwert darstellt, der vektorisiert werden muss, bereitgestellt wird.

Name	Typ	Beschreibung
exhaustive	boolean	Wenn wahr, löst eine vollständige k-nächste Nachbarsuche über alle Vektoren innerhalb des Vektorindex aus. Nützlich für Szenarien, in denen genaue Übereinstimmungen kritisch sind, z. B. das Bestimmen von Boden-Wahrheitswerten.
fields	string	Vektorfelder vom Typ Collection(Edm.Single), die in den durchsuchten Vektor einbezogen werden sollen.
filterOverride	string	Der OData-Filterausdruck, der auf diese spezifische Vektorabfrage angewendet werden soll. Wenn kein Filterausdruck auf Vektorebene definiert ist, wird stattdessen der im Filterparameter der obersten Ebene definierte Ausdruck verwendet.
k	integer	Die Anzahl der nächsten Nachbarn, die als Toptreffer zurückgegeben werden sollen.
kind	string: imageUrl	Die Art der ausgeführten Vektorabfrage.
oversampling	number	Übersamplingfaktor. Der Mindestwert ist 1. Er überschreibt den in der Indexdefinition konfigurierten Parameter "defaultOversampling". Sie kann nur festgelegt werden, wenn "rerankWithOriginalVectors" wahr ist. Dieser Parameter ist nur zulässig, wenn eine Komprimierungsmethode für das zugrunde liegende Vektorfeld verwendet wird.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Der Schwellenwert, der für Vektorabfragen verwendet wird. Beachten Sie, dass dies nur festgelegt werden kann, wenn alle "Felder" dieselbe Ähnlichkeitsmetrik verwenden.
url	string	Die URL eines Bilds, das vektorisiert werden soll, um eine Vektorsuchabfrage auszuführen.
weight	number	Relative Gewichtung der Vektorabfrage im Vergleich zu anderen Vektorabfragen und/oder der Textabfrage innerhalb derselben Suchanforderung. Dieser Wert wird verwendet, wenn die Ergebnisse mehrerer Bewertungslisten kombiniert werden, die von den verschiedenen Vektorabfragen und/oder den ergebnissen, die über die Textabfrage abgerufen wurden. Je höher die Gewichtung ist, desto höher sind die Dokumente, die dieser Abfrage entsprechen, in der endgültigen Rangfolge. Der Standardwert ist 1,0 und der Wert muss eine positive Zahl größer als 0 sein.

VectorizableTextQuery

Die Abfrageparameter, die für die Vektorsuche verwendet werden sollen, wenn ein Textwert bereitgestellt wird, der vektorisiert werden muss.

Name	Typ	Beschreibung
exhaustive	boolean	Wenn wahr, löst eine vollständige k-nächste Nachbarsuche über alle Vektoren innerhalb des Vektorindex aus. Nützlich für Szenarien, in denen genaue Übereinstimmungen kritisch sind, z. B. das Bestimmen von Boden-Wahrheitswerten.
fields	string	Vektorfelder vom Typ Collection(Edm.Single), die in den durchsuchten Vektor einbezogen werden sollen.
filterOverride	string	Der OData-Filterausdruck, der auf diese spezifische Vektorabfrage angewendet werden soll. Wenn kein Filterausdruck auf Vektorebene definiert ist, wird stattdessen der im Filterparameter der obersten Ebene definierte Ausdruck verwendet.
k	integer	Die Anzahl der nächsten Nachbarn, die als Toptreffer zurückgegeben werden sollen.
kind	string: text	Die Art der ausgeführten Vektorabfrage.
oversampling	number	Übersamplingfaktor. Der Mindestwert ist 1. Er überschreibt den in der Indexdefinition konfigurierten Parameter "defaultOversampling". Sie kann nur festgelegt werden, wenn "rerankWithOriginalVectors" wahr ist. Dieser Parameter ist nur zulässig, wenn eine Komprimierungsmethode für das zugrunde liegende Vektorfeld verwendet wird.
queryRewrites	QueryRewritesType	Kann so konfiguriert werden, dass ein generatives Modell die Abfrage neu schreiben kann, bevor sie an die Vektorisierung gesendet wird.
text	string	Der text, der vektorisiert werden soll, um eine Vektorsuchabfrage auszuführen.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Der Schwellenwert, der für Vektorabfragen verwendet wird. Beachten Sie, dass dies nur festgelegt werden kann, wenn alle "Felder" dieselbe Ähnlichkeitsmetrik verwenden.
weight	number	Relative Gewichtung der Vektorabfrage im Vergleich zu anderen Vektorabfragen und/oder der Textabfrage innerhalb derselben Suchanforderung. Dieser Wert wird verwendet, wenn die Ergebnisse mehrerer Bewertungslisten kombiniert werden, die von den verschiedenen Vektorabfragen und/oder den ergebnissen, die über die Textabfrage abgerufen wurden. Je höher die Gewichtung ist, desto höher sind die Dokumente, die dieser Abfrage entsprechen, in der endgültigen Rangfolge. Der Standardwert ist 1,0 und der Wert muss eine positive Zahl größer als 0 sein.

VectorQueryKind

Die Art der ausgeführten Vektorabfrage.

Name	Typ	Beschreibung
imageBinary	string	Vektorabfrage, bei der eine base64-codierte Binärdatei eines Bilds bereitgestellt wird, das vektorisiert werden muss.
imageUrl	string	Vektorabfrage, bei der eine URL, die einen Bildwert darstellt, der vektorisiert werden muss, bereitgestellt wird.
text	string	Vektorabfrage, bei der ein Textwert bereitgestellt wird, der vektorisiert werden muss.
vector	string	Vektorabfrage, bei der ein unformatierter Vektorwert bereitgestellt wird.

VectorsDebugInfo

Name	Typ	Beschreibung
subscores	QueryResultDocumentSubscores	Die Aufschlüsselung der Teilscores des Dokuments vor der gewählten Ergebnissatz-Fusion/Kombinationsmethode wie RRF.

VectorSimilarityThreshold

Die Ergebnisse der Vektorabfrage werden basierend auf der Vektorgleichheitsmetrik gefiltert. Beachten Sie, dass dies die kanonische Definition der Ähnlichkeitsmetrik ist, nicht die Version des Abstands. Die Schwellenwertrichtung (größer oder kleiner) wird automatisch entsprechend der vom Feld verwendeten Metrik ausgewählt.

Name	Typ	Beschreibung
kind	string: vectorSimilarity	Die Art des Schwellenwerts zum Filtern von Vektorabfragen
value	number	Der Schwellenwert wird basierend auf dem Wert der Ähnlichkeitsmetrik gefiltert. Beachten Sie, dass dies die kanonische Definition der Ähnlichkeitsmetrik ist, nicht die Version des Abstands. Die Schwellenwertrichtung (größer oder kleiner) wird automatisch entsprechend der vom Feld verwendeten Metrik ausgewählt.

VectorThresholdKind

Die Art der ausgeführten Vektorabfrage.

Name	Typ	Beschreibung
searchScore	string	Die Ergebnisse der Vektorabfrage werden basierend auf dem Wert "@search.score" gefiltert. Beachten Sie, dass dies die @search.score, die als Teil der Suchantwort zurückgegeben wird. Die Schwellenwertrichtung wird für höhere @search.scoreausgewählt.
vectorSimilarity	string	Die Ergebnisse der Vektorabfrage werden basierend auf der Vektorgleichheitsmetrik gefiltert. Beachten Sie, dass dies die kanonische Definition der Ähnlichkeitsmetrik ist, nicht die Version des Abstands. Die Schwellenwertrichtung (größer oder kleiner) wird automatisch entsprechend der vom Feld verwendeten Metrik ausgewählt.