Partager via

Versions de l’API REST du plan de données (Recherche Azure AI)

Cet article répertorie les versions actuelles et passées des API REST de recherche pour Recherche Azure AI Search.

Documentation de l’API avec version

Les documents de l’API REST sont désormais versionnés. Lorsque vous ouvrez une page de référence d’API, un sélecteur de version apparaît au-dessus de la table des matières. Le sélecteur devient disponible lorsque vous choisissez une page dans le dossier Plan de données de référence>.

Capture d’écran du sélecteur de version.

Versions stables

Version de l’API Spécification Mises à jour d’API
2025-09-01 (dernière en date) spécification Swagger note de publication
2024-07-01 spécification Swagger note de publication
2023-11-01 spécification Swagger note de publication
2020-06-30 spécification Swagger note de publication
2019-05-06 spécification Swagger Ajoute des types complexes.

Préversion des versions

Toutes les nouvelles fonctionnalités sont introduites dans les API de préversion avant de passer à une version stable. Les API en préversion sont disponibles sous conditions d’utilisation supplémentaires pour les préversions Microsoft Azure.

Version de l’API Spécification Mises à jour d’API
2025-11-01-preview (dernière en date) spécification Swagger note de publication
2025-08-01-preview spécification Swagger note de publication
2025-05-01-preview spécification Swagger note de publication
2025-03-01-preview spécification Swagger note de publication
2024-11-01-preview spécification Swagger note de publication
2024-09-01-preview spécification Swagger note de publication
2024-05-01-preview spécification Swagger note de publication
2024-03-01-preview spécification Swagger note de publication
2023-10-01-preview spécification Swagger note de publication
2023-07-01-preview (déconseillé) spécification Swagger note de publication
2021-04-30-preview spécification Swagger note de publication
2020-06-30-preview spécification Swagger note de publication
2019-05-06-preview spécification Swagger note de publication

Notes de publication

2025-11-01-preview

Cette préversion s’appuie sur et 2025-08-01-preview inclut toutes les fonctionnalités actuellement en préversion.

Si vous avez utilisé le pour créer un agent de 2025-08-01-preview connaissances, qui a depuis été renommé base de connaissances, cet aperçu introduit des modifications cassantes. Pour obtenir de l’aide sur la migration, consultez Migrer le code de récupération agentique vers la dernière version.

Pour plus d’informations sur ces mises à jour, consultez Nouveautés d’Azure AI Search.

Caractéristique Mettre à jour Applicable REST API
Bases de connaissances (anciennement agents de connaissances) Les agents de connaissances ont été renommés bases de connaissances, ce qui modifie plusieurs itinéraires :

  • /agents est maintenant /knowledgebases
  • /agents/agent-name est maintenant /knowledgebases/knowledge-base-name
  • /agents/agent-name/retrieve est maintenant /knowledgebases/knowledge-base-name/retrieve

Les bases de connaissances référencent désormais les sources de connaissances par leur nom uniquement, toute la configuration étant déplacée vers la demande d’extraction. outputConfiguration est remplacé par outputMode (un énumérateur de chaînes) et requestLimits les propriétés (maxRuntimeInSeconds, maxOutputSize) sont désormais des paramètres de demande d’extraction. Les enregistrements d’activité du ranker sémantique sont remplacés par des enregistrements de raisonnement agentique.

 Bases de connaissances
Sources de connaissances Nouveaux types de sources de connaissances :

  • indexedOneLake
  • indexedSharePoint
  • remoteSharePoint
  • web

Les sources de connaissances indexées prennent désormais en charge status les opérations et ingestionParameters les paramètres d’identité de groupe, de modèle d’intégration, de modèle d’achèvement de conversation, d’extraction de contenu et d’ingestion. Les sources de connaissances de l’index de recherche ont de nouvelles propriétés (searchFields, semanticConfigurationName) et sont renommées sourceDataSelect en sourceDataFields.

 Sources de connaissances
