Documents - Search Post

Service:
Search Service
Version d'API:
2025-08-01-preview

Recherche de documents dans l’index.

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

Paramètres URI

Nom Dans Obligatoire Type Description
endpoint
 path True

string

URL du point de terminaison du service de recherche.
indexName
 path True

string

Nom de l’index.
api-version
 query True

string

Version de l’API client.

En-tête de la demande

Nom Obligatoire Type Description
x-ms-client-request-id

string (uuid)

ID de suivi envoyé avec la demande pour aider au débogage.
x-ms-query-source-authorization

string

Jeton identifiant l’utilisateur pour lequel la requête est exécutée. Ce jeton est utilisé pour appliquer des restrictions de sécurité sur les documents.

Corps de la demande

Nom Type Description
answers

QueryAnswerType

Valeur qui spécifie si les réponses doivent être renvoyées dans le cadre de la réponse de recherche.
captions

QueryCaptionType

Valeur qui spécifie si les sous-titres doivent être renvoyés dans le cadre de la réponse de recherche.
count

boolean

Valeur qui spécifie s’il faut extraire le nombre total de résultats. La valeur par défaut est false. La définition de cette valeur sur true peut avoir un impact sur les performances. Notez que le décompte renvoyé est une approximation.
debug

QueryDebugMode

Active un outil de débogage qui peut être utilisé pour explorer davantage vos résultats reclassés.
facets

string[]

Liste des expressions de facette à appliquer à la requête de recherche. Chaque expression de facette contient un nom de champ, éventuellement suivi d’une liste de paires nom :valeur séparées par des virgules.
filter

string

Expression $filter OData à appliquer à la requête de recherche.
highlight

string

Liste des noms de champs séparés par des virgules à utiliser pour les surbrillances des accès. Seuls les champs pouvant faire l’objet d’une recherche peuvent être utilisés pour la mise en évidence des occurrences.
highlightPostTag

string

Une balise de chaîne qui est ajoutée aux points forts des hits. Doit être défini avec highlightPreTag. La valeur par défaut est </em>.
highlightPreTag

string

Une balise de chaîne qui est ajoutée pour frapper les points forts. Doit être défini avec highlightPostTag. La valeur par défaut est <em>.
hybridSearch

HybridSearch

Paramètres de requête permettant de configurer les comportements de recherche hybride.
minimumCoverage

number (double)

Nombre compris entre 0 et 100 indiquant le pourcentage de l’index qui doit être couvert par une requête de recherche pour que celle-ci soit signalée comme réussie. Ce paramètre peut être utile pour garantir la disponibilité de la recherche, même pour les services ne comportant qu’un seul réplica. La valeur par défaut est 100.
orderby

string

Liste des expressions OData $orderby séparées par des virgules permettant de trier les résultats. Chaque expression peut être soit un nom de champ, soit un appel aux fonctions geo.distance() ou search.score(). Chaque expression peut être suivie de asc pour indiquer l’ascendant, ou de desc pour indiquer la descendance. La valeur par défaut est l’ordre croissant. Les égalités seront brisées par les scores de match des documents. Si aucun $orderby n’est spécifié, l’ordre de tri par défaut est décroissant en fonction du score de correspondance du document. Il peut y avoir au plus 32 clauses $orderby.
queryLanguage

QueryLanguage

Valeur qui spécifie la langue de la requête de recherche.
queryRewrites

QueryRewritesType

Valeur qui spécifie si des réécritures de requête doivent être générées pour augmenter la requête de recherche.
queryType

QueryType

Valeur qui spécifie la syntaxe de la requête de recherche. La valeur par défaut est 'simple'. Utilisez 'full' si votre requête utilise la syntaxe de requête Lucene.
scoringParameters

string[]

Liste des valeurs de paramètre à utiliser dans les fonctions de scoring (par exemple, referencePointParameter) à l’aide du format name-values. Par exemple, si le profil de scoring définit une fonction avec un paramètre appelé 'mylocation', la chaîne de paramètre sera « mylocation--122.2,44.8 » (sans les guillemets).
scoringProfile

string

Nom d’un profil de notation permettant d’évaluer les scores de correspondance des documents correspondants afin de trier les résultats.
scoringStatistics

ScoringStatistics

Valeur qui spécifie si nous voulons calculer les statistiques de scoring (telles que la fréquence du document) globalement pour un scoring plus cohérent, ou localement, pour une latence plus faible. La valeur par défaut est 'local'. Utilisez « global » pour agréger les statistiques de score globales avant de marquer. L’utilisation de statistiques de score globales peut augmenter la latence des requêtes de recherche.
search

string

Une expression de requête de recherche en texte intégral ; Utilisez « * » ou omettez ce paramètre pour correspondre à tous les documents.
searchFields

string

Liste des noms de champs séparés par des virgules auxquels la recherche en texte intégral doit être portée. Lors de l’utilisation de la recherche par champs (fieldName :searchExpression) dans une requête Lucene complète, les noms de champ de chaque expression de recherche par champ sont prioritaires sur les noms de champ répertoriés dans ce paramètre.
searchMode

SearchMode

Valeur qui spécifie si l’un ou l’ensemble des termes de recherche doivent être mis en correspondance pour que le document soit considéré comme une correspondance.
select

string

Liste des champs à récupérer, séparés par des virgules. S’ils ne sont pas spécifiés, tous les champs marqués comme récupérables dans le schéma sont inclus.
semanticConfiguration

string

Nom d’une configuration sémantique qui sera utilisée lors du traitement des documents pour les requêtes de type sémantique.
semanticErrorHandling

SemanticErrorMode

Permet à l’utilisateur de choisir si un appel sémantique doit échouer complètement (comportement par défaut / actuel) ou renvoyer des résultats partiels.
semanticFields

string

Liste des noms de champs séparés par des virgules utilisée pour le classement sémantique.
semanticMaxWaitInMilliseconds

integer (int32)

minimum: 700

Permet à l’utilisateur de définir une limite supérieure sur le temps nécessaire à l’enrichissement sémantique pour terminer le traitement avant l’échec de la demande.
semanticQuery

string

Permet de définir une requête de recherche distincte qui sera utilisée uniquement pour le reclassement sémantique, les légendes sémantiques et les réponses sémantiques. Est utile pour les scénarios où il est nécessaire d’utiliser des requêtes différentes entre la phase d’extraction de base et de classement, et la phase sémantique L2.
sessionId

string

Valeur à utiliser pour créer une session post-it, ce qui peut aider à obtenir des résultats plus cohérents. Tant que le même sessionId est utilisé, une tentative de ciblage du même jeu de réplicas est effectuée. N’oubliez pas que la réutilisation répétée des mêmes valeurs sessionID peut interférer avec l’équilibrage de charge des demandes entre les réplicas et nuire aux performances du service de recherche. La valeur utilisée comme sessionId ne peut pas commencer par un caractère '_'.
skip

integer (int32)

Le nombre de résultats de recherche à ignorer. Cette valeur ne peut pas être supérieure à 100 000. Si vous devez numériser des documents dans l’ordre, mais que vous ne pouvez pas utiliser skip en raison de cette limitation, envisagez d’utiliser orderby sur une clé totalement ordonnée et filtrez avec une requête de plage à la place.
speller

QuerySpellerType

Valeur spécifiant le type de correcteur orthographique à utiliser pour corriger l’orthographe des termes de requête de recherche individuels.
top

integer (int32)

Le nombre de résultats de recherche à récupérer. Cela peut être utilisé conjointement avec $skip pour implémenter la pagination côté client des résultats de recherche. Si les résultats sont tronqués en raison de la pagination côté serveur, la réponse inclut un jeton de continuation qui peut être utilisé pour émettre une autre demande de recherche pour la page de résultats suivante.
vectorFilterMode

VectorFilterMode

Détermine si des filtres sont appliqués avant ou après l’exécution de la recherche vectorielle. La valeur par défaut est 'preFilter' pour les nouveaux index.
vectorQueries VectorQuery[]:

Paramètres de requête pour les requêtes de recherche vectorielle et hybride.

Réponses

Nom Type Description
200 OK

SearchDocumentsResult

Réponse contenant des documents qui correspondent aux critères de recherche.
Other Status Codes

SearchDocumentsResult

Réponse contenant des documents partiels qui correspondent aux critères de recherche.
Other Status Codes

ErrorResponse

Réponse d’erreur.

Exemples

SearchIndexSearchDocumentsPost
SearchIndexSearchDocumentsSemanticPost

SearchIndexSearchDocumentsPost

Exemple de requête

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

Exemple de réponse

Code d’état:
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"
    }
  ]
}
Code d’état:
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

Exemple de requête

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
}

Exemple de réponse

Code d’état:
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"
}
Code d’état:
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"
}

Définitions

Nom Description
AnswerResult

Une réponse est un passage de texte extrait du contenu des documents les plus pertinents qui correspondaient à la requête. Les réponses sont extraites des premiers résultats de recherche. Les candidats sont notés et les meilleures réponses sont sélectionnées.
CaptionResult

Les légendes sont les passages les plus représentatifs du document par rapport à la requête de recherche. Ils sont souvent utilisés comme résumé de document. Les légendes ne sont renvoyées que pour les requêtes de type semantic.
DebugInfo

Contient des informations de débogage qui peuvent être utilisées pour explorer davantage vos résultats de recherche.
DocumentDebugInfo

Contient des informations de débogage qui peuvent être utilisées pour explorer davantage vos résultats de recherche.
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail

Détail de l’erreur.
ErrorResponse

Réponse d’erreur
HybridCountAndFacetMode

Détermine si le nombre et les facettes doivent inclure tous les documents qui correspondent à la requête de recherche ou uniquement les documents récupérés dans la fenêtre 'maxTextRecallSize'. La valeur par défaut est 'countAllResults'.
HybridSearch

Les paramètres de requête permettant de configurer les comportements de recherche hybride.
QueryAnswerType

Valeur qui spécifie si les réponses doivent être renvoyées dans le cadre de la réponse de recherche.
QueryCaptionType

Valeur qui spécifie si les sous-titres doivent être renvoyés dans le cadre de la réponse de recherche.
QueryDebugMode

Active un outil de débogage qui peut être utilisé pour explorer davantage vos résultats de recherche. Vous pouvez activer plusieurs modes de débogage simultanément en les séparant par un | caractère, par exemple : semantic|queryRewrites.
QueryLanguage

Langue de la requête.
QueryResultDocumentRerankerInput

Les chaînes concaténées brutes qui ont été envoyées au processus d’enrichissement sémantique.
QueryResultDocumentSemanticField

Description des champs qui ont été envoyés au processus d’enrichissement sémantique, ainsi que leur utilisation
QueryResultDocumentSubscores

Répartition des sous-scores entre les composants de requête textuelle et vectorielle de la requête de recherche pour ce document. Chaque requête vectorielle est affichée en tant qu’objet distinct dans le même ordre qu’elle a été reçue.
QueryRewritesDebugInfo

Contient des informations de débogage spécifiques aux réécritures de requêtes.
QueryRewritesType

Valeur qui spécifie si des réécritures de requête doivent être générées pour augmenter la requête de recherche.
QueryRewritesValuesDebugInfo

Contient des informations de débogage spécifiques aux réécritures de requêtes.
QuerySpellerType

Valeur spécifiant le type de correcteur orthographique à utiliser pour corriger l’orthographe des termes de requête de recherche individuels.
QueryType

Spécifie la syntaxe de la requête de recherche. La valeur par défaut est 'simple'. Utilisez 'full' si votre requête utilise la syntaxe de requête Lucene et 'semantic' si la syntaxe de requête n’est pas nécessaire.
RawVectorQuery

Paramètres de requête à utiliser pour la recherche vectorielle lorsqu’une valeur vectorielle brute est fournie.
ScoringStatistics

Valeur qui spécifie si nous voulons calculer les statistiques de scoring (telles que la fréquence du document) globalement pour un scoring plus cohérent, ou localement, pour une latence plus faible. La valeur par défaut est 'local'. Utilisez « global » pour agréger les statistiques de score globales avant de marquer. L’utilisation de statistiques de score globales peut augmenter la latence des requêtes de recherche.
SearchDocumentsResult

Réponse contenant les résultats de recherche d’un index.
SearchMode

Spécifie si l’un ou l’ensemble des termes de recherche doivent être mis en correspondance pour que le document soit considéré comme une correspondance.
SearchRequest

Paramètres de filtrage, de tri, de facettage, de pagination et d’autres comportements de requête de recherche.
SearchResult

Contient un document trouvé par une requête de recherche, ainsi que les métadonnées associées.
SearchScoreThreshold

Les résultats de la requête vectorielle seront filtrés en fonction de la valeur « @search.score ». Notez qu’il s’agit de la @search.score réponse renvoyée dans le cadre de la réponse de recherche. La direction du seuil sera choisie pour le [email protected]
SemanticDebugInfo
SemanticErrorMode

Permet à l’utilisateur de choisir si un appel sémantique doit échouer complètement (comportement par défaut / actuel) ou renvoyer des résultats partiels.
SemanticErrorReason

Raison pour laquelle une réponse partielle a été renvoyée pour une demande de classement sémantique.
SemanticFieldState

La façon dont le champ a été utilisé pour le processus d’enrichissement sémantique (entièrement utilisé, partiellement utilisé ou inutilisé)
SemanticQueryRewritesResultType

Type de réécriture de requête utilisé pour cette demande.
SemanticSearchResultsType

Type de réponse partielle renvoyée pour une demande de classement sémantique.
SingleVectorFieldResult

Un seul résultat de champ vectoriel. Les valeurs @search.score de similarité vectorielle et les valeurs de similarité vectorielle sont renvoyées. La similarité vectorielle est liée à @search.score une équation.
TextResult

Le score BM25 ou Classic pour la partie texte de la requête.
VectorFilterMode

Détermine si des filtres sont appliqués avant ou après l’exécution de la recherche vectorielle.
VectorizableImageBinaryQuery

Paramètres de requête à utiliser pour la recherche vectorielle lorsqu’un binaire encodé en base 64 d’une image qui doit être vectorisée est fourni.
VectorizableImageUrlQuery

Paramètres de requête à utiliser pour la recherche vectorielle lorsqu’une URL représentant une valeur d’image qui doit être vectorisée est fournie.
VectorizableTextQuery

Paramètres de requête à utiliser pour la recherche vectorielle lorsqu’une valeur de texte qui doit être vectorisée est fournie.
VectorQueryKind

Type de requête vectorielle en cours d’exécution.
VectorsDebugInfo
VectorSimilarityThreshold

Les résultats de la requête vectorielle seront filtrés en fonction de la métrique de similarité vectorielle. Notez qu’il s’agit de la définition canonique de la métrique de similarité, et non de la version « distance ». La direction du seuil (plus grande ou plus petite) sera choisie automatiquement en fonction de la métrique utilisée par le champ.
VectorThresholdKind

Type de requête vectorielle en cours d’exécution.

AnswerResult

Objet

Une réponse est un passage de texte extrait du contenu des documents les plus pertinents qui correspondaient à la requête. Les réponses sont extraites des premiers résultats de recherche. Les candidats sont notés et les meilleures réponses sont sélectionnées.

Nom Type Description
highlights

string

Même passage de texte que dans la propriété Text avec les expressions de texte en surbrillance les plus pertinentes pour la requête.
key

string

La clé du document d’où la réponse a été extraite.
score

number (double)

La valeur de score représente la pertinence de la réponse par rapport à la requête par rapport aux autres réponses renvoyées pour la requête.
text

string

Le passage de texte extrait du contenu du document comme réponse.

CaptionResult

Objet

Les légendes sont les passages les plus représentatifs du document par rapport à la requête de recherche. Ils sont souvent utilisés comme résumé de document. Les légendes ne sont renvoyées que pour les requêtes de type semantic.

Nom Type Description
highlights

string

Même passage de texte que dans la propriété Text avec les expressions en surbrillance les plus pertinentes pour la requête.
text

string

Passage de texte représentatif extrait du document le plus pertinent pour la requête de recherche.

DebugInfo

Objet

Contient des informations de débogage qui peuvent être utilisées pour explorer davantage vos résultats de recherche.

Nom Type Description
queryRewrites

QueryRewritesDebugInfo

Contient des informations de débogage spécifiques aux réécritures de requêtes.

DocumentDebugInfo

Objet

Contient des informations de débogage qui peuvent être utilisées pour explorer davantage vos résultats de recherche.

Nom Type Description
innerHits

object

Contient des informations de débogage spécifiques aux vecteurs appariés au sein d’une collection de types complexes.
semantic

SemanticDebugInfo

Contient des informations de débogage spécifiques aux demandes de classement sémantique.
vectors

VectorsDebugInfo

Contient des informations de débogage spécifiques à la recherche vectorielle et hybride.

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.
type

string

Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.
code

string

Code d'erreur.
details

ErrorDetail[]

Détails de l’erreur.
message

string

Message d’erreur.
target

string

Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

HybridCountAndFacetMode

Énumération

Détermine si le nombre et les facettes doivent inclure tous les documents qui correspondent à la requête de recherche ou uniquement les documents récupérés dans la fenêtre 'maxTextRecallSize'. La valeur par défaut est 'countAllResults'.

Valeur Description
countRetrievableResults

N’incluez que les documents qui ont été mis en correspondance dans la fenêtre d’extraction 'maxTextRecallSize' lors du calcul du 'count' et des 'facets'.
countAllResults

Incluez tous les documents qui ont été mis en correspondance par la requête de recherche lors du calcul de « count » et de « facettes », que ces documents se trouvent ou non dans la fenêtre d’extraction « maxTextRecallSize ».

HybridSearch

Objet

Les paramètres de requête permettant de configurer les comportements de recherche hybride.

Nom Type Description
countAndFacetMode

HybridCountAndFacetMode

Détermine si le nombre et les facettes doivent inclure tous les documents qui correspondent à la requête de recherche ou uniquement les documents récupérés dans la fenêtre 'maxTextRecallSize'.
maxTextRecallSize

integer (int32)

Détermine le nombre maximal de documents à extraire par la partie requête textuelle d’une demande de recherche hybride. Ces documents seront combinés avec les documents correspondant aux requêtes vectorielles pour produire une seule liste finale de résultats. Le choix d’une valeur maxTextRecallSize plus élevée permet d’extraire et de parcourir davantage de documents (à l’aide des paramètres top et skip), au prix d’une utilisation plus élevée des ressources et d’une latence plus élevée. La valeur doit être comprise entre 1 et 10 000. La valeur par défaut est 1 000.

QueryAnswerType

Énumération

Valeur qui spécifie si les réponses doivent être renvoyées dans le cadre de la réponse de recherche.

Valeur Description
none

Ne renvoyez pas de réponses à la requête.
extractive

Extraits de réponses des candidats à partir du contenu des documents renvoyés en réponse à une requête exprimée sous forme de question en langage naturel.

QueryCaptionType

Énumération

Valeur qui spécifie si les sous-titres doivent être renvoyés dans le cadre de la réponse de recherche.

Valeur Description
none

Ne renvoyez pas de sous-titres pour la requête.
extractive

Extrait les légendes des documents correspondants qui contiennent des passages pertinents pour la requête de recherche.

QueryDebugMode

Énumération

Active un outil de débogage qui peut être utilisé pour explorer davantage vos résultats de recherche. Vous pouvez activer plusieurs modes de débogage simultanément en les séparant par un | caractère, par exemple : semantic|queryRewrites.

Valeur Description
disabled

Aucune information de débogage de requête n’est renvoyée.
semantic

Permet à l’utilisateur d’explorer davantage ses résultats reclassés.
vector

Permet à l’utilisateur d’explorer davantage les résultats de ses requêtes hybrides et vectorielles.
queryRewrites

Permet à l’utilisateur d’explorer la liste des réécritures de requête générées pour sa demande de recherche.
innerHits

Permet à l’utilisateur de récupérer des informations de score concernant des vecteurs appariés au sein d’une collection de types complexes.
all

Activez toutes les options de débogage.

QueryLanguage

Énumération

Langue de la requête.

Valeur Description
none

Langue de requête non spécifiée.
en-us

Valeur de langue de requête pour l’anglais (États-Unis).
en-gb

Valeur de la langue de requête pour l’anglais (Grande-Bretagne).
en-in

Valeur de la langue de requête pour l’anglais (Inde).
en-ca

Valeur de la langue de requête pour l’anglais (Canada).
en-au

Valeur de la langue de requête pour l’anglais (Australie).
fr-fr

Valeur de la langue de requête pour le français (France).
fr-ca

Valeur de la langue de la requête pour le français (Canada).
de-de

Valeur de la langue de requête pour l’allemand (Allemagne).
es-es

Valeur de la langue de requête pour l’espagnol (Espagne).
es-mx

Valeur de la langue de requête pour l’espagnol (Mexique).
zh-cn

Valeur de langue de requête pour le chinois (Chine).
zh-tw

Valeur de la langue de requête pour le chinois (Taïwan).
pt-br

Valeur de la langue de requête pour le portugais (Brésil).
pt-pt

Valeur de la langue de requête pour le portugais (Portugal).
it-it

Valeur de la langue de requête pour l’italien (Italie).
ja-jp

Valeur de la langue de requête pour le japonais (Japon).
ko-kr

Valeur de langue de requête pour le coréen (Corée).
ru-ru

Valeur de la langue de requête pour le russe (Russie).
cs-cz

Valeur de la langue de requête pour le tchèque (République tchèque).
nl-be

Valeur de la langue de requête pour le néerlandais (Belgique).
nl-nl

Valeur de la langue de requête pour le néerlandais (Pays-Bas).
hu-hu

Valeur de la langue de requête pour le hongrois (Hongrie).
pl-pl

Valeur de la langue de requête pour le polonais (Pologne).
sv-se

Valeur de la langue de requête pour le suédois (Suède).
tr-tr

Valeur de la langue de requête pour le turc (Turquie).
hi-in

Valeur de langue de requête pour l’hindi (Inde).
ar-sa

Valeur de la langue de requête pour l’arabe (Arabie saoudite).
ar-eg

Valeur de la langue de requête pour l’arabe (Égypte).
ar-ma

Valeur de la langue de requête pour l’arabe (Maroc).
ar-kw

Valeur de la langue de requête pour l’arabe (Koweït).
ar-jo

Valeur de la langue de requête pour l’arabe (Jordanie).
da-dk

Valeur de la langue de requête pour le danois (Danemark).
no-no

Valeur de la langue de requête pour le norvégien (Norvège).
bg-bg

Valeur de la langue de requête pour le bulgare (Bulgarie).
hr-hr

Valeur de la langue de requête pour le croate (Croatie).
hr-ba

Valeur de la langue de requête pour le croate (Bosnie-Herzégovine).
ms-my

Valeur de langue de requête pour le malais (Malaisie).
ms-bn

Valeur de la langue de requête pour le malais (Brunei Darussalam).
sl-sl

Valeur de la langue de requête pour le slovène (Slovénie).
ta-in

Valeur de la langue de requête pour le tamoul (Inde).
vi-vn

Valeur de la langue de requête pour le vietnamien (Viet Nam).
el-gr

Valeur de langue de requête pour le grec (Grèce).
ro-ro

Valeur de la langue de requête pour le roumain (Roumanie).
is-is

Valeur de la langue de la requête pour l’islandais (Islande).
id-id

Valeur de la langue de requête pour l’indonésien (Indonésie).
th-th

Valeur de langue de requête pour le thaï (Thaïlande).
lt-lt

Valeur de la langue de requête pour le lituanien (Lituanie).
uk-ua

Valeur de la langue de requête pour l’ukrainien (Ukraine).
lv-lv

Valeur de la langue de la requête pour le letton (Lettonie).
et-ee

Valeur de la langue de requête pour l’estonien (Estonie).
ca-es

Requête de la valeur de la langue pour le catalan.
fi-fi

Valeur de la langue de requête pour le finnois (Finlande).
sr-ba

Valeur de la langue de requête pour le serbe (Bosnie-Herzégovine).
sr-me

Valeur de la langue de requête pour le serbe (Monténégro).
sr-rs

Valeur de la langue de requête pour le serbe (Serbie).
sk-sk

Valeur de la langue de requête pour le slovaque (Slovaquie).
nb-no

Valeur de la langue de requête pour le norvégien (Norvège).
hy-am

Requête de la valeur de langue pour l’arménien (Arménie).
bn-in

Valeur de langue de requête pour le bengali (Inde).
eu-es

Valeur de la langue de requête pour le basque.
gl-es

Valeur de la langue de requête pour le galicien.
gu-in

Valeur de la langue de requête pour le gujarati (Inde).
he-il

Interroger la valeur de la langue pour l’hébreu (Israël).
ga-ie

Valeur de langue de requête pour l’irlandais (Irlande).
kn-in

Valeur de langue de requête pour Kannada (Inde).
ml-in

Valeur de langue de requête pour le malayalam (Inde).
mr-in

Valeur de langue de requête pour le marathi (Inde).
fa-ae

Valeur de la langue de requête pour le persan (U.A.E.).
pa-in

Valeur de langue de requête pour le pendjabi (Inde).
te-in

Valeur de langue de requête pour le télougou (Inde).
ur-pk

Valeur de la langue de requête pour l’ourdou (Pakistan).

QueryResultDocumentRerankerInput

Objet

Les chaînes concaténées brutes qui ont été envoyées au processus d’enrichissement sémantique.

Nom Type Description
content

string

Chaînes concaténées brutes pour les champs de contenu utilisés pour l’enrichissement sémantique.
keywords

string

Chaînes concaténées brutes pour les champs de mots-clés utilisés pour l’enrichissement sémantique.
title

string

Chaîne brute du champ de titre utilisée pour l’enrichissement sémantique.

QueryResultDocumentSemanticField

Objet

Description des champs qui ont été envoyés au processus d’enrichissement sémantique, ainsi que leur utilisation

Nom Type Description
name

string

Nom du champ qui a été envoyé au processus d’enrichissement sémantique
state

SemanticFieldState

La façon dont le champ a été utilisé pour le processus d’enrichissement sémantique (entièrement utilisé, partiellement utilisé ou inutilisé)

QueryResultDocumentSubscores

Objet

Répartition des sous-scores entre les composants de requête textuelle et vectorielle de la requête de recherche pour ce document. Chaque requête vectorielle est affichée en tant qu’objet distinct dans le même ordre qu’elle a été reçue.

Nom Type Description
documentBoost

number (double)

Le score BM25 ou Classic pour la partie texte de la requête.
text

TextResult

Le score BM25 ou Classic pour la partie texte de la requête.
vectors

<string,  SingleVectorFieldResult>

La similarité vectorielle et @search.score les valeurs de chaque requête vectorielle.

QueryRewritesDebugInfo

Objet

Contient des informations de débogage spécifiques aux réécritures de requêtes.

Nom Type Description
text

QueryRewritesValuesDebugInfo

Liste des réécritures de requête générées pour la requête textuelle.
vectors

QueryRewritesValuesDebugInfo[]

Liste des réécritures de requêtes générées pour les requêtes de texte vectorisables.

QueryRewritesType

Énumération

Valeur qui spécifie si des réécritures de requête doivent être générées pour augmenter la requête de recherche.

Valeur Description
none

Ne générez pas de réécritures de requête supplémentaires pour cette requête.
generative

Générez d’autres termes de requête pour augmenter la mémorisation d’une demande de recherche.

QueryRewritesValuesDebugInfo

Objet

Contient des informations de débogage spécifiques aux réécritures de requêtes.

Nom Type Description
inputQuery

string

Texte d’entrée du modèle de réécriture de requête générative. Il peut y avoir des cas où la requête de l’utilisateur et l’entrée du modèle génératif ne sont pas identiques.
rewrites

string[]

Liste des réécritures de requêtes.

QuerySpellerType

Énumération

Valeur spécifiant le type de correcteur orthographique à utiliser pour corriger l’orthographe des termes de requête de recherche individuels.

Valeur Description
none

Correcteur orthographique non activé.
lexicon

Le correcteur d’orthographe corrige les termes de requête individuels à l’aide d’un lexique statique pour la langue spécifiée par le paramètre queryLanguage.

QueryType

Énumération

Spécifie la syntaxe de la requête de recherche. La valeur par défaut est 'simple'. Utilisez 'full' si votre requête utilise la syntaxe de requête Lucene et 'semantic' si la syntaxe de requête n’est pas nécessaire.

Valeur Description
simple

Utilise la syntaxe de requête simple pour les recherches. Le texte de recherche est interprété à l’aide d’un langage de requête simple qui autorise l’utilisation de symboles tels que +, * et «  ». Par défaut, les requêtes sont évaluées dans tous les champs pouvant faire l’objet d’une recherche, sauf si le paramètre searchFields est spécifié.
full

Utilise la syntaxe de requête Lucene complète pour les recherches. Le texte de recherche est interprété à l’aide du langage de requête Lucene qui permet des recherches spécifiques aux champs et pondérées, ainsi que d’autres fonctionnalités avancées.
semantic

Idéal pour les requêtes exprimées en langage naturel plutôt que pour les mots-clés. Améliore la précision des résultats de recherche en reclassant les premiers résultats de recherche à l’aide d’un modèle de classement entraîné sur le corpus Web.

RawVectorQuery

Objet

Paramètres de requête à utiliser pour la recherche vectorielle lorsqu’une valeur vectorielle brute est fournie.

Nom Type Description
exhaustive

boolean

Lorsque la valeur est true, déclenche une recherche exhaustive des k plus proches voisins sur tous les vecteurs de l’index vectoriel. Utile pour les scénarios où des correspondances exactes sont essentielles, comme la détermination de valeurs de vérité terrain.
fields

string

Champs vectoriels de type Collection(Edm.Single) à inclure dans le vecteur recherché.
filterOverride

string

Expression de filtre OData à appliquer à cette requête vectorielle spécifique. Si aucune expression de filtre n’est définie au niveau du vecteur, l’expression définie dans le paramètre de filtre de niveau supérieur est utilisée à la place.
k

integer (int32)

Nombre de voisins les plus proches à renvoyer en tant que premiers résultats.
kind string:

vector

Type de requête vectorielle en cours d’exécution.
oversampling

number (double)

Facteur de suréchantillonnage. La valeur minimale est 1. Il remplace le paramètre 'defaultOversampling' configuré dans la définition de l’index. Il ne peut être défini que lorsque 'rerankWithOriginalVectors' est vrai. Ce paramètre n’est autorisé que lorsqu’une méthode de compression est utilisée sur le champ vectoriel sous-jacent.
perDocumentVectorLimit

integer (int32)

Contrôle le nombre de vecteurs pouvant être mis en correspondance à partir de chaque document dans une requête de recherche vectorielle. La définition de 1 garantit qu’au plus un vecteur par document est mis en correspondance, ce qui garantit que les résultats proviennent de documents distincts. La définition de 0 (illimité) permet de faire correspondre plusieurs vecteurs pertinents du même document. La valeur par défaut est 0.
threshold VectorThreshold:

Seuil utilisé pour les requêtes vectorielles. Notez que cela ne peut être défini que si tous les « champs » utilisent la même métrique de similarité.
vector

number[] (float)

Représentation vectorielle d’une requête de recherche.
weight

number (float)

Poids relatif de la requête vectorielle par rapport à d’autres requêtes vectorielles et/ou à la requête textuelle au sein de la même requête de recherche. Cette valeur est utilisée lors de la combinaison des résultats de plusieurs listes de classement produites par les différentes requêtes vectorielles et/ou des résultats récupérés par le biais de la requête textuelle. Plus le poids est élevé, plus les documents qui correspondent à cette requête seront élevés dans le classement final. La valeur par défaut est 1.0 et la valeur doit être un nombre positif supérieur à zéro.

ScoringStatistics

Énumération

Valeur qui spécifie si nous voulons calculer les statistiques de scoring (telles que la fréquence du document) globalement pour un scoring plus cohérent, ou localement, pour une latence plus faible. La valeur par défaut est 'local'. Utilisez « global » pour agréger les statistiques de score globales avant de marquer. L’utilisation de statistiques de score globales peut augmenter la latence des requêtes de recherche.

Valeur Description
local

Les statistiques de score seront calculées localement pour réduire la latence.
global

Les statistiques de pointage seront calculées globalement pour un score plus cohérent.

SearchDocumentsResult

Objet

Réponse contenant les résultats de recherche d’un index.

Nom Type Description
@odata.count

integer (int64)

Nombre total de résultats trouvés par l’opération de recherche, ou null si le nombre n’a pas été demandé. S’il y en a, le nombre peut être supérieur au nombre de résultats dans cette réponse. Cela peut se produire si vous utilisez les paramètres $top ou $skip, ou si la requête ne peut pas renvoyer tous les documents demandés en une seule réponse.
@odata.nextLink

string

URL de continuation renvoyée lorsque la requête ne peut pas retourner tous les résultats demandés dans une seule réponse. Vous pouvez utiliser cette URL pour formuler une autre requête de recherche GET ou POST afin d’obtenir la partie suivante de la réponse de recherche. Assurez-vous d’utiliser le même verbe (GET ou POST) que la requête qui a produit cette réponse.
@search.answers

AnswerResult[]

Les résultats de la requête de réponses pour l’opération de recherche ; null si le paramètre de requête Answers n’a pas été spécifié ou défini sur 'None'.
@search.coverage

number (double)

Valeur indiquant le pourcentage de l’index inclus dans la requête, ou null si minimumCoverage n’a pas été spécifié dans la demande.
@search.debug

DebugInfo

Déboguer les informations qui s’appliquent à l’ensemble des résultats de recherche.
@search.facets

object

Résultats de la recherche à facettes pour l’opération de recherche, organisés sous la forme d’une collection de compartiments pour chaque champ à facettes ; null si la requête n’incluait aucune expression de facette.
@search.nextPageParameters

SearchRequest

Charge utile JSON de continuation renvoyée lorsque la requête ne peut pas retourner tous les résultats demandés dans une seule réponse. Vous pouvez utiliser ce JSON avec @odata.nextLink pour formuler une autre requête de recherche POST afin d’obtenir la partie suivante de la réponse de recherche.
@search.semanticPartialResponseReason

SemanticErrorReason

Raison pour laquelle une réponse partielle a été renvoyée pour une demande de classement sémantique.
@search.semanticPartialResponseType

SemanticSearchResultsType

Type de réponse partielle renvoyée pour une demande de classement sémantique.
@search.semanticQueryRewritesResultType

SemanticQueryRewritesResultType

Type de réécriture de requête utilisé pour récupérer des documents.
value

SearchResult[]

Séquence des résultats renvoyés par la requête.

SearchMode

Énumération

Spécifie si l’un ou l’ensemble des termes de recherche doivent être mis en correspondance pour que le document soit considéré comme une correspondance.

Valeur Description
any

Tous les termes de recherche doivent correspondre pour que le document soit considéré comme une correspondance.
all

Tous les termes de recherche doivent correspondre pour que le document soit considéré comme une correspondance.

SearchRequest

Objet

Paramètres de filtrage, de tri, de facettage, de pagination et d’autres comportements de requête de recherche.

Nom Type Description
answers

QueryAnswerType

Valeur qui spécifie si les réponses doivent être renvoyées dans le cadre de la réponse de recherche.
captions

QueryCaptionType

Valeur qui spécifie si les sous-titres doivent être renvoyés dans le cadre de la réponse de recherche.
count

boolean

Valeur qui spécifie s’il faut extraire le nombre total de résultats. La valeur par défaut est false. La définition de cette valeur sur true peut avoir un impact sur les performances. Notez que le décompte renvoyé est une approximation.
debug

QueryDebugMode

Active un outil de débogage qui peut être utilisé pour explorer davantage vos résultats reclassés.
facets

string[]

Liste des expressions de facette à appliquer à la requête de recherche. Chaque expression de facette contient un nom de champ, éventuellement suivi d’une liste de paires nom :valeur séparées par des virgules.
filter

string

Expression $filter OData à appliquer à la requête de recherche.
highlight

string

Liste des noms de champs séparés par des virgules à utiliser pour les surbrillances des accès. Seuls les champs pouvant faire l’objet d’une recherche peuvent être utilisés pour la mise en évidence des occurrences.
highlightPostTag

string

Une balise de chaîne qui est ajoutée aux points forts des hits. Doit être défini avec highlightPreTag. La valeur par défaut est </em>.
highlightPreTag

string

Une balise de chaîne qui est ajoutée pour frapper les points forts. Doit être défini avec highlightPostTag. La valeur par défaut est <em>.
hybridSearch

HybridSearch

Paramètres de requête permettant de configurer les comportements de recherche hybride.
minimumCoverage

number (double)

Nombre compris entre 0 et 100 indiquant le pourcentage de l’index qui doit être couvert par une requête de recherche pour que celle-ci soit signalée comme réussie. Ce paramètre peut être utile pour garantir la disponibilité de la recherche, même pour les services ne comportant qu’un seul réplica. La valeur par défaut est 100.
orderby

string

Liste des expressions OData $orderby séparées par des virgules permettant de trier les résultats. Chaque expression peut être soit un nom de champ, soit un appel aux fonctions geo.distance() ou search.score(). Chaque expression peut être suivie de asc pour indiquer l’ascendant, ou de desc pour indiquer la descendance. La valeur par défaut est l’ordre croissant. Les égalités seront brisées par les scores de match des documents. Si aucun $orderby n’est spécifié, l’ordre de tri par défaut est décroissant en fonction du score de correspondance du document. Il peut y avoir au plus 32 clauses $orderby.
queryLanguage

QueryLanguage

Valeur qui spécifie la langue de la requête de recherche.
queryRewrites

QueryRewritesType

Valeur qui spécifie si des réécritures de requête doivent être générées pour augmenter la requête de recherche.
queryType

QueryType

Valeur qui spécifie la syntaxe de la requête de recherche. La valeur par défaut est 'simple'. Utilisez 'full' si votre requête utilise la syntaxe de requête Lucene.
scoringParameters

string[]

Liste des valeurs de paramètre à utiliser dans les fonctions de scoring (par exemple, referencePointParameter) à l’aide du format name-values. Par exemple, si le profil de scoring définit une fonction avec un paramètre appelé 'mylocation', la chaîne de paramètre sera « mylocation--122.2,44.8 » (sans les guillemets).
scoringProfile

string

Nom d’un profil de notation permettant d’évaluer les scores de correspondance des documents correspondants afin de trier les résultats.
scoringStatistics

ScoringStatistics

Valeur qui spécifie si nous voulons calculer les statistiques de scoring (telles que la fréquence du document) globalement pour un scoring plus cohérent, ou localement, pour une latence plus faible. La valeur par défaut est 'local'. Utilisez « global » pour agréger les statistiques de score globales avant de marquer. L’utilisation de statistiques de score globales peut augmenter la latence des requêtes de recherche.
search

string

Une expression de requête de recherche en texte intégral ; Utilisez « * » ou omettez ce paramètre pour correspondre à tous les documents.
searchFields

string

Liste des noms de champs séparés par des virgules auxquels la recherche en texte intégral doit être portée. Lors de l’utilisation de la recherche par champs (fieldName :searchExpression) dans une requête Lucene complète, les noms de champ de chaque expression de recherche par champ sont prioritaires sur les noms de champ répertoriés dans ce paramètre.
searchMode

SearchMode

Valeur qui spécifie si l’un ou l’ensemble des termes de recherche doivent être mis en correspondance pour que le document soit considéré comme une correspondance.
select

string

Liste des champs à récupérer, séparés par des virgules. S’ils ne sont pas spécifiés, tous les champs marqués comme récupérables dans le schéma sont inclus.
semanticConfiguration

string

Nom d’une configuration sémantique qui sera utilisée lors du traitement des documents pour les requêtes de type sémantique.
semanticErrorHandling

SemanticErrorMode

Permet à l’utilisateur de choisir si un appel sémantique doit échouer complètement (comportement par défaut / actuel) ou renvoyer des résultats partiels.
semanticFields

string

Liste des noms de champs séparés par des virgules utilisée pour le classement sémantique.
semanticMaxWaitInMilliseconds

integer (int32)

minimum: 700

Permet à l’utilisateur de définir une limite supérieure sur le temps nécessaire à l’enrichissement sémantique pour terminer le traitement avant l’échec de la demande.
semanticQuery

string

Permet de définir une requête de recherche distincte qui sera utilisée uniquement pour le reclassement sémantique, les légendes sémantiques et les réponses sémantiques. Est utile pour les scénarios où il est nécessaire d’utiliser des requêtes différentes entre la phase d’extraction de base et de classement, et la phase sémantique L2.
sessionId

string

Valeur à utiliser pour créer une session post-it, ce qui peut aider à obtenir des résultats plus cohérents. Tant que le même sessionId est utilisé, une tentative de ciblage du même jeu de réplicas est effectuée. N’oubliez pas que la réutilisation répétée des mêmes valeurs sessionID peut interférer avec l’équilibrage de charge des demandes entre les réplicas et nuire aux performances du service de recherche. La valeur utilisée comme sessionId ne peut pas commencer par un caractère '_'.
skip

integer (int32)

Le nombre de résultats de recherche à ignorer. Cette valeur ne peut pas être supérieure à 100 000. Si vous devez numériser des documents dans l’ordre, mais que vous ne pouvez pas utiliser skip en raison de cette limitation, envisagez d’utiliser orderby sur une clé totalement ordonnée et filtrez avec une requête de plage à la place.
speller

QuerySpellerType

Valeur spécifiant le type de correcteur orthographique à utiliser pour corriger l’orthographe des termes de requête de recherche individuels.
top

integer (int32)

Le nombre de résultats de recherche à récupérer. Cela peut être utilisé conjointement avec $skip pour implémenter la pagination côté client des résultats de recherche. Si les résultats sont tronqués en raison de la pagination côté serveur, la réponse inclut un jeton de continuation qui peut être utilisé pour émettre une autre demande de recherche pour la page de résultats suivante.
vectorFilterMode

VectorFilterMode

Détermine si des filtres sont appliqués avant ou après l’exécution de la recherche vectorielle. La valeur par défaut est 'preFilter' pour les nouveaux index.
vectorQueries VectorQuery[]:

Paramètres de requête pour les requêtes de recherche vectorielle et hybride.

SearchResult

Objet

Contient un document trouvé par une requête de recherche, ainsi que les métadonnées associées.

Nom Type Description
@search.captions

CaptionResult[]

Les légendes sont les passages les plus représentatifs du document par rapport à la requête de recherche. Ils sont souvent utilisés comme résumé de document. Les légendes ne sont renvoyées que pour les requêtes de type 'semantic'.
@search.documentDebugInfo

DocumentDebugInfo

Contient des informations de débogage qui peuvent être utilisées pour explorer davantage vos résultats de recherche.
@search.highlights

object

Fragments de texte du document indiquant les termes de recherche correspondants, organisés par chaque champ applicable ; null si la mise en surbrillance de l’accès n’a pas été activée pour la requête.
@search.rerankerBoostedScore

number (double)

Le score de pertinence calculé en augmentant le score Reranker. Les résultats de recherche sont triés en fonction de RerankerScore/RerankerBoostedScore en fonction de useScoringProfileBoostedRanking dans la configuration sémantique. RerankerBoostedScore n’est renvoyé que pour les requêtes de type 'semantic'
@search.rerankerScore

number (double)

Le score de pertinence calculé par le classeur sémantique pour les premiers résultats de recherche. Les résultats de recherche sont triés en fonction du RerankerScore d’abord, puis du Score. RerankerScore n’est renvoyé que pour les requêtes de type 'semantic'.
@search.score

number (double)

Le score de pertinence du document par rapport aux autres documents renvoyés par la requête.

SearchScoreThreshold

Objet

Les résultats de la requête vectorielle seront filtrés en fonction de la valeur « @search.score ». Notez qu’il s’agit de la @search.score réponse renvoyée dans le cadre de la réponse de recherche. La direction du seuil sera choisie pour le [email protected]

Nom Type Description
kind string:

searchScore

Type de seuil utilisé pour filtrer les requêtes vectorielles
value

number (double)

Le seuil sera filtré en fonction de la valeur « @search.score ». Notez qu’il s’agit de la @search.score réponse renvoyée dans le cadre de la réponse de recherche. La direction du seuil sera choisie pour le [email protected]

SemanticDebugInfo

Objet
Nom Type Description
contentFields

QueryResultDocumentSemanticField[]

Les champs de contenu qui ont été envoyés au processus d’enrichissement sémantique, ainsi que leur utilisation
keywordFields

QueryResultDocumentSemanticField[]

Les champs de mots-clés qui ont été envoyés au processus d’enrichissement sémantique, ainsi que leur utilisation
rerankerInput

QueryResultDocumentRerankerInput

Les chaînes concaténées brutes qui ont été envoyées au processus d’enrichissement sémantique.
titleField

QueryResultDocumentSemanticField

Le champ de titre qui a été envoyé au processus d’enrichissement sémantique, ainsi que son utilisation

SemanticErrorMode

Énumération

Permet à l’utilisateur de choisir si un appel sémantique doit échouer complètement (comportement par défaut / actuel) ou renvoyer des résultats partiels.

Valeur Description
partial

Si le traitement sémantique échoue, des résultats partiels sont toujours renvoyés. La définition des résultats partiels dépend de l’étape sémantique qui a échoué et de la raison de l’échec.
fail

S’il y a une exception lors de l’étape de traitement sémantique, la requête échoue et renvoie le code HTTP approprié en fonction de l’erreur.

SemanticErrorReason

Énumération

Raison pour laquelle une réponse partielle a été renvoyée pour une demande de classement sémantique.

Valeur Description
maxWaitExceeded

If semanticMaxWaitInMilliseconds était défini et que la durée du traitement sémantique dépassait cette valeur. Seuls les résultats de base ont été renvoyés.
capacityOverloaded

La demande a été étouffée. Seuls les résultats de base ont été renvoyés.
transient

Au moins une étape du processus sémantique a échoué.

SemanticFieldState

Énumération

La façon dont le champ a été utilisé pour le processus d’enrichissement sémantique (entièrement utilisé, partiellement utilisé ou inutilisé)

Valeur Description
used

Le champ a été entièrement utilisé pour l’enrichissement sémantique.
unused

Le champ n’a pas été utilisé pour l’enrichissement sémantique.
partial

Le champ a été partiellement utilisé pour l’enrichissement sémantique.

SemanticQueryRewritesResultType

Énumération

Type de réécriture de requête utilisé pour cette demande.

Valeur Description
originalQueryOnly

Les réécritures de requête n’ont pas été générées pour cette demande. Seule la requête d’origine a été utilisée pour récupérer les résultats.

SemanticSearchResultsType

Énumération

Type de réponse partielle renvoyée pour une demande de classement sémantique.

Valeur Description
baseResults

Résultats sans aucun enrichissement sémantique ni reclassement.
rerankedResults

Les résultats ont été reclassés avec le modèle de reclassement et incluront des légendes sémantiques. Ils n’incluront pas de réponses, de points forts de réponses ou de légendes.

SingleVectorFieldResult

Objet

Un seul résultat de champ vectoriel. Les valeurs @search.score de similarité vectorielle et les valeurs de similarité vectorielle sont renvoyées. La similarité vectorielle est liée à @search.score une équation.

Nom Type Description
searchScore

number (double)

Valeur @search.score calculée à partir du score de similarité vectorielle. Il s’agit du score visible dans une requête à vecteur unique à champ unique.
vectorSimilarity

number (double)

Le score de similarité vectorielle pour ce document. Notez qu’il s’agit de la définition canonique de la métrique de similarité, et non de la version « distance ». Par exemple, similarité cosinusoïdale au lieu de distance cosinus.

TextResult

Objet

Le score BM25 ou Classic pour la partie texte de la requête.

Nom Type Description
searchScore

number (double)

Le score BM25 ou Classic pour la partie texte de la requête.

VectorFilterMode

Énumération

Détermine si des filtres sont appliqués avant ou après l’exécution de la recherche vectorielle.

Valeur Description
postFilter

Le filtre sera appliqué une fois que l’ensemble candidat de résultats vectoriels sera renvoyé. En fonction de la sélectivité du filtre, cela peut donner moins de résultats que ce qui est demandé par le paramètre 'k'.
preFilter

Le filtre sera appliqué avant la requête de recherche.
strictPostFilter

Le filtre sera appliqué après le retour de l’ensemble global des k premiers résultats vectoriels. Cela se traduira par moins de résultats que ce qui est demandé par le paramètre 'k'.

VectorizableImageBinaryQuery

Objet

Paramètres de requête à utiliser pour la recherche vectorielle lorsqu’un binaire encodé en base 64 d’une image qui doit être vectorisée est fourni.

Nom Type Description
base64Image

string

Le binaire encodé en base 64 d’une image à vectoriser pour effectuer une requête de recherche vectorielle.
exhaustive

boolean

Lorsque la valeur est true, déclenche une recherche exhaustive des k plus proches voisins sur tous les vecteurs de l’index vectoriel. Utile pour les scénarios où des correspondances exactes sont essentielles, comme la détermination de valeurs de vérité terrain.
fields

string

Champs vectoriels de type Collection(Edm.Single) à inclure dans le vecteur recherché.
filterOverride

string

Expression de filtre OData à appliquer à cette requête vectorielle spécifique. Si aucune expression de filtre n’est définie au niveau du vecteur, l’expression définie dans le paramètre de filtre de niveau supérieur est utilisée à la place.
k

integer (int32)

Nombre de voisins les plus proches à renvoyer en tant que premiers résultats.
kind string:

imageBinary

Type de requête vectorielle en cours d’exécution.
oversampling

number (double)

Facteur de suréchantillonnage. La valeur minimale est 1. Il remplace le paramètre 'defaultOversampling' configuré dans la définition de l’index. Il ne peut être défini que lorsque 'rerankWithOriginalVectors' est vrai. Ce paramètre n’est autorisé que lorsqu’une méthode de compression est utilisée sur le champ vectoriel sous-jacent.
perDocumentVectorLimit

integer (int32)

Contrôle le nombre de vecteurs pouvant être mis en correspondance à partir de chaque document dans une requête de recherche vectorielle. La définition de 1 garantit qu’au plus un vecteur par document est mis en correspondance, ce qui garantit que les résultats proviennent de documents distincts. La définition de 0 (illimité) permet de faire correspondre plusieurs vecteurs pertinents du même document. La valeur par défaut est 0.
threshold VectorThreshold:

Seuil utilisé pour les requêtes vectorielles. Notez que cela ne peut être défini que si tous les « champs » utilisent la même métrique de similarité.
weight

number (float)

Poids relatif de la requête vectorielle par rapport à d’autres requêtes vectorielles et/ou à la requête textuelle au sein de la même requête de recherche. Cette valeur est utilisée lors de la combinaison des résultats de plusieurs listes de classement produites par les différentes requêtes vectorielles et/ou des résultats récupérés par le biais de la requête textuelle. Plus le poids est élevé, plus les documents qui correspondent à cette requête seront élevés dans le classement final. La valeur par défaut est 1.0 et la valeur doit être un nombre positif supérieur à zéro.

VectorizableImageUrlQuery

Objet

Paramètres de requête à utiliser pour la recherche vectorielle lorsqu’une URL représentant une valeur d’image qui doit être vectorisée est fournie.

Nom Type Description
exhaustive

boolean

Lorsque la valeur est true, déclenche une recherche exhaustive des k plus proches voisins sur tous les vecteurs de l’index vectoriel. Utile pour les scénarios où des correspondances exactes sont essentielles, comme la détermination de valeurs de vérité terrain.
fields

string

Champs vectoriels de type Collection(Edm.Single) à inclure dans le vecteur recherché.
filterOverride

string

Expression de filtre OData à appliquer à cette requête vectorielle spécifique. Si aucune expression de filtre n’est définie au niveau du vecteur, l’expression définie dans le paramètre de filtre de niveau supérieur est utilisée à la place.
k

integer (int32)

Nombre de voisins les plus proches à renvoyer en tant que premiers résultats.
kind string:

imageUrl

Type de requête vectorielle en cours d’exécution.
oversampling

number (double)

Facteur de suréchantillonnage. La valeur minimale est 1. Il remplace le paramètre 'defaultOversampling' configuré dans la définition de l’index. Il ne peut être défini que lorsque 'rerankWithOriginalVectors' est vrai. Ce paramètre n’est autorisé que lorsqu’une méthode de compression est utilisée sur le champ vectoriel sous-jacent.
perDocumentVectorLimit

integer (int32)

Contrôle le nombre de vecteurs pouvant être mis en correspondance à partir de chaque document dans une requête de recherche vectorielle. La définition de 1 garantit qu’au plus un vecteur par document est mis en correspondance, ce qui garantit que les résultats proviennent de documents distincts. La définition de 0 (illimité) permet de faire correspondre plusieurs vecteurs pertinents du même document. La valeur par défaut est 0.
threshold VectorThreshold:

Seuil utilisé pour les requêtes vectorielles. Notez que cela ne peut être défini que si tous les « champs » utilisent la même métrique de similarité.
url

string

L’URL d’une image à vectoriser pour effectuer une requête de recherche vectorielle.
weight

number (float)

Poids relatif de la requête vectorielle par rapport à d’autres requêtes vectorielles et/ou à la requête textuelle au sein de la même requête de recherche. Cette valeur est utilisée lors de la combinaison des résultats de plusieurs listes de classement produites par les différentes requêtes vectorielles et/ou des résultats récupérés par le biais de la requête textuelle. Plus le poids est élevé, plus les documents qui correspondent à cette requête seront élevés dans le classement final. La valeur par défaut est 1.0 et la valeur doit être un nombre positif supérieur à zéro.

VectorizableTextQuery

Objet

Paramètres de requête à utiliser pour la recherche vectorielle lorsqu’une valeur de texte qui doit être vectorisée est fournie.

Nom Type Description
exhaustive

boolean

Lorsque la valeur est true, déclenche une recherche exhaustive des k plus proches voisins sur tous les vecteurs de l’index vectoriel. Utile pour les scénarios où des correspondances exactes sont essentielles, comme la détermination de valeurs de vérité terrain.
fields

string

Champs vectoriels de type Collection(Edm.Single) à inclure dans le vecteur recherché.
filterOverride

string

Expression de filtre OData à appliquer à cette requête vectorielle spécifique. Si aucune expression de filtre n’est définie au niveau du vecteur, l’expression définie dans le paramètre de filtre de niveau supérieur est utilisée à la place.
k

integer (int32)

Nombre de voisins les plus proches à renvoyer en tant que premiers résultats.
kind string:

text

Type de requête vectorielle en cours d’exécution.
oversampling

number (double)

Facteur de suréchantillonnage. La valeur minimale est 1. Il remplace le paramètre 'defaultOversampling' configuré dans la définition de l’index. Il ne peut être défini que lorsque 'rerankWithOriginalVectors' est vrai. Ce paramètre n’est autorisé que lorsqu’une méthode de compression est utilisée sur le champ vectoriel sous-jacent.
perDocumentVectorLimit

integer (int32)

Contrôle le nombre de vecteurs pouvant être mis en correspondance à partir de chaque document dans une requête de recherche vectorielle. La définition de 1 garantit qu’au plus un vecteur par document est mis en correspondance, ce qui garantit que les résultats proviennent de documents distincts. La définition de 0 (illimité) permet de faire correspondre plusieurs vecteurs pertinents du même document. La valeur par défaut est 0.
queryRewrites

QueryRewritesType

Peut être configuré pour laisser un modèle génératif réécrire la requête avant de l’envoyer à vectoriser.
text

string

Texte à vectoriser pour effectuer une requête de recherche vectorielle.
threshold VectorThreshold:

Seuil utilisé pour les requêtes vectorielles. Notez que cela ne peut être défini que si tous les « champs » utilisent la même métrique de similarité.
weight

number (float)

Poids relatif de la requête vectorielle par rapport à d’autres requêtes vectorielles et/ou à la requête textuelle au sein de la même requête de recherche. Cette valeur est utilisée lors de la combinaison des résultats de plusieurs listes de classement produites par les différentes requêtes vectorielles et/ou des résultats récupérés par le biais de la requête textuelle. Plus le poids est élevé, plus les documents qui correspondent à cette requête seront élevés dans le classement final. La valeur par défaut est 1.0 et la valeur doit être un nombre positif supérieur à zéro.

VectorQueryKind

Énumération

Type de requête vectorielle en cours d’exécution.

Valeur Description
vector

Requête vectorielle dans laquelle une valeur vectorielle brute est fournie.
text

Requête vectorielle dans laquelle une valeur de texte qui doit être vectorisée est fournie.
imageUrl

Requête vectorielle dans laquelle une URL représentant une valeur d’image qui doit être vectorisée est fournie.
imageBinary

Requête vectorielle dans laquelle un binaire encodé en base 64 d’une image qui doit être vectorisée est fourni.

VectorsDebugInfo

Objet
Nom Type Description
subscores

QueryResultDocumentSubscores

La répartition des sous-scores du document avant la méthode de fusion/combinaison d’ensemble de résultats choisie, telle que RRF.

VectorSimilarityThreshold

Objet

Les résultats de la requête vectorielle seront filtrés en fonction de la métrique de similarité vectorielle. Notez qu’il s’agit de la définition canonique de la métrique de similarité, et non de la version « distance ». La direction du seuil (plus grande ou plus petite) sera choisie automatiquement en fonction de la métrique utilisée par le champ.

Nom Type Description
kind string:

vectorSimilarity

Type de seuil utilisé pour filtrer les requêtes vectorielles
value

number (double)

Le seuil sera filtré en fonction de la valeur de la métrique de similarité. Notez qu’il s’agit de la définition canonique de la métrique de similarité, et non de la version « distance ». La direction du seuil (plus grande ou plus petite) sera choisie automatiquement en fonction de la métrique utilisée par le champ.

VectorThresholdKind

Énumération

Type de requête vectorielle en cours d’exécution.

Valeur Description
vectorSimilarity

Les résultats de la requête vectorielle seront filtrés en fonction de la métrique de similarité vectorielle. Notez qu’il s’agit de la définition canonique de la métrique de similarité, et non de la version « distance ». La direction du seuil (plus grande ou plus petite) sera choisie automatiquement en fonction de la métrique utilisée par le champ.
searchScore

Les résultats de la requête vectorielle seront filtrés en fonction de la valeur « @search.score ». Notez qu’il s’agit de la @search.score réponse renvoyée dans le cadre de la réponse de recherche. La direction du seuil sera choisie pour le [email protected]