Azure - Iq de foundry

Connectez-vous aux bases de connaissances Foundry IQ alimentées par Recherche Azure AI. Foundry IQ est une couche de connaissances managée qui fournit aux agents une prise en charge des autorisations, cité des réponses des données de votre organisation dans Azure, SharePoint, OneLake et le web.

Ce connecteur est disponible dans les produits et régions suivants :

Service	Classe	Régions
Copilot Studio	Norme	Toutes les régions Power Automate
Applications logiques	Norme	Toutes les régions Logic Apps
Power Apps	Norme	Toutes les régions Power Apps
Power Automate	Norme	Toutes les régions Power Automate

Contact
Nom	Microsoft
URL	https://support.microsoft.com/
Messagerie électronique	abapi@microsoft.com

Métadonnées du connecteur
Éditeur	Microsoft
Website	https://learn.microsoft.com/en-us/azure/search/
Politique de confidentialité	https://privacy.microsoft.com/en-us/privacystatement
Categories	AI

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :


Clé API	Fournissez une clé API pour accéder à votre service de recherche Foundry IQ.	Toutes les régions	Partageable
Authentification de certificat client	Fournissez Microsoft Entra ID informations d’identification à l’aide d’un certificat PFX et d’un mot de passe.	Toutes les régions	Partageable
Identité gérée	Créez une connexion à l’aide d’une identité managée.	LOGICAPPS uniquement	Partageable
Microsoft Entra ID intégré	Utilisez Microsoft Entra ID pour accéder à votre service de recherche Foundry IQ.	Toutes les régions	Impossible à partager
Service principal (application Microsoft Entra ID)	Utilisez une application Microsoft Entra ID pour accéder à votre service de recherche Foundry IQ.	Toutes les régions	Impossible à partager
Valeur par défaut [DÉCONSEILLÉE]	Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.	Toutes les régions	Impossible à partager

Clé API

ID d’authentification : apiKeyAuth

Applicable : Toutes les régions

Fournissez une clé API pour accéder à votre service de recherche Foundry IQ.

Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs

Nom	Catégorie	Description	Obligatoire
Point de terminaison du service de recherche IQ Foundry	string	Point de terminaison Recherche Azure AI	True
Clé API du service De recherche IQ Foundry	securestring	Clé API Recherche Azure AI	True

Authentification par certificat client

ID d’authentification : certOauth

Applicable : Toutes les régions

Fournissez Microsoft Entra ID informations d’identification à l’aide d’un certificat PFX et d’un mot de passe.

Nom	Catégorie	Description	Obligatoire
Point de terminaison du service de recherche IQ Foundry	string	Point de terminaison Recherche Azure AI	True
Locataire	string		True
ID du client	string	ID client de l’application Microsoft Entra ID
Secret du certificat client	clientCertificate	Secret de certificat client autorisé par cette application	True

Identité gérée

ID d’authentification : managedIdentityAuth

Applicable : LOGICAPPS uniquement

Créez une connexion à l’aide d’une identité managée.

Nom	Catégorie	Description	Obligatoire
Identité gérée	managedIdentity	Se connecter avec une identité managée	True
Point de terminaison du service de recherche IQ Foundry	string	Point de terminaison Recherche Azure AI	True

Microsoft Entra ID intégré

ID d’authentification : oauth

Applicable : Toutes les régions

Utilisez Microsoft Entra ID pour accéder à votre service de recherche Foundry IQ.

Ce n’est pas une connexion partageable. Si l’application Power est partagée avec un autre utilisateur, un autre utilisateur sera invité à créer explicitement une nouvelle connexion.

Nom	Catégorie	Description	Obligatoire
Point de terminaison du service de recherche IQ Foundry	string	Point de terminaison Recherche Azure AI	True

Service principal (application Microsoft Entra ID)

ID d’authentification : oauthSP

Applicable : Toutes les régions

Utilisez une application Microsoft Entra ID pour accéder à votre service de recherche Foundry IQ.

Ce n’est pas une connexion partageable. Si l’application Power est partagée avec un autre utilisateur, un autre utilisateur sera invité à créer explicitement une nouvelle connexion.

Nom	Catégorie	Description	Obligatoire
Point de terminaison du service de recherche IQ Foundry	string	Point de terminaison Recherche Azure AI	True
Locataire	string		True
ID du client	string		True
Clé secrète client	securestring		True

Valeur par défaut [DÉCONSEILLÉE]

Applicable : Toutes les régions

Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.

Ce n’est pas une connexion partageable. Si l’application Power est partagée avec un autre utilisateur, un autre utilisateur sera invité à créer explicitement une nouvelle connexion.

Nom	Catégorie	Description	Obligatoire
Point de terminaison du service de recherche IQ Foundry	string	Point de terminaison Recherche Azure AI	True
Clé API du service De recherche IQ Foundry	securestring	Clé API Recherche Azure AI	True

Limitations

Nom	Appels	Période de renouvellement
Appels d’API par connexion	5000	60 secondes

Actions

API De récupération de connaissances Foundry IQ (déconseillée) [DÉPRÉCIÉE]	Microsoft récupération de la base de connaissances Foundry IQ. Placez votre agent à l’aide de la base de connaissances Foundry IQ pour une récupération basée sur la consommation de haute qualité, en fournissant des réponses prenant en charge les autorisations. (deprecated)
Récupération des connaissances de l’IQ De foundry IQ MCP	Microsoft récupération de la base de connaissances Foundry IQ via le protocole MCP. Placez votre agent à l’aide de la base de connaissances Foundry IQ pour une récupération basée sur la consommation de haute qualité, en fournissant des réponses prenant en charge les autorisations.

API De récupération de connaissances Foundry IQ (déconseillée) [DÉPRÉCIÉE]

ID d’opération :: AzureAISearchKBRetrieve

Microsoft récupération de la base de connaissances Foundry IQ. Placez votre agent à l’aide de la base de connaissances Foundry IQ pour une récupération basée sur la consommation de haute qualité, en fournissant des réponses prenant en charge les autorisations. (deprecated)

Paramètres

Nom	Clé	Obligatoire	Type	Description
Nom de la base de connaissances	knowledgeBaseName	True	string	Nom de la base de connaissances Foundry IQ à interroger.
Version de l’API	api-version	True	string	Version de l’API pour le service de base de connaissances Recherche Azure AI.
Jeton d’autorisation source de requête	x-ms-query-source-authorization		string	Jeton utilisateur passé à Recherche Azure AI pour l’autorisation au niveau du document.
role	role		string	Rôle de l’expéditeur du message (par exemple, « utilisateur », « Assistant »).
type	type		string	Type du contenu (par exemple, « text »).
texte	text		string	Contenu texte du message.

Retours

Corps: RetrieveResponse

Récupération des connaissances de l’IQ De foundry IQ MCP

ID d’opération :: AzureAISearchKBRetrieveMcp

Microsoft récupération de la base de connaissances Foundry IQ via le protocole MCP. Placez votre agent à l’aide de la base de connaissances Foundry IQ pour une récupération basée sur la consommation de haute qualité, en fournissant des réponses prenant en charge les autorisations.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Nom de la base de connaissances	knowledgeBaseName	True	string	Nom de la base de connaissances Foundry IQ à interroger.
Version de l’API	api-version	True	string	Version de l’API pour le service de base de connaissances Recherche Azure AI.

Définitions

RetrieveResponse

Nom	Chemin d’accès	Type	Description
response	response	array of RetrieveResponseItem	Réponse de récupération contenant le contenu cité de la base de connaissances.
activity	activity	array of RetrieveActivity	Journal d’activité montrant la planification des requêtes, les appels d’index de recherche et les étapes de raisonnement.
references	references	array of RetrieveReference	Références de documents sources avec des scores et des métadonnées de pertinence.

RetrieveResponseItem

Nom	Chemin d’accès	Type	Description
contenu	content	array of object	Éléments de contenu dans la réponse.
type	content.type	string	Type de contenu (par exemple, « text »).
texte	content.text	string	Contenu de texte récupéré avec les résultats cités de la base de connaissances.

RetrieveActivity

Nom	Chemin d’accès	Type	Description
type	type	string	Type d’activité (par exemple, « modelQueryPlanning », « searchIndex », « agenticReasoning »).
ID	id	integer	Identificateur de l’étape d’activité.
knowledgeSourceName	knowledgeSourceName	string	Nom de la source de connaissances interrogée.
machines virtuelles écoulées	elapsedMs	integer	Temps écoulé en millisecondes pour cette étape d’activité.
inputTokens	inputTokens	integer	Nombre de jetons d’entrée utilisés dans l’étape de planification des requêtes de modèle.
outputTokens	outputTokens	integer	Nombre de jetons de sortie générés à l’étape de planification des requêtes de modèle.
queryTime	queryTime	date-time	Horodatage lorsque la requête d’index de recherche a été exécutée.
count	count	integer	Nombre de résultats retournés par la requête d’index de recherche.
searchIndexArguments	searchIndexArguments	SearchIndexArguments	Arguments passés à la requête d’index de recherche.
kind	retrievalReasoningEffort.kind	string	Le niveau d’effort de raisonnement appliqué (par exemple, « faible », « moyen », « élevé »).
reasoningTokens	reasoningTokens	integer	Nombre de jetons utilisés dans l’étape de raisonnement agentique.

SearchIndexArguments

Arguments passés à la requête d’index de recherche.

Nom	Chemin d’accès	Type	Description
search	search	string	Texte de la requête de recherche envoyé à l’index.
filter	filter	string	Expression de filtre OData appliquée à la requête de recherche.
sourceDataFields	sourceDataFields	array of object	Champs de données sources demandés à partir de l’index de recherche.
name	sourceDataFields.name	string	Nom du champ de données source.
champsDeRecherche	searchFields	array of string	Champs spécifiques à rechercher dans l’index.
semanticConfigurationName	semanticConfigurationName	string	Nom de la configuration sémantique utilisée pour le classement.

RetrieveReference

Nom	Chemin d’accès	Type	Description
type	type	string	Type de référence (par exemple, « searchIndex »).
ID	id	string	Identificateur de référence.
activitySource	activitySource	integer	Identificateur de l’étape d’activité qui a produit cette référence.
sourceData	sourceData	object	Données sources supplémentaires associées à la référence.
docKey	docKey	string	Clé de document source dans l’index de recherche.
title	title	string	Titre du document source référencé.
rerankerScore	rerankerScore	float	Score de pertinence de reclassement sémantique pour cette référence.