Récupération des connaissances Les paramètres de requête (rerankerThreshold, alwaysQuerySource, includeReferences) sont désormais transmis par source de connaissances via knowledgeSourceParams. Prend en charge les réponses partielles avec des codes d’état HTTP 206 et des sorties d’erreur facultatives dans les enregistrements d’activité. Le minimal mode de raisonnement utilise un intent objet (requêtes de recherche directe) au lieu d’un LLM pour la planification des requêtes. Récupération des connaissances
Compétence de compréhension du contenu Azure Nouvelle compétence qui intègre Azure Content Understanding dans Foundry Tools pour extraire des fichiers Markdown structurés à partir de texte, d’images, de fichiers PDF, de Microsoft PowerPoint, de Microsoft Word, etc. Pour les sources de connaissances indexées, cette compétence est disponible via la contentExtractionMode propriété dans ingestionParameters. Ensembles de compétences - Créer ou mettre à jour
Prise en charge de la liste de contrôle d’accès de l’indexeur SharePoint Prise en charge étendue de l’ACL pour transférer des autorisations SharePoint de base aux documents indexés, permettant ainsi le contrôle d’accès au niveau du document. Index - Créer ou mettre à jour, Sources de données - Créer ou mettre à jour et Documents - Publier une recherche
Autorisations de lecture élevées pour les listes de contrôle d’accès Nouvelle fonctionnalité permettant d’attribuer des autorisations de lecture élevées aux administrateurs pour l’examen des problèmes liés aux configurations ACL utilisées dans le contrôle d’accès aux documents. Documents - Recherche post
Indexation des étiquettes de sensibilité au niveau du document Nouvelle intégration avec Microsoft Purview pour synchroniser les étiquettes de confidentialité des documents avec l’index, en respectant leurs étiquettes et la protection au moment de la requête pour la gouvernance des données. Index - Créer ou mettre à jour, Sources de données - Créer ou mettre à jour et Documents - Publier une recherche
Mises à jour de l’indexation SharePoint Nouvelles fonctionnalités de l’indexeur SharePoint, y compris des options d’authentification améliorées, des mises à jour incrémentielles et une gestion de base des autorisations de document. Sources de données - Créer ou mettre à jour
Agrégation de fonctions de scoring Nouvelle capacité de combiner et d’agréger plusieurs fonctions de notation, permettant une personnalisation plus sophistiquée de la pertinence et une combinaison de signaux pondérés. Index - Créer ou mettre à jour
Agrégations de facettes De nouvelles opérations d’agrégation de facettes, notamment le minimum, le maximum, la moyenne et la cardinalité, fournissent des analyses améliorées dans les expériences de recherche à facettes. Index - Créer ou mettre à jour

2025-09-01

Cette version de l’API est la dernière API REST stable pour Azure AI Search. Il s’appuie sur la version stable précédente (2024-07-01) et ajoute les mises à jour de l’API répertoriées dans le tableau suivant.

Quelques autres fonctionnalités généralement disponibles, telles que l’intégration de Logic Apps et la prise en charge du profil de scoring sémantique, n’affectent pas le contrat d’API et ne sont pas reflétées dans le tableau. Pour obtenir la liste complète des annonces, consultez Nouveautés d’Azure AI Search .

Caractéristique Mettre à jour Applicable REST API
Indexeur OneLake Automatise la récupération et l’indexation des données à partir d’un lakehouse Microsoft OneLake. Créer ou mettre à jour des sources de données
Compétence Mise en page du document Fragmente le texte en fonction de la structure du document. créer ou mettre à jour un ensemble de compétences
Propriété du normaliseur Prend en charge le filtrage, le facettage et le tri insensibles à la casse. créer ou mettre à jour des d’index
Propriété de description d’index Décrit un index, qui est utile pour l’ingénierie rapide dans les charges de travail RAG. créer ou mettre à jour des d’index
Options de réévaluation des vecteurs compressés Modifie les résultats de la recherche vectorielle avec des vecteurs originaux au lieu de vecteurs compressés. S’applique à HNSW et aux algorithmes de vecteur KNN exhaustifs, à l’aide de la compression binaire et scalaire. créer ou mettre à jour des d’index
Dimensions tronquées S’applique aux modèles text-embedding-3-small et text-embedding-3-large, réentraînés sur la quantification MRL (Representation Learning) de Matriochka. créer ou mettre à jour des d’index
Paramètre de débogage et sous-scores de requête Décompresse un score de résultat de recherche hybride en ses composants. rechercher des documents

