Azure - Foundry IQ

Ligue-se às bases de conhecimento Foundry IQ alimentadas pelo Pesquisa de IA do Azure. O Foundry IQ é uma camada de conhecimento gerida que fornece aos agentes respostas citadas e conscientes de permissões, provenientes dos dados da sua organização no Azure, SharePoint, OneLake e na web.

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Standard	Todas as Power Automate regiões
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps
Power Apps	Standard	Todas as Power Apps regiões
Power Automate	Standard	Todas as Power Automate regiões

Entrar em contato
Nome	Microsoft
URL	https://support.microsoft.com/
Email	abapi@microsoft.com

Metadados do conector
Editor	Microsoft
Sítio Web	https://learn.microsoft.com/en-us/azure/search/
Política de privacidade	https://privacy.microsoft.com/en-us/privacystatement
Categorias	IA

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:


Chave de API	Forneça uma chave API para aceder ao seu serviço de pesquisa Foundry IQ.	Todas as regiões	Compartilhável
Autenticação de certificado de cliente	Forneça credenciais do Microsoft Entra ID usando um certificado PFX e uma palavra-passe.	Todas as regiões	Compartilhável
Identidade Gerenciada	Crie uma ligação usando uma identidade gerida.	Apenas LOGICAPPS	Compartilhável
Microsoft Entra ID Integrado	Use o Microsoft Entra ID para aceder ao seu serviço de pesquisa Foundry IQ.	Todas as regiões	Não compartilhável
Entidade de serviço (aplicativo Microsoft Entra ID)	Use uma aplicação Microsoft Entra ID para aceder ao seu serviço de pesquisa Foundry IQ.	Todas as regiões	Não compartilhável
Padrão [DEPRECATED]	Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.	Todas as regiões	Não compartilhável

chave de API

ID de Auth: apiKeyAuth

Aplicável: Todas as regiões

Forneça uma chave API para aceder ao seu serviço de pesquisa Foundry IQ.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome	Tipo	Descrição	Obrigatório
Endpoint do Serviço de Pesquisa Foundry IQ	cadeia (de caracteres)	O Pesquisa de IA do Azure Endpoint	True
Chave API do Serviço de Pesquisa Foundry IQ	securestring	A chave API do Pesquisa de IA do Azure	True

Autenticação de Certificados de Cliente

ID de autenticação: certOauth

Aplicável: Todas as regiões

Forneça credenciais do Microsoft Entra ID usando um certificado PFX e uma palavra-passe.

Nome	Tipo	Descrição	Obrigatório
Endpoint do Serviço de Pesquisa Foundry IQ	cadeia (de caracteres)	O Pesquisa de IA do Azure Endpoint	True
Inquilino	cadeia (de caracteres)		True
ID de Cliente	cadeia (de caracteres)	O ID do cliente da aplicação Microsoft Entra ID
Segredo do certificado do cliente	certificado do cliente	O segredo do certificado do cliente permitido por este aplicativo	True

Identidade gerenciada

ID de autenticação: managedIdentityAuth

Aplicável: apenas LOGICAPPS

Crie uma ligação usando uma identidade gerida.

Nome	Tipo	Descrição	Obrigatório
Identidade gerenciada	managedIdentity	Iniciar sessão com uma identidade gerida	True
Endpoint do Serviço de Pesquisa Foundry IQ	cadeia (de caracteres)	O Pesquisa de IA do Azure Endpoint	True

Microsoft Entra ID Integrado

ID de autenticação: oauth

Aplicável: Todas as regiões

Use o Microsoft Entra ID para aceder ao seu serviço de pesquisa Foundry IQ.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Descrição	Obrigatório
Endpoint do Serviço de Pesquisa Foundry IQ	cadeia (de caracteres)	O Pesquisa de IA do Azure Endpoint	True

Principal de serviço (aplicativo Microsoft Entra ID)

ID de autenticação: oauthSP

Aplicável: Todas as regiões

Use uma aplicação Microsoft Entra ID para aceder ao seu serviço de pesquisa Foundry IQ.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Descrição	Obrigatório
Endpoint do Serviço de Pesquisa Foundry IQ	cadeia (de caracteres)	O Pesquisa de IA do Azure Endpoint	True
Inquilino	cadeia (de caracteres)		True
ID de Cliente	cadeia (de caracteres)		True
Segredo do Cliente	securestring		True

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Descrição	Obrigatório
Endpoint do Serviço de Pesquisa Foundry IQ	cadeia (de caracteres)	O Pesquisa de IA do Azure Endpoint	True
Chave API do Serviço de Pesquisa Foundry IQ	securestring	A chave API do Pesquisa de IA do Azure	True

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	5000	60 segundos

Ações

API de Recuperação de Conhecimento Foundry IQ (obsoleta) [DESCONTINUADA]	Recuperação da base de conhecimento IQ da Microsoft Foundry. Baseie o seu agente na base de conhecimento Foundry IQ para uma recuperação de alta qualidade, baseada no consumo, fornecendo respostas citadas e conscientes de permissão. (deprecated)
Foundry IQ Knowledge Retrieval MCP	Recuperação da base de conhecimento do Microsoft Foundry IQ via protocolo MCP. Baseie o seu agente na base de conhecimento Foundry IQ para uma recuperação de alta qualidade, baseada no consumo, fornecendo respostas citadas e conscientes de permissão.

API de Recuperação de Conhecimento Foundry IQ (obsoleta) [DESCONTINUADA]

ID da Operação:: AzureAISearchKBRetrieve

Recuperação da base de conhecimento IQ da Microsoft Foundry. Baseie o seu agente na base de conhecimento Foundry IQ para uma recuperação de alta qualidade, baseada no consumo, fornecendo respostas citadas e conscientes de permissão. (deprecated)

Parâmetros

Name	Chave	Obrigatório	Tipo	Descrição
Nome da Base de Conhecimento	knowledgeBaseName	True	string	O nome da base de conhecimento de QI da Foundry para fazer consultas.
Versão da API	api-version	True	string	Versão da API para o serviço Pesquisa de IA do Azure Knowledge Base.
Consultar Token de Autorização de Origem	x-ms-query-source-authorization		string	Token de utilizador passado para o Pesquisa de IA do Azure para autorização ao nível do documento.
função	role		string	O papel do remetente da mensagem (por exemplo, 'usuário', 'assistente').
tipo	type		string	O tipo de conteúdo (por exemplo, 'texto').
enviar SMS	text		string	O conteúdo de texto da mensagem.

Devoluções

Body: RetrieveResponse

Foundry IQ Knowledge Retrieval MCP

ID da Operação:: AzureAISearchKBRetrieveMcp

Recuperação da base de conhecimento do Microsoft Foundry IQ via protocolo MCP. Baseie o seu agente na base de conhecimento Foundry IQ para uma recuperação de alta qualidade, baseada no consumo, fornecendo respostas citadas e conscientes de permissão.

Parâmetros

Name	Chave	Obrigatório	Tipo	Descrição
Nome da Base de Conhecimento	knowledgeBaseName	True	string	O nome da base de conhecimento de QI da Foundry para fazer consultas.
Versão da API	api-version	True	string	Versão da API para o serviço Pesquisa de IA do Azure Knowledge Base.

Definições

RetrieveResponse

Name	Caminho	Tipo	Descrição
response	response	array of RetrieveResponseItem	A resposta de recuperação contendo conteúdo citado da base de conhecimento.
actividade	activity	array of RetrieveActivity	Registo de atividades que mostra o planeamento da consulta, chamadas ao índice de pesquisa e passos de raciocínio.
references	references	array of RetrieveReference	Referências de documentos de origem com pontuações de relevância e metadados.

RecuperarRespostaItem

Name	Caminho	Tipo	Descrição
conteúdo	content	array of object	Os itens de conteúdo na resposta.
tipo	content.type	string	O tipo de conteúdo (por exemplo, 'texto').
enviar SMS	content.text	string	O texto recuperado com os resultados citados da base de conhecimento.

RecuperarAtividade

Name	Caminho	Tipo	Descrição
tipo	type	string	O tipo de atividade (por exemplo, 'modelQueryPlanning', 'searchIndex', 'agenticReasoning').
id	id	integer	O identificador de passo de atividade.
conhecimentoNomeFonte	knowledgeSourceName	string	O nome da fonte de conhecimento consultada.
elapsedMs	elapsedMs	integer	O tempo passou em milissegundos para esta etapa da atividade.
inputTokens	inputTokens	integer	Número de tokens de entrada usados na etapa de planeamento da consulta do modelo.
outputTokens	outputTokens	integer	Número de tokens de saída produzidos na etapa de planeamento de consultas do modelo.
queryTime	queryTime	date-time	O carimbo temporal em que a consulta ao índice de pesquisa foi executada.
count	count	integer	O número de resultados devolvidos da consulta do índice de pesquisa.
SearchIndexArguments	searchIndexArguments	SearchIndexArguments	Os argumentos passaram para a consulta de índice de pesquisa.
kind	retrievalReasoningEffort.kind	string	O nível de esforço de raciocínio aplicado (por exemplo, 'baixo', 'médio', 'alto').
reasoningTokens	reasoningTokens	integer	Número de tokens usados na etapa de raciocínio agentivo.

SearchIndexArguments

Os argumentos passaram para a consulta de índice de pesquisa.

Name	Caminho	Tipo	Descrição
pesquisa	search	string	O texto da consulta de pesquisa enviado para o índice.
filtro	filter	string	A expressão do filtro OData aplicada-se à consulta de pesquisa.
CampoFonteDataFields	sourceDataFields	array of object	Os campos de dados de origem solicitados ao índice de pesquisa.
name	sourceDataFields.name	string	O nome do campo de dados de origem.
camposDePesquisa	searchFields	array of string	Os campos específicos a pesquisar dentro do índice.
semanticConfigurationName	semanticConfigurationName	string	O nome da configuração semântica usada para a classificação.

RetrieveReference

Name	Caminho	Tipo	Descrição
tipo	type	string	O tipo de referência (por exemplo, 'searchIndex').
id	id	string	O identificador de referência.
atividadeFonte	activitySource	integer	O identificador do passo de atividade que produziu esta referência.
fonteDados	sourceData	object	Dados adicionais de origem associados à referência.
docKey	docKey	string	A chave do documento de origem no índice de pesquisa.
título	title	string	O título do documento fonte referenciado.
rerankerScore	rerankerScore	float	A pontuação de relevância do reclassificador semântico para esta referência.