Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Note
Certaines fonctionnalités de récupération agentique sont généralement disponibles dans la version de l’API REST 2026-04-01 via l’accès par programmation. Le portail Azure et le portail Microsoft Foundry continuent de fournir un accès en préversion uniquement à toutes les fonctionnalités de récupération agentique. Pour obtenir des conseils sur la migration, notamment une répartition des éléments généralement disponibles et ceux qui restent en version préliminaire, consultez Migrer le code de récupération agentique vers la dernière version.
Une source de connaissances spécifie le contenu utilisé pour la récupération agentique. Il encapsule un index de recherche rempli par des données externes, ou il s'agit d'une connexion directe à une cible distante telle que Bing ou SharePoint interrogée directement. Une source de connaissances est une définition requise dans une base de connaissances.
Créez une source de connaissances en tant que ressource de niveau supérieur sur votre service de recherche. Chaque source de connaissances pointe exactement vers une structure de données, soit un index de recherche qui répond aux critères de récupération agentique ou vers une ressource externe prise en charge.
Référencez une ou plusieurs sources de connaissances dans une base de connaissances. Dans un pipeline de récupération agentique, vous pouvez interroger plusieurs sources de connaissances dans une seule requête. Les sous-requêtes sont générées pour chaque source de connaissances. Les résultats principaux sont retournés dans la réponse de récupération.
Pour certaines sources de connaissances, vous pouvez utiliser une définition de source de connaissances pour générer un pipeline d’indexeur complet (source de données, ensemble de compétences, indexeur et index) qui fonctionne pour la récupération agentique. Au lieu de créer manuellement plusieurs objets, les informations de la source de connaissances sont utilisées pour générer tous les objets, y compris un index rempli, segmenté et pouvant faire l’objet d’une recherche.
Vérifiez que vous disposez d’au moins une source de connaissances avant de créer une base de connaissances. Vous trouverez la spécification complète des sources de connaissances et des bases de connaissances dans la référence de l’API REST.
Utilisation d’une source de connaissances
Chemin de création : créez d’abord une source de connaissances, puis créez une base de connaissances.
Chemin de suppression : mettez à jour ou supprimez des bases de connaissances pour supprimer des références à une source de connaissances, puis supprimez la source de connaissances en dernier.
Une source de connaissances, son index et la base de connaissances doivent toutes exister sur le même service de recherche. Le contenu externe est accessible via l'internet public (Bing) ou dans un tenant Microsoft (SharePoint à distance).
Sources de connaissances prises en charge
Vous pouvez créer les sources de connaissances suivantes :
| Type | Indexé ou distant |
|---|---|
"searchIndex" L’API encapsule un index existant. |
Indexé |
"azureBlob" L’API génère un pipeline d’indexeur qui extrait d’un blob container. |
Indexé |
"indexedOneLake" L’API génère un pipeline d’indexeur qui extrait depuis un lakehouse. |
Indexé |
"indexedSharePoint" API (aperçu) génère un pipeline d’indexeur qui extrait depuis un site SharePoint. |
Indexé |
"remoteSharePoint" API (préversion) récupère le contenu directement à partir de SharePoint. |
Télécommande |
"web" API récupère les données de base en temps réel à partir de Microsoft Bing. |
À distance |
Les sources de connaissances indexées pointent vers un index cible sur Recherche Azure AI. L’exécution de requête est locale dans le moteur de recherche de votre service de recherche. Les fonctionnalités de mot clé (recherche en texte intégral), de vecteur et de requête hybride sont utilisées pour récupérer des données à partir de sources de connaissances indexées.
Vous accédez aux sources de connaissances distantes au moment de la requête. Le moteur de récupération agentique appelle les API de récupération natives de la plateforme (Bing ou SharePoint API).
Tout le contenu récupéré, indexé ou distant, est extrait dans le pipeline de classement dans Recherche Azure AI où il est marqué pour pertinence, fusionné (en supposant plusieurs requêtes), reclassé et retourné dans la réponse de récupération.
Création de sources de connaissances
Créez des sources de connaissances en tant qu’objets autonomes. Ensuite, spécifiez-les dans une base de connaissances dans un tableau « knowledgeSources ».
Pour créer des objets sur un service de recherche, vous avez besoin d’autorisations Contributeur de service de recherche. Si vous utilisez une source de connaissances qui crée un pipeline d’indexeur, vous avez également besoin des autorisations de Contributeur aux données d’index de recherche pour charger un index. Vous pouvez également utiliser une clé d’administration d’API au lieu de rôles.
Utilisez le portail Azure, l’API REST ou un package Kit de développement logiciel (SDK) Azure pour créer une source de connaissances. Les liens suivants fournissent des instructions pour créer une source de connaissances :
- Comment créer une source de connaissances d’index de recherche (encapsule un index existant)
- Comment créer une source de connaissances blob (génère un pipeline d’indexeur)
- Création d’une source de connaissances OneLake (génère un pipeline d’indexeur)
- Comment créer une source de connaissances SharePoint (indexée) (génère un pipeline d’indexeur)
- Comment créer une source de connaissances SharePoint (distante) (requêtes SharePoint directement)
- Comment créer une ressource de source de connaissances web (se connecte au point de terminaison public de Bing)
Après avoir créé la source de connaissances, référencez-la dans une base de connaissances.
Utilisation de sources de connaissances
Vous pouvez contrôler explicitement l’utilisation de la source de connaissances en définissant alwaysQuery la définition de la source de connaissances ou en guidant les instructions utilisées lors de la planification des requêtes. Les instructions de direction font référence à des descriptions sur un index ou à des instructions de récupération explicites dans la source de connaissances, qui fournissent des conseils sur le moment où utiliser l’index. La planification des requêtes se produit lorsque vous utilisez un effort de raisonnement de récupération faible ou moyen à partir du LLM. Pour un effort de raisonnement minimal, toutes les sources de connaissances répertoriées dans la base de connaissances sont dans l’étendue de chaque requête. Pour les niveaux faibles et moyens, la base de connaissances et le LLM peuvent déterminer au moment de la requête quelles sources de connaissances pourraient fournir le meilleur corpus de recherche.
La logique de sélection de la source de connaissances est basée sur ces facteurs :
alwaysQueryest-il défini ? Si c’est le cas, la source de connaissances est toujours utilisée sur chaque requête.La
namesource de connaissances.L'index
description, en prenant comme hypothèse une base de connaissances indexée.Le
retrievalInstructionsspécifié dans l’action de récupération ou dans la définition de la base de connaissances fournit des conseils qui incluent ou excluent une source de connaissances. C’est similaire à une invite. Vous pouvez spécifier la concision, le ton et la mise en forme en tant qu’instruction de récupération.outputModed'une base de connaissances affecte également le résultat des requêtes et le contenu de la réponse.
Utiliser une approche de raisonnement basée sur la récupération pour gérer l'utilisation des LLM
Toutes les solutions ne bénéficient pas de la planification et de l’exécution des requêtes LLM. Si la simplicité et la vitesse l’emportent sur les avantages que procure la planification des requêtes LLM et l’ingénierie contextuelle, spécifiez un effort de raisonnement minimal pour empêcher le traitement LLM dans votre pipeline.
Pour les niveaux faible et moyen, le traitement LLM adopte une approche soit équilibrée, soit maximale, qui améliore la pertinence. Pour plus d’informations, consultez Définir l’effort de raisonnement de récupération.
Note
Si vous avez utilisé attemptFastPath dans la préversion précédente, cette approche est maintenant remplacée par retrievalReasoningEffort définie sur minimal.