Azure - Foundry IQ (Preview)

Connect to Foundry IQ knowledge bases powered by Azure AI Search. Foundry IQ is a managed knowledge layer that provides agents with permission-aware, cited responses from your organization's data across Azure, SharePoint, OneLake, and the web. This connector is in preview.

This connector is available in the following products and regions:

Service	Class	Regions
Copilot Studio	Standard	All Power Automate regions
Logic Apps	Standard	All Logic Apps regions
Power Apps	Standard	All Power Apps regions
Power Automate	Standard	All Power Automate regions

Contact
Name	Microsoft
URL	https://support.microsoft.com/
Email	abapi@microsoft.com

Connector Metadata
Publisher	Microsoft
Website	https://learn.microsoft.com/en-us/azure/search/
Privacy policy	https://privacy.microsoft.com/en-us/privacystatement
Categories	AI

Creating a connection

The connector supports the following authentication types:


API key	Provide an API key to access your Foundry IQ search service.	All regions	Shareable
Client Certificate Auth	Provide Microsoft Entra ID credentials using a PFX certificate and password.	All regions	Shareable
Logic Apps Managed Identity	Create a connection using a Logic Apps managed identity.	LOGICAPPS only	Shareable
Microsoft Entra ID Integrated	Use Microsoft Entra ID to access your Foundry IQ search service.	All regions	Not shareable
Service principal (Microsoft Entra ID application)	Use a Microsoft Entra ID application to access your Foundry IQ search service.	All regions	Not shareable
Default [DEPRECATED]	This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.	All regions	Not shareable

API key

Auth ID: apiKeyAuth

Applicable: All regions

Provide an API key to access your Foundry IQ search service.

This is shareable connection. If the power app is shared with another user, connection is shared as well. For more information, please see the Connectors overview for canvas apps - Power Apps | Microsoft Docs

Name	Type	Description	Required
Foundry IQ Search Service Endpoint	string	The Azure AI Search Endpoint	True
Foundry IQ Search Service API Key	securestring	The Azure AI Search API key	True

Client Certificate Auth

Auth ID: certOauth

Applicable: All regions

Provide Microsoft Entra ID credentials using a PFX certificate and password.

Name	Type	Description	Required
Foundry IQ Search Service Endpoint	string	The Azure AI Search Endpoint	True
Tenant	string		True
Client ID	string	The client ID of the Microsoft Entra ID application
Client certificate secret	clientCertificate	The client certificate secret allowed by this application	True

Logic Apps Managed Identity

Auth ID: managedIdentityAuth

Applicable: LOGICAPPS only

Create a connection using a Logic Apps managed identity.

Name	Type	Description	Required
Logic Apps Managed Identity	managedIdentity	Sign in with a Logic Apps managed identity	True
Foundry IQ Search Service Endpoint	string	The Azure AI Search Endpoint	True

Microsoft Entra ID Integrated

Auth ID: oauth

Applicable: All regions

Use Microsoft Entra ID to access your Foundry IQ search service.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
Foundry IQ Search Service Endpoint	string	The Azure AI Search Endpoint	True

Service principal (Microsoft Entra ID application)

Auth ID: oauthSP

Applicable: All regions

Use a Microsoft Entra ID application to access your Foundry IQ search service.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
Foundry IQ Search Service Endpoint	string	The Azure AI Search Endpoint	True
Tenant	string		True
Client ID	string		True
Client Secret	securestring		True

Default [DEPRECATED]

Applicable: All regions

This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
Foundry IQ Search Service Endpoint	string	The Azure AI Search Endpoint	True
Foundry IQ Search Service API Key	securestring	The Azure AI Search API key	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	5000	60 seconds

Actions

Foundry IQ Knowledge Retrieval (API)	Microsoft Foundry IQ knowledge base retrieval. Ground your agent using the Foundry IQ knowledge base for high-quality, consumption-based retrieval, delivering permission-aware, cited responses.
Foundry IQ Knowledge Retrieval (MCP)	Microsoft Foundry IQ Knowledge base retrieval via MCP protocol. Ground your agent using the Foundry IQ knowledge base for high-quality, consumption-based retrieval, delivering permission-aware, cited responses.

Foundry IQ Knowledge Retrieval (API)

Operation ID:: AzureAISearchKBRetrieve

Microsoft Foundry IQ knowledge base retrieval. Ground your agent using the Foundry IQ knowledge base for high-quality, consumption-based retrieval, delivering permission-aware, cited responses.

Parameters

Name	Key	Required	Type	Description
Knowledge Base Name	knowledgeBaseName	True	string	The name of the Foundry IQ knowledge base to query.
API Version	api-version	True	string	API version for the Azure AI Search Knowledge Base service.
Query Source Authorization Token	x-ms-query-source-authorization		string	User token passed to Azure AI Search for document-level authorization.
role	role		string	The role of the sender of the message (e.g., 'user', 'assistant').
type	type		string	The type of the content (e.g., 'text').
text	text		string	The text content of the message.

Returns

Body: RetrieveResponse

Foundry IQ Knowledge Retrieval (MCP)

Operation ID:: AzureAISearchKBRetrieveMcp

Microsoft Foundry IQ Knowledge base retrieval via MCP protocol. Ground your agent using the Foundry IQ knowledge base for high-quality, consumption-based retrieval, delivering permission-aware, cited responses.

Parameters

Name	Key	Required	Type	Description
Knowledge Base Name	knowledgeBaseName	True	string	The name of the Foundry IQ knowledge base to query.
API Version	api-version	True	string	API version for the Azure AI Search Knowledge Base service.
Query Source Authorization Token	x-ms-query-source-authorization		string	User token passed to Azure AI Search for document-level authorization.

Definitions

RetrieveResponse

Name	Path	Type	Description
response	response	array of RetrieveResponseItem	The retrieval response containing cited content from the knowledge base.
activity	activity	array of RetrieveActivity	Activity log showing query planning, search index calls, and reasoning steps.
references	references	array of RetrieveReference	Source document references with relevance scores and metadata.

RetrieveResponseItem

Name	Path	Type	Description
content	content	array of object	The content items in the response.
type	content.type	string	The type of content (e.g., 'text').
text	content.text	string	The retrieved text content with cited results from the knowledge base.

RetrieveActivity

Name	Path	Type	Description
type	type	string	The activity type (e.g., 'modelQueryPlanning', 'searchIndex', 'agenticReasoning').
id	id	integer	The activity step identifier.
knowledgeSourceName	knowledgeSourceName	string	The name of the knowledge source queried.
elapsedMs	elapsedMs	integer	Time elapsed in milliseconds for this activity step.
inputTokens	inputTokens	integer	Number of input tokens used in the model query planning step.
outputTokens	outputTokens	integer	Number of output tokens produced in the model query planning step.
queryTime	queryTime	date-time	The timestamp when the search index query was executed.
count	count	integer	The number of results returned from the search index query.
searchIndexArguments	searchIndexArguments	SearchIndexArguments	The arguments passed to the search index query.
kind	retrievalReasoningEffort.kind	string	The level of reasoning effort applied (e.g., 'low', 'medium', 'high').
reasoningTokens	reasoningTokens	integer	Number of tokens used in the agentic reasoning step.

SearchIndexArguments

The arguments passed to the search index query.

Name	Path	Type	Description
search	search	string	The search query text sent to the index.
filter	filter	string	The OData filter expression applied to the search query.
sourceDataFields	sourceDataFields	array of object	The source data fields requested from the search index.
name	sourceDataFields.name	string	The name of the source data field.
searchFields	searchFields	array of string	The specific fields to search within the index.
semanticConfigurationName	semanticConfigurationName	string	The name of the semantic configuration used for ranking.

RetrieveReference

Name	Path	Type	Description
type	type	string	The reference type (e.g., 'searchIndex').
id	id	string	The reference identifier.
activitySource	activitySource	integer	The activity step identifier that produced this reference.
sourceData	sourceData	object	Additional source data associated with the reference.
docKey	docKey	string	The source document key in the search index.
title	title	string	The title of the referenced source document.
rerankerScore	rerankerScore	float	The semantic reranker relevance score for this reference.