2025-08-01-preview

Cette préversion s’appuie sur et 2025-05-01-preview inclut toutes les fonctionnalités actuellement en préversion.

Si vous avez utilisé le pour créer un agent de 2025-05-01-preview connaissances, cet aperçu introduit des modifications cassantes. Pour obtenir de l’aide sur la migration, consultez Migrer le code de récupération agentique vers la dernière version.

Pour plus d’informations sur ces mises à jour, consultez Nouveautés d’Azure AI Search.

Caractéristique Mettre à jour Applicable REST API
Agents du savoir Modifications architecturales de la définition de l’agent de connaissances, qui nécessite désormais un ou plusieurs knowledgeSources au lieu de targetIndexes et déconseille defaultMaxDocsForReranker.

Ajoute plusieurs propriétés pour un meilleur contrôle de la planification et de l’exécution des requêtes, notamment retrievalInstructions, answerSynthesiset attemptFastPath.

 Agents du savoir - Créer ou mettre à jour
Sources de connaissances Nouvelles API REST pour la création et la gestion de sources de connaissances, qui prennent en charge searchIndex (un ou plusieurs index) et azureBlob les types. Sources de connaissances
Post-filtrage strict pour les requêtes vectorielles Nouvelle strictPostFilter valeur pour vectorFilterMode, qui applique des filtres une fois que les résultats globaux du vecteur supérieurk ont été identifiés. Documents - Recherche post
Augmentation des dimensions maximales pour les champs vectoriels Les maximums dimensions par champ vectoriel sont maintenant 4096. Cette mise à jour s’applique à toutes les versions stables et prévisualisées de l’API REST qui prennent en charge les vecteurs et n’introduit pas de modifications cassantes. Index - Créer ou mettre à jour
Amélioration des informations de suivi de l’exécution de l’indexeur L’option Obtenir les statistiques de service renvoie désormais des informations cumulatives de traitement de l’indexeur pour l’ensemble du service de recherche. Obtenir l’état : les indexeurs fournissent les mêmes informations pour les indexeurs individuels. Obtenir les statistiques de service et obtenir l’état - Indexeurs

2025-05-01-preview

Cette préversion s’appuie sur et 2025-03-01-preview inclut toutes les fonctionnalités actuellement en préversion. Vous pouvez mettre à niveau les versions de l’API REST de 2025-03-01-preview à 2025-05-01-preview avec des modifications de code minimales.

Cette préversion ajoute la prise en charge de la récupération agentique, de l’indexation multimodale, de l’héritage des autorisations au niveau du document et d’une intégration plus poussée avec des modèles de langage volumineux dans les charges de travail d’indexation et de requête. Pour plus d’informations, consultez Nouveautés d’Azure AI Search.

Caractéristique Mettre à jour Applicable REST API
Récupération agentique Ajoute l’extension des requêtes à l’aide de modèles de langage conversationnel pour une planification intelligente des requêtes. Il génère également une réponse complexe qui inclut des données de mise à la terre pour les applications de chat en aval. La réponse comprend un plan de requête et des données de référence basées sur les documents sources. Agents du savoir et récupération du savoir
Compétence Invite GenAI Permet de spécifier des invites et un LLM pour générer un nouveau contenu de champ. créer ou mettre à jour un ensemble de compétences
Compétence Mise en page du document Prend désormais en charge la détection d’image et la préservation du contexte pour l’indexation multimodale. créer ou mettre à jour un ensemble de compétences
Intégration d’Azure Logic Apps Développe les types de sources de données pris en charge pour l’indexation basée sur l’indexeur qui s’exécutent à partir de workflows. Créer ou mettre à jour des sources de données
Héritage des autorisations au niveau du document Prend en charge les résultats de recherche autorisés par utilisateur. Créer ou mettre à jour des index (filtres d’autorisation)

Créer ou mettre à jour des sources de données (options d’autorisation)

2025-03-01-preview

Cette préversion s’appuie sur et 2024-11-01-preview inclut toutes les fonctionnalités actuellement en préversion. Vous pouvez mettre à niveau les versions de l’API REST de 2024-11-01-preview à 2025-03-01-preview avec des modifications de code minimales.

Il n’y a que quelques mises à jour de l’API du plan de données dans cette préversion, mais d’autres fonctionnalités sont disponibles sur le service de recherche lorsque votre code appelle cette version préliminaire de l’API. Pour plus d’informations, consultez Nouveautés d’Azure AI Search.

Mettre à jour Applicable REST API
Hiérarchies de facettes, agrégation et filtres, utilisés pour générer des structures de navigation par facettes sur des facettes hiérarchiques, agrégées et filtrées. Recherche de documents, nouveaux paramètres de facette sur la demande.
Inscription du classeur sémantique pour les modèles en vol Créez ou mettez à jour Index, nouvelle propriété booléenne flightingOptIn dans la section de configuration sémantique. Si un modèle de classement sémantique en préversion est disponible dans la région de votre service de recherche, il est utilisé à la place de la version stable pour le classement secondaire. Cette propriété est destinée aux développeurs qui souhaitent tester les derniers modèles de classement sur du code hors production.

2024-11-01-preview

Cette préversion s’appuie sur et 2024-09-01-preview inclut toutes les fonctionnalités actuellement en préversion. Vous pouvez mettre à niveau les versions de l’API REST de 2024-09-01-preview à 2024-11-01-preview avec des modifications de code minimales.

Mettre à jour Applicable REST API
réécriture de requête dans le réécriture sémantique, utilisée pour affiner les requêtes envoyées au ranker L2. Rechercher des documents, nouvelle propriété QueryRewritesType dans la requête.
compétence Disposition de document utilisée pour analyser un document pour la structure. Créer ou mettre à jour un ensemble de compétences, nouvelle compétence DocumentIntelligenceLayoutSkill.
Identité managée pour attacher une ressource multiservice Azure AI. Créer ou mettre à jour un ensemble de compétences, nouvelle propriété AIServicesAccountIdentity.
mode d’analyse Markdown, utilisé pour l’indexation de fichiers Markdown dans Stockage Azure. créer ou mettre à jour un indexeur, nouveau mode d’analyse markdown.
options de rescoring pour les vecteurs compressés, utilisées pour rescoring avec des vecteurs d’origine au lieu de vecteurs compressés. S’applique à HNSW et aux algorithmes de vecteur KNN exhaustifs, à l’aide de la compression binaire et scalaire. créer ou mettre à jour und’index , de nouvelles propriétés rescoringOptions. Une nouvelle propriété enableRescoring est mappée à rerankWithOriginalVectors introduite en 2024-03-01-preview.

2024-09-01-preview

Cette préversion s’appuie sur et 2024-05-01-preview inclut toutes les fonctionnalités actuellement en préversion. Vous pouvez effectuer une mise à niveau de 2024-05-01-preview vers 2024-09-01-preview sans aucune modification du code requise. Pour plus d’informations, consultez Mettre à niveau les API REST.

Mettre à jour Applicable REST API
dimensions tronquées pour la quantisation MRL (Text-Embedding-3-small) et text-embedding-3-larges. créer ou mettre à jour und’index , nouveau paramètre troncationDimension
Sous-scores ou détails de scoring pour décompresser les résultats de recherche hybride marqués par fusion de classement réciproque (RRF). Rechercher des documents, de nouveaux déboguer paramètres et des définitions de sous-score de requête dans la réponse.
Filtrage cible sur la partie vectorielle d’une requête de recherche hybride . Search Documents, nouveau paramètre de filterOverride dans RawVectorQuery, VectorizableTextQuery, VectorizableImageUrlQuery, VectorizableImageBinaryQuery.
Segmentation des jetons dans compétence Fractionnement de texte, au lieu de caractères. Créer ou mettre à jour un ensemble de compétences, un nouveau paramètre d’unité et d’autres propriétés liées aux jetons.

2024-07-01

Cette version fournit des mises à jour généralement disponibles pour la vectorisation intégrée (compétences et vectoriseurs), la quantisation scalaire et la quantisation binaire. Pour plus d’informations, consultez Nouveautés d’Azure AI Search.

Mettre à jour Applicable REST API
Disponibilité générale : types de données vectorielles créer ou mettre à jour des d’index
Généralement disponible : propriétés de quantisation vectorielle pour la quantisation scalaire ou binaire intégrée dans un index de recherche. créer ou mettre à jour des d’index
Généralement disponible : propriété stockée sur un champ vectoriel qui détermine si une copie supplémentaire du champ est stockée. La copie supplémentaire est le contenu récupérable de ce champ. Si vous ne le stockez pas, le champ est toujours utilisé dans les requêtes, mais ne peut pas être retourné dans un résultat de recherche. Vous pouvez définir cette propriété pour conserver de l’espace sur votre service de recherche ou quota de vecteurs dans un index de recherche. créer ou mettre à jour des d’index
Généralement disponible : paramètres VectorizableTextQuery pour le réglage de pertinence. Les paramètres de requête hybride (MaxTextSizeRecall) sont toujours en préversion. rechercher des documents
Généralement disponible - Compétence AzureOpenAIEmbedding pour prendre en charge plus de modèles que simplement l’incorporation de texte-ada-002 pour la vectorisation intégrée pendant l’indexation. Définissez les propriétés de nom et de dimensions du modèle pour cibler un modèle spécifique. créer ou mettre à jour un ensemble de compétences
En disponibilité générale : vectoriseur d’incorporation Azure OpenAI pour la vectorisation intégrée pendant les requêtes. Les propriétés vectoriseurs prennent en charge d’autres modèles. créer ou mettre à jour des d’index
À compter du 29 mars 2024 : les réponses GET ne retournent plus de chaînes de connexion ou de clés. Consultez changement cassant pour le code client qui lit les informations de connexion pour plus d’informations. Toutes les versions

2024-05-01-preview

Cette préversion ajoute la prise en charge de l’indexation OneLake, du réglage de la pertinence et de l’intégration plus approfondie avec des modèles d’incorporation supplémentaires lors de l’indexation et des requêtes. Il s’appuie sur le 2024-03-01-preview et inclut toutes les fonctionnalités actuellement en préversion.

Pour effectuer une mise à niveau à partir de 2024-03-01-preview ou de 2023-10-01-preview, mettez à jour la compétence ou le vectoriseur AzureOpenAIEmbedding pour inclure le nom et les dimensions du modèle. Pour effectuer une mise à niveau à partir de 2023-07-01-preview (déconseillé) ou pour obtenir des instructions pas à pas, consultez Mettre à niveau les API REST.

Voici les mises à jour de cette préversion. Nous vous recommandons également d'nouveautés d’Azure AI Search.

Mettre à jour Applicable REST API
Source de données de l’indexeur pour les fichiers OneLake et les raccourcis. créer ou mettre à jour des de source de données
Collection(Edm.Byte), type de données binaires pour l’incorporation de modèles qui les prennent en charge. Les définitions de champ vectoriel prennent en charge ce type de données. créer ou mettre à jour des d’index
Paramètres de requête vectorielles et hybrides multiples pour le réglage de la pertinence. Définissez des seuils pour exclure les résultats de score faible. Requêtes vectorielles de poids. Pour les requêtes hybrides, définissez le nombre maximal de documents à récupérer dans la partie texte d’une requête hybride. rechercher des documents
Nouvelle compétence Azure AI Vision pour la vectorisation intégrée modale lors de l’indexation. Cette compétence appelle l’API modale d’Azure AI Vision. créer ou mettre à jour un ensemble de compétences
Nouveau vectoriseur Azure AI Vision pour les requêtes modales. Un vectoriseur est spécifié dans les définitions d’index, mais utilisé pendant l’exécution de la requête. créer ou mettre à jour des d’index
Mise à jour de la compétence AzureOpenAIEmbedding pour prendre en charge plus de modèles que simplement l’incorporation de texte-ada-002 pour la vectorisation intégrée pendant l’indexation. Définissez les propriétés de nom et de dimensions du modèle pour cibler un modèle spécifique. créer ou mettre à jour un ensemble de compétences
Mise à jour du vectoriseur d’incorporation Azure OpenAI pour la vectorisation intégrée pendant les requêtes. Les propriétés vectoriseurs prennent en charge d’autres modèles. créer ou mettre à jour des d’index
À compter du 29 mars 2024 : les réponses GET ne retournent plus de chaînes de connexion ou de clés. Consultez changement cassant pour le code client qui lit les informations de connexion pour plus d’informations. Toutes les versions

2024-03-01-preview

Cette préversion s’appuie sur 2023-10-01-preview en ajoutant des API d’aperçu qui améliorent le stockage vectoriel. Pour plus d’informations, consultez Nouveautés d’Azure AI Search.

Mettre à jour Applicable REST API
De nouveaux types de données étroits pour les champs vectoriels si vous avez incorporé des modèles qui les prennent en charge ou une logique de quantisation qui génère des vecteurs plus petits. créer ou mettre à jour des d’index
Nouvelles propriétés de quantisation de vecteurs pour la compression vectorielle intégrée dans un index de recherche. créer ou mettre à jour des d’index
Nouvelle propriété booléenne propriété stockée sur un champ vectoriel qui détermine si une copie supplémentaire du champ est stockée. La copie supplémentaire est le contenu récupérable de ce champ. Si vous ne le stockez pas, le champ est toujours utilisé dans les requêtes, mais ne peut pas être retourné dans un résultat de recherche. Vous pouvez définir cette propriété pour conserver de l’espace sur votre service de recherche ou quota de vecteurs dans un index de recherche. créer ou mettre à jour des d’index
À compter du 29 mars 2024 : les réponses GET ne retournent plus de chaînes de connexion ou de clés. Consultez changement cassant pour le code client qui lit les informations de connexion pour plus d’informations. Toutes les versions

2023-11-01

Cette version fournit des fonctionnalités en disponibilité générale. Pour plus d’informations, consultez Nouveautés d’Azure AI Search.

Mettre à jour Applicable REST API
Classement sémantique dans les demandes de publication de recherche. rechercher des documents
Configuration de la recherche vectorielle pour l’indexation des champs vectoriels créer ou mettre à jour des d’index
Requêtes vectorielles dans les requêtes de publication de recherche. rechercher des documents
À compter du 29 mars 2024 : les réponses GET ne retournent plus de chaînes de connexion ou de clés. Consultez changement cassant pour le code client qui lit les informations de connexion pour plus d’informations. Toutes les versions

2023-10-01-preview

Cette version inclut toutes les fonctionnalités introduites dans les préversions précédentes, ainsi que les ajouts et modifications apportés aux API de recherche vectorielle. Les mises à jour apportées aux API de recherche vectorielle sont un changement cassant de 2023-07-01-Preview. Consultez Ajouter des champs vectoriels et Créer un de requête vectorielle pour obtenir de l’aide sur la migration.

Si vous envisagez d’utiliser la nouvelle fonctionnalité de préfiltrage, vous devez utiliser un index créé après 2023-10-01.

créer ou mettre à jour und’index :

  • vectorSearch a des définitions pour algorithms, profileset vectorizers:

    • algorithms continue de prendre en charge hnsw et prend désormais également en charge eknn, en référence à l’HNSW (Hierarchical Navigable Small World) et aux voisins les plus proches de K (eKNN). Dans la section algorithme, vous pouvez définir plusieurs combinaisons nommées de paramètres HNSW et eKNN. Cela remplace algorithmConfigurations dans la propriété vectorSearch en 2023-07-01-Preview.

    • profiles est une nouvelle définition qui spécifie la configuration de l’algorithme. Par exemple, supposons que vous ayez des configurations d’algorithmes nommées HNSW-1, HSNW-2, eKNN-1. Un profil peut spécifier HNSW-1.

    • vectorizers est défini dans un index, mais utilisé au moment de la requête pour incorporer une chaîne de requête de texte. Un vectoriseur fait référence à un modèle d’incorporation. Le service de recherche effectue un appel au modèle d’incorporation pour vectoriser la chaîne de requête de texte, puis transmet le résultat au moteur de recherche pour une requête vectorielle.

  • Sur les champs vectoriels, vectorSearchProfile remplace vectorSearchConfiguration. La propriété vectorSearchProfile spécifie le profil de recherche vectorielle à utiliser sur le champ.

  • Sur les index créés avant cette version de l’API, lors de l’appel de l’API 2023-10-01-Preview, dans votre demande, vous devez modifier le champ pour spécifier une vectorSearchProfile tant que le profil spécifie exactement le même algorithme précédemment spécifié dans vectorSearchConfiguration. Par exemple, si la définition de champ existante spécifie "vectorSearchConfiguration": "myHnsw", vous devez la remplacer par "vectorSearchProfile": "your profile name"et que le profil doit être défini pour référencer la même "algorithm": "myHnsw".

rechercher des documents:

  • vectorQueries remplace vectors en 2023-07-01-Preview
  • vectorQueries.vectors remplace vectors.values en 2023-07-01-Preview.
  • La requête vectorielle est désormais une structure polymorphe. kind devez être spécifié pour indiquer le type de requête vectorielle demandée. "kind": "vector" signifie que la requête est un vecteur. L’appelant doit donc déjà vectoriser la chaîne de requête de recherche dans un vecteur incorporé.
  • "exhaustive": "true" est une nouvelle propriété spécifie s’il faut effectuer une recherche exhaustive (brute-force) k-near voisin sur tous les vecteurs de l’index vectoriel.
  • vectorFilterMode est un nouveau paramètre permettant de spécifier le préfiltrage (par défaut pour les index créés après 2023-10-01) ou le postfiltrage (par défaut sur les index précédents) dans la requête.

À compter du 29 mars 2024 : les réponses GET ne retournent plus de chaînes de connexion ou de clés. Consultez changement cassant pour le code client qui lit les informations de connexion pour plus d’informations.

2023-07-01-preview

Important

N’utilisez pas cette version de l’API. La dépréciation de cette préversion a été annoncée le 15 avril 2024 et n’est plus prise en charge après le 8 juillet 2024. Pour obtenir de l’aide sur la migration, consultez Mettre à niveau les API REST dans azure AI Search.

Cette version a introduit la prise en charge des vecteurs et utilise une configuration vectorielle incompatible avec les versions d’API plus récentes.

  • Ajout d’un type de données Collection(Edm.Single) sur les champs qui contiennent un tableau de nombres à virgule flottante simple précision. Il s’agit du type de données pour les vecteurs, utilisé pour stocker un incorporation généré par champ de document. L’index de recherche spécifie également les propriétés de configuration vectorielle.
  • Mise à jour des charges de travail d’indexation pour accepter les données vectorielles.
  • Ajout de paramètres de requête pour la recherche vectorielle. Voir Rechercher des documents pour ces paramètres.
  • Obtenir les statistiques du service : renvoie le quota d’index vectoriel et l’utilisation du service.
  • Obtenir les statistiques d’index : renvoie le quota d’index vectoriel et l’utilisation de l’index de recherche.
  • À compter du 29 mars 2024 : les réponses GET ne retournent plus de chaînes de connexion ou de clés. Consultez changement cassant pour le code client qui lit les informations de connexion pour plus d’informations.

2021-04-30-preview

Cette préversion inclut toutes les fonctionnalités introduites en 2020-06-30-Preview, ainsi que les ajouts aux API suivantes :

  • L’alias d’index ajoute un nom secondaire utilisé pour référencer les index dans les requêtes et les demandes d’indexation. Les opérations d’alias incluent la création, la mise à jour, la suppression, l’obtention et la liste.
  • identités managées pour les connexions sortantes. Les nouvelles valeurs des chaînes de connexion dans Créer ou mettre à jour la source de données prennent en charge les connexions à l’aide de l’authentification et des rôles Microsoft Entra ID au lieu des informations d’identification ou des clés de base de données codées en dur.
  • La prise en charge des identités managées est également prise en charge pour les connexions key vault, pour les solutions de recherche qui complètent le chiffrement par défaut avec chiffrement géré par le client.
  • Plus de langues pour la compétence cognitive traduction de texte.
  • Plus de requêteLangues pour la recherche sémantique et l’orthographe dans les documents de recherche.
  • Un paramètre captions pour demander éventuellement des légendes à partir de la recherche sémantique dans Rechercher des documents.
  • Les configurations sémantiques sont spécifiées dans Créer ou Mettre à jour l’index. Une configuration sémantique détermine les champs à utiliser pour le classement sémantique, les légendes, les mises en surbrillance et les réponses.
  • Paramètre semanticConfiguration requis pour les requêtes sémantiques dans les documents de recherche.
  • À compter du 29 mars 2024 : les réponses GET ne retournent plus de chaînes de connexion ou de clés. Consultez changement cassant pour le code client qui lit les informations de connexion pour plus d’informations.

2020-06-30

Cette version fournit des fonctionnalités généralement disponibles, notamment :

  • Contrôle d’accès en fonction du rôle Azure pour les opérations de plan de données
  • Score de pertinence (BM25)
  • Magasins de connaissances
  • Source de données de l’indexeur pour Azure Data Lake Storage (ADLS) Gen2
  • Compétence de recherche d’entité personnalisée
  • Indexeurs s’exécutant sous une identité système ou gérée par l’utilisateur via l’ID Microsoft Entra
  • À compter du 29 mars 2024 : les réponses GET ne retournent plus de chaînes de connexion ou de clés. Consultez changement cassant pour le code client qui lit les informations de connexion pour plus d’informations.

2020-06-30-preview

Cette préversion inclut toutes les fonctionnalités introduites en 2019-05-06-Preview, ainsi que les ajouts suivants :

  • Recherche sémantique, fonctionnalité Premium qui s’exécute sur les services de niveau Standard et qui appelle le classement sémantique.
  • Source de données de l’indexeur pour les connecteurs Power Query
  • Source de données de l’indexeur pour MySQL
  • Source de données de l’indexeur pour l’API Gremlin Cosmos DB
  • Source de données de l’indexeur pour SharePoint Online
  • Propriété normaliseur pour la normalisation du texte, pour le filtrage sans respect de la casse, la facette et le tri
  • Réinitialiser les documents pour l’indexation basée sur l’indexeur afin d’actualiser spécifiquement des documents spécifiques par ID
  • Compétence cognitive de liaison d’entités (v3)
  • Compétence cognitive De reconnaissance d’entité (v3)
  • Compétence cognitive Analyse des sentiments (v3)
  • À compter du 29 mars 2024 : les réponses GET ne retournent plus de chaînes de connexion ou de clés. Consultez changement cassant pour le code client qui lit les informations de connexion pour plus d’informations.

2019-05-06-preview

  • Prise en charge des sources de données de l’indexeur pour l’API MongoDB Cosmos DB
  • Source de données de l’indexeur pour la suppression réversible dans le stockage Blob
  • paramètre featuresMode qui retourne des informations détaillées sur un score de pertinence
  • Compétence cognitive Azure Machine Learning (AML)
  • Compétence cognitive de détection d’identification personnelle
  • Mettre en cache des documents enrichis pour préserver et réutiliser le traitement des images (et d’autres enrichissements par IA)
  • À compter du 29 mars 2024 : les réponses GET ne retournent plus de chaînes de connexion ou de clés. Consultez changement cassant pour le code client qui lit les informations de connexion pour plus d’informations.

Voir aussi

  • Last updated on