Rechercher des documents (API REST en préversion)

s’applique à: 2023-07-01-Preview. Cette version n’est plus prise en charge. mettre à niveau immédiatement vers une version plus récente.

Une requête cible la collection de documents d’un index unique sur un service de recherche. Il inclut des paramètres qui définissent les critères de correspondance et les paramètres qui forment la réponse. Vous pouvez également utiliser un alias d’index pour cibler un index particulier au lieu d’utiliser le nom d’index lui-même.

Vous pouvez utiliser GET ou POST pour la plupart des requêtes, mais vous devez utiliser POST pour la recherche vectorielle, car les paramètres de requête vectorielle ne correspondent pas à un URI. paramètres de requête sont spécifiés sur la chaîne de requête pour les requêtes GET et dans le corps de la requête pour les requêtes POST.

GET https://[service name].search.windows.net/indexes/[index name]/docs?[query parameters] 
  Content-Type: application/json   
  api-key: [admin or query key]  

Si vous utilisez POST, ajoutez l’action « search » en tant que paramètre d’URI.

POST https://[service name].search.windows.net/indexes/[index name]/docs/search?api-version=[api-version]  
  Content-Type: application/json  
  api-key: [admin or query key]  

Lorsqu’elle est appelée avec GET, la longueur de l’URL de la requête ne peut pas dépasser 8 Ko. Cette longueur est suffisante pour la plupart des applications. Toutefois, certaines applications produisent des requêtes volumineuses, en particulier lorsque des expressions de filtre OData sont utilisées. Pour ces applications, HTTP POST est un meilleur choix, car il autorise des filtres plus volumineux que GET.

Avec POST, le nombre de clauses d’un filtre est le facteur de limitation, et non la taille de la chaîne de filtre brute, car la limite de taille de requête pour POST est d’environ 16 Mo. Même si la limite de taille de requête POST est importante, les expressions de filtre ne peuvent pas être arbitrairement complexes. Pour plus d’informations sur les limitations de complexité des filtres, consultez syntaxe d’expression OData pour azure AI Search.

Paramètres d’URI

Recommandations d’encodage d’URL

N’oubliez pas de encodez l’URL paramètres de requête spécifiques lors de l’appel direct de l’API REST GET. Pour une opération Rechercher des documents, l’encodage d’URL peut être nécessaire pour les paramètres de requête suivants :

• rechercher
• $filter
• facette
• highlightPreTag
• highlightPostTag

L’encodage d’URL est recommandé uniquement pour les paramètres individuels. Si vous encodez par inadvertance url la chaîne de requête entière (tout après le ?), les requêtes s’interrompent.

En outre, l’encodage d’URL est nécessaire uniquement lors de l’appel de l’API REST directement à l’aide de GET. Aucun encodage d’URL n’est nécessaire lors de l’utilisation de POST, ou lors de l’utilisation de la bibliothèque cliente .NET recherche Azure AI Search, qui gère l’encodage pour vous.

En-têtes de requête

Le tableau suivant décrit les en-têtes de requête obligatoires et facultatifs.

Corps de la demande

Pour GET : Aucun.

Pour POST :

{  
     "answers": "none" (default) | "extractive", 
     "count": true | false (default),
     "captions": "none" (default) | "extractive",
     "facets": [ "facet_expression_1", "facet_expression_2", ... ],  
     "featuresMode" : "disabled" (default) | "enabled",
     "filter": "odata_filter_expression",  
     "highlight": "highlight_field_1, highlight_field_2, ...",  
     "highlightPreTag": "pre_tag",  
     "highlightPostTag": "post_tag",  
     "minimumCoverage": # (% of index that must be covered to declare query successful; default 100),  
     "orderby": "orderby_expression",
     "queryLanguage": "en-us" (default) | (a supported language code), 
     "queryType": "simple" (default) | "full" | "semantic",
     "scoringParameters": [ "scoring_parameter_1", "scoring_parameter_2", ... ],  
     "scoringProfile": "scoring_profile_name",  
     "scoringStatistics" : "local" (default) | "global",
     "search": "simple_query_expression",  
     "searchFields": "field_name_1, field_name_2, ...",  
     "searchMode": "any" (default) | "all",  
     "select": "field_name_1, field_name_2, ...",  
     "semanticConfiguration": "semantic_configuration_name",
     "sessionId" : "session_id",
     "skip": # (default 0), 
     "speller": "none" (default) | "lexicon",  
     "top": #,
     "vectors": [
      {
        "value": "a vector representation of the query",
        "k": an integer (number of nearest neighbors to return as top results),
        "fields": "a comma-delimited list of vector fields to use in the query"
      }
     ]
   }  

continuation des réponses de recherche partielles

Parfois, Azure AI Search ne peut pas retourner tous les résultats demandés dans une seule réponse de recherche. Une réponse partielle peut se produire pour différentes raisons, par exemple lorsque la requête retourne trop de documents en ne spécifiant pas $top, ou en spécifiant une valeur pour $ top trop volumineuse. Dans ce cas, Azure AI Search inclut l’annotation @odata.nextLink dans le corps de la réponse, et également @search.nextPageParameters s’il s’agissait d’une requête POST. Vous pouvez utiliser les valeurs de ces annotations pour formuler une autre requête de recherche pour obtenir la partie suivante de la réponse de recherche. Ce comportement est appelé de continuation de la requête de recherche d’origine, et les annotations sont appelées jetons de continuation. Consultez l’exemple de la section Réponse pour plus d’informations sur la syntaxe de ces annotations et leur emplacement dans le corps de la réponse.

Les raisons pour lesquelles Azure AI Search peut retourner des jetons de continuation sont spécifiques à l’implémentation et susceptibles de changer. Les clients robustes doivent toujours être prêts à gérer les cas où moins de documents que prévu sont retournés et un jeton de continuation est inclus pour continuer à récupérer des documents. Notez également que vous devez utiliser la même méthode HTTP que la requête d’origine pour continuer. Par exemple, si vous avez envoyé une requête GET, toutes les demandes de continuation que vous envoyez doivent également utiliser GET (et de même pour POST).

Paramètres de requête

Une requête accepte plusieurs paramètres sur l’URL lorsqu’elle est appelée avec GET et en tant que propriétés JSON dans le corps de la requête lorsqu’elle est appelée avec POST. La syntaxe de certains paramètres est légèrement différente entre GET et POST. Ces différences sont notées dans le tableau suivant.

Réponse

Code d’état : 200 OK est retourné pour une réponse réussie. Il existe deux exemples de réponses dans cet article, une pour la recherche sémantique et featuresMode.

Exemple de réponse pour la requête sémantique

Le premier exemple montre la réponse complète pour le résultat le plus élevé de la requête sémantique « how do clouds form ».

• « @search.answers » s’affiche lorsque vous spécifiez le paramètre réponses, et lorsque la requête et les champs ciblés de l’index contiennent du contenu qui peut être reconnu comme une réponse. Tableau @search.answers qui a une clé, du texte et des surbrillances. Le score est un indicateur de la force de la réponse.

• « value » est le corps de la réponse. Le @search.rerankerScore est attribué par l’algorithme de classement sémantique et est utilisé pour classer les résultats (@search.score provient de l’algorithme de similarité BM25, utilisé lors du scoring des résultats initiaux). Les légendes incluent du texte brut et des versions mises en surbrillance. Cet exemple a été créé à l’aide des compétences ocr et de reconnaissance d’entité. Les champs du contenu extrait et fusionné sont inclus dans la réponse.

{
    "@search.answers": [
        {
            "key": "aHR0cHM6Ly9oZWlkaXN0YmxvYnN0b3JhZ2UuYmxvYi5jb3JlLndpbmRvd3MubmV0L25hc2EtZWJvb2stMS01MC9wYWdlLTQ1LnBkZg2",
            "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
        }
    ],
    "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."
                }
            ],
            "content": "\nA\nT\n\nM\nO\n\nS\nP\n\nH\nE\n\nR\nE\n\nE\nA\n\nR\nT\n\nH\n\n34\n\nValley Fog\nCanada\n\nFog 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",
            "metadata_storage_path": "aHR0cHM6Ly9oZWlkaXN0YmxvYnN0b3JhZ2UuYmxvYi5jb3JlLndpbmRvd3MubmV0L25hc2EtZWJvb2stMS01MC9wYWdlLTQxLnBkZg2",
            "people": [],
            "locations": [
                "Pacific Northwest",
                "North America",
                "Vancouver"
            ],
            "merged_content": "\nA\nT\n\nM\nO\n\nS\nP\n\nH\nE\n\nR\nE\n\nE\nA\n\nR\nT\n\nH\n\n34\n\nValley Fog\nCanada\n\nFog 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",
            "text": [],
            "layoutText": []
        }
    ]
}

Exemple de réponse pour featuresMode

Cet exemple montre la sortie « @search.features » d’une requête qui inclut featuresMode.

  {
    "@odata.count": # (if $count=true was provided in the query),
    "@search.coverage": # (if minimumCoverage was provided in the query),
    "@search.facets": { (if faceting was specified in the query)
      "facet_field": [
        {
          "value": facet_entry_value (for non-range facets),
          "from": facet_entry_value (for range facets),
          "to": facet_entry_value (for range facets),
          "count": number_of_documents
        }
      ],
      ...
    },
    "@search.nextPageParameters": { (request body to fetch the next page of results if not all results could be returned in this response and Search was called with POST)
      "count": ... (value from request body if present),
      "facets": ... (value from request body if present),
      "featuresMode" : ... (value from request body if present),
      "filter": ... (value from request body if present),
      "highlight": ... (value from request body if present),
      "highlightPreTag": ... (value from request body if present),
      "highlightPostTag": ... (value from request body if present),
      "minimumCoverage": ... (value from request body if present),
      "orderby": ... (value from request body if present),
      "scoringParameters": ... (value from request body if present),
      "scoringProfile": ... (value from request body if present),
      "scoringStatistics": ... (value from request body if present),
      "search": ... (value from request body if present),
      "searchFields": ... (value from request body if present),
      "searchMode": ... (value from request body if present),
      "select": ... (value from request body if present),
      "sessionId" : ... (value from request body if present),
      "skip": ... (page size plus value from request body if present),
      "top": ... (value from request body if present minus page size),
    },
    "value": [
      {
        "@search.score": document_score (if a text query was provided),
        "@search.highlights": {
          field_name: [ subset of text, ... ],
          ...
        },
        "@search.features": {
          "field_name": {
            "uniqueTokenMatches": feature_score,
            "similarityScore": feature_score,
            "termFrequency": feature_score,
          },
          ...
        },
        key_field_name: document_key,
        field_name: field_value (retrievable fields or specified projection),
        ...
      },
      ...
    ],
    "@odata.nextLink": (URL to fetch the next page of results if not all results could be returned in this response; Applies to both GET and POST)
  }

Exemples

Vous trouverez d’autres exemples dans syntaxe d’expression OData pour azure AI Search.

exemple : de recherche simple

Recherchez des documents dans l’index à l’aide de la syntaxe de requête simple. Cette requête retourne les hôtels où les champs pouvant faire l’objet d’une recherche contiennent les termes « confort » et « location », mais pas « motel » :

Get /indexes/hotels/docs?search=comfort +location –motel&searchMode=all&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "comfort +location -motel",  
      "searchMode": "all"  
    }  

exemple : de recherche Lucene complète

Recherchez des documents dans l’index à l’aide de la syntaxe de requête Lucene (consultez syntaxe de requête Lucene dans recherche Azure AI). Cette requête retourne les hôtels où le champ catégorie contient le terme « budget » et tous les champs pouvant faire l’objet d’une recherche contenant l’expression « récemment rénové ». Les documents contenant l’expression « récemment rénové » sont classés plus hauts en raison de la valeur d’augmentation du terme (3)

GET /indexes/hotels/docs?search=Category:budget AND \"recently renovated\"^3&searchMode=all&api-version=2021-04-30-Preview&querytype=full`

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "Category:budget AND \"recently renovated\"^3",  
      "queryType": "full",  
      "searchMode": "all"  
}  

exemple : de recherche sémantique

Appelez le modèle de classement sémantique avec des réponses, des légendes et du contenu mis en surbrillance. La réponse de cette requête se trouve dans la section précédente.

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
{
  "search": "how do clouds form",
  "queryType": "semantic",
  "semanticConfiguration": "my-semantic-config",
  "queryLanguage": "en-us",
  "answers": "extractive",
  "captions": "extractive",
  "count": "true"
}

exemple : de recherche vectorielle

Pour un index qui a des champs de type Collection(Edm.Single) et une configuration vectorielle, vous pouvez spécifier des paramètres de requête vectorielle. Les paramètres de requête vectorielle incluent les champs vectoriels qui sont dans l’étendue de la requête, le nombre « k » de correspondances principales à retourner et une représentation vectorielle de l’entrée de requête.

L’ajout d’un paramètre « select » est utile si l’index inclut des champs de texte. La correspondance et la pertinence sont basées sur des vecteurs, mais les champs contenant du contenu lisible par l’homme sont plus utiles à quelqu’un qui lit les résultats. Vous pouvez également écrire du code qui convertit les données vectorielles dans vos résultats de recherche en texte.

POST https://{{search-service-name}}.search.windows.net/indexes/{{index-name}}/docs/search?api-version={{api-version}}
Content-Type: application/json
api-key: {{admin-api-key}}
{
    "search": (this parameter is ignored in vector search),
    "vectors": [{
        "value": [
            -0.009154141,
            0.018708462,
            . . . 
            -0.02178128,
            -0.00086512347
        ],
        "fields": "contentVector",
        "k": 5
    }],
    "select": "title, content, category"
}

exemple : orderby

Recherchez l’index et retournez les résultats triés par date dans l’ordre décroissant.

GET /indexes/hotels/docs?search=*&$orderby=LastRenovationDate desc&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "*",  
      "orderby": "LastRenovationDate desc"
    }  

Exemple : filtrer à l’aide d’une expression OData

Récupérer des documents correspondant à une expression de filtre spécifique :

GET /indexes/hotels/docs?$filter=(Rooms/BaseRate ge 60 and Rooms/BaseRate lt 300) or HotelName eq 'Fancy Stay'&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "filter": "(Rooms/BaseRate ge 60 and Rooms/BaseRate lt 300) or HotelName eq 'Fancy Stay'"  
    }  

exemple : de recherche à facettes

Dans une recherche à facettes, recherchez l’index et récupérez des facettes pour les catégories, les évaluations, les balises, ainsi que les éléments avec baseRate dans des plages spécifiques.

GET /indexes/hotels/docs?search=*&facet=Category&facet=Rating&facet=Tags&facet=Rooms/BaseRate,values:80|150|220&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "test",  
      "facets": [ "Category", "Rating", "Tags", "Rooms/BaseRate,values:80|150|220" ]  
    }  

Notez que la dernière facette se trouve sur un sous-champ. Les facettes comptent le document parent (Hôtels) et non les sous-documents intermédiaires (Chambres), de sorte que la réponse détermine le nombre d’hôtels qui ont des chambres dans chaque compartiment de prix.

exemple : Affiner une requête à facettes

À l’aide d’un filtre, limitez le résultat de la requête à facettes précédente après que l’utilisateur sélectionne l’évaluation 3 et la catégorie « Motel ».

GET /indexes/hotels/docs?search=*&facet=tags&facet=Rooms/BaseRate,values:80|150|220&$filter=Rating eq 3 and Category eq 'Motel'&api-version=2021-04-30-Preview  

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview 
    {  
      "search": "test",  
      "facets": [ "tags", "Rooms/BaseRate,values:80|150|220" ],  
      "filter": "Rating eq 3 and Category eq 'Motel'"  
    }  

Exemple : recherche à facettes avec des limites pour chaque catégorie

Dans une recherche à facettes, définissez une limite supérieure sur les termes uniques retournés dans une requête. La valeur par défaut est 10, mais vous pouvez augmenter ou diminuer cette valeur à l’aide du paramètre count sur l’attribut de facette. Cet exemple retourne des facettes pour la ville, limitée à 5.

GET /indexes/hotels/docs?search=*&facet=Address/City,count:5&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "test",  
      "facets": [ "Address/City,count:5" ]  
    }  

exemple : de recherche dans le champ

Recherchez l’index dans des champs spécifiques (par exemple, un champ de langue)

GET /indexes/hotels/docs?search=hôtel&searchFields=Description_fr&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "hôtel",  
      "searchFields": "Description_fr"
    }  

Recherchez l’index sur plusieurs champs. Par exemple, vous pouvez stocker et interroger des champs pouvant faire l’objet d’une recherche dans plusieurs langues, dans le même index. Si les descriptions anglaises et françaises coexistent dans le même document, vous pouvez renvoyer tout ou partie des résultats de la requête :

GET /indexes/hotels/docs?search=hotel&searchFields=Description,Description_fr&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "hotel",  
      "searchFields": "Description, Description_fr"
    }  

Vous ne pouvez interroger qu’un seul index à la fois. Ne créez pas plusieurs index pour chaque langue, sauf si vous envisagez d’en interroger un à la fois.

exemple : pagination des résultats

Obtenez la première page des éléments (la taille de la page est 10) :

GET /indexes/hotels/docs?search=*&$skip=0&$top=10&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "*",  
      "skip": 0,  
      "top": 10  
    }  

Obtenez la deuxième page d’éléments (la taille de la page est de 10) :

GET /indexes/hotels/docs?search=*&$skip=10&$top=10&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "*",  
      "skip": 10,  
      "top": 10  
    }  

exemple : limiter les champs d’un jeu de résultats

Récupérez un ensemble spécifique de champs :

GET /indexes/hotels/docs?search=*&$select=HotelName,Description&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "*",  
      "select": "HotelName, Description"
    }  

exemple : mise en surbrillance des résultats dans les résultats

Recherchez l’index et retournez des fragments avec des surbrillances d’accès :

GET /indexes/hotels/docs?search=something&highlight=Description&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "something",  
      "highlight": "Description"  
    }  

exemple : de recherche géospatiale

Recherchez l’index et retournez des documents triés de plus près d’un emplacement de référence :

GET /indexes/hotels/docs?search=something&$orderby=geo.distance(Location, geography'POINT(-122.12315 47.88121)')&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "something",  
      "orderby": "geo.distance(Location, geography'POINT(-122.12315 47.88121)')"
    }  

Exemple : « trouver par moi » (améliorer la pertinence des emplacements proches

Recherchez l’index en supposant qu’il existe un profil de scoring appelé « geo » avec deux fonctions de scoring de distance, l’une définissant un paramètre appelé « currentLocation » et l’autre définissant un paramètre appelé « lastLocation ». Dans l’exemple suivant, « currentLocation » a un délimiteur d’un tiret unique (-). Elle est suivie des coordonnées longitude et latitude, où la longitude est une valeur négative.

GET /indexes/hotels/docs?search=something&scoringProfile=geo&scoringParameter=currentLocation--122.123,44.77233&scoringParameter=lastLocation--121.499,44.2113&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "something",  
      "scoringProfile": "geo",  
      "scoringParameters": [ "currentLocation--122.123,44.77233", "lastLocation--121.499,44.2113" ]  
    }  

Exemple : interroger sur l’index complet au lieu de partitions

Recherchez des documents dans l’index tout en favorisant le scoring cohérent sur une latence inférieure. Cette requête calcule les fréquences de document sur l’index entier et fait un meilleur effort pour cibler le même réplica pour toutes les requêtes au sein de la même « session », ce qui permet de générer un classement stable et reproductible.

GET /indexes/hotels/docs?search=hotel&sessionId=mySessionId&scoringStatistics=global&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "hotel",  
      "sessionId": "mySessionId",
      "scoringStatistics" :"global"
    }  

Exemple : statistiques de scoring (featuresMode)

Recherchez des documents dans l’index et retournez une liste des fonctionnalités de récupération d’informations pour chaque résultat décrivant le scoring entre le document correspondant et la requête. La requête calcule également les fréquences de document sur l’index entier pour produire un scoring plus cohérent.

GET /indexes/hotels/docs?search=hotel&featuresMode=enabled&scoringStatistics=global&api-version=2021-04-30-Preview

POST /indexes/hotels/docs/search?api-version=2021-04-30-Preview
    {  
      "search": "hotel",  
      "featuresMode": "enabled",
      "scoringStatistics" :"global"
    }  

Voici un exemple de réponse qui inclut search.features ressemble à ce qui suit :

    "@search.score": 0.91875637,
    "@search.features": {
        "Description": {
            "uniqueTokenMatches": 1,
            "similarityScore": 0.2917966,
            "termFrequency": 2
        },
        "HotelName": {
            "uniqueTokenMatches": 1,
            "similarityScore": 0.44458693,
            "termFrequency": 1
        }
      . . .

Définitions

Cette section fournit des détails sur les paramètres trop complexes à couvrir dans la table principale.

queryLanguage

Les valeurs valides pour le paramètre queryLanguage sont fournies dans le tableau suivant, dans la colonne « queryLanguage » et ne respectent pas la casse. La valeur par défaut du paramètre dans son ensemble est «en-us». Dans chaque langue, il existe une variante par défaut pour chaque code de langue à deux caractères. Par exemple, si vous spécifiez « es », «es-us» est utilisé par défaut. Le paramètre queryLanguage est requis pour une requête qui inclut « queryType=semantic » ou « speller=lexicon ». Il n’existe qu’une seule valeur queryLanguage pour l’ensemble de la requête, et cette valeur sera utilisée pour le classement sémantique, les légendes, les réponses et l’orthographique (il n’existe aucun remplacement pour les fonctionnalités individuelles).

À ce stade, la prise en charge linguistique varie selon la fonctionnalité. Seuls l’anglais, l’espagnol, le français et l’allemand sont pris en charge pour l’ensemble complet des fonctionnalités, mais notez que la vérification orthographique implémente moins de variantes.

Si vous spécifiez un code de langue qui n’est pas pris en charge par une fonctionnalité donnée, par exemple EN-GB avec l’orthographique, le service retourne HTTP 400.

Pour plus d’informations sur l’utilisation de chaque fonctionnalité, consultez Activer le classement sémantique et les légendes, renvoyer une réponse sémantiqueet Ajouter une vérification orthographique aux requêtes.

La désignation « (préversion) » indique que le test de validation sur toutes les fonctionnalités (classement sémantique, légendes, réponses et vérification orthographique) est en cours ou en attente. Nous encourageons l’utilisation de toutes les variantes de langue dans le tableau suivant, mais vous recommandons de tester davantage les langues d’aperçu pour vous assurer que les résultats sont valides pour votre contenu. Les langues avec une coche et aucune désignation en préversion n’ont été validées à l’aide de jeux de données équivalents, avec un gain mesurable en pertinence.

Voir aussi

• Création de requêtes dans azure AI Search
• requêtes dans azure AI Search
• Fonctionnement de la recherche en texte intégral dans azure AI Search
• syntaxe d’expression OData pour les Recherche Azure
• syntaxe de requête simple dans le Recherche Azure AI