Azure – IQ de fundimento

Conecte-se às bases de dados de conhecimento do IQ do Foundry alimentadas por Pesquisa de IA do Azure . O IQ do Foundry é uma camada de conhecimento gerenciada que fornece aos agentes respostas com reconhecimento de permissão e citadas dos dados da sua organização em Azure, SharePoint, OneLake e na Web.

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

Serviço	Class	Regions
Copilot Studio	Standard	Todas as regiões do Power Automate
Aplicativos Lógicos	Standard	Todas as regiões de Aplicativos Lógicos
Power Apps	Standard	Todas as regiões do Power Apps
Power Automate	Standard	Todas as regiões do Power Automate

Contato
Nome	Microsoft
URL	https://support.microsoft.com/
Email	abapi@microsoft.com

Metadados do conector
Publicador	Microsoft
Site	https://learn.microsoft.com/en-us/azure/search/
Política de privacidade	https://privacy.microsoft.com/en-us/privacystatement
Categories	IA

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:


Chave de API	Forneça uma chave de API para acessar o serviço de pesquisa do IQ do Foundry.	Todas as regiões	Compartilhável
Autenticação de Certificado do Cliente	Forneça Microsoft Entra ID credenciais usando um certificado PFX e uma senha.	Todas as regiões	Compartilhável
Identidade Gerenciada	Crie uma conexão usando uma identidade gerenciada.	Somente LOGICAPPS	Compartilhável
Microsoft Entra ID Integrado	Use Microsoft Entra ID para acessar o serviço de pesquisa do IQ do Foundry.	Todas as regiões	Não compartilhável
Entidade de serviço (aplicativo Microsoft Entra ID)	Use um aplicativo de Microsoft Entra ID para acessar o serviço de pesquisa do IQ do Foundry.	Todas as regiões	Não compartilhável
Padrão [PRETERIDO]	Essa 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 autenticação: apiKeyAuth

Aplicável: todas as regiões

Forneça uma chave de API para acessar o serviço de pesquisa do IQ do Foundry.

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Descrição	Obrigatório
Ponto de extremidade do serviço de pesquisa de IQ de pesquisa	cadeia	O ponto de extremidade de Pesquisa de IA do Azure	True
Chave de API do Serviço de Pesquisa de IQ do Foundry	secureString	A chave de API Pesquisa de IA do Azure	True

Autenticação do Certificado do Cliente

ID de autenticação: certOauth

Aplicável: todas as regiões

Forneça Microsoft Entra ID credenciais usando um certificado PFX e uma senha.

Nome	Tipo	Descrição	Obrigatório
Ponto de extremidade do serviço de pesquisa de IQ de pesquisa	cadeia	O ponto de extremidade de Pesquisa de IA do Azure	True
Tenant	cadeia		True
ID do cliente	cadeia	A ID do cliente do aplicativo Microsoft Entra ID
Segredo do certificado do cliente	clientCertificate	O segredo do certificado do cliente permitido por este aplicativo	True

Identidade Gerenciada

ID de autenticação: managedIdentityAuth

Aplicável: somente LOGICAPPS

Crie uma conexão usando uma identidade gerenciada.

Nome	Tipo	Descrição	Obrigatório
Identidade Gerenciada	managedIdentity	Fazer login com uma identidade gerenciada	True
Ponto de extremidade do serviço de pesquisa de IQ de pesquisa	cadeia	O ponto de extremidade de Pesquisa de IA do Azure	True

Integração com Microsoft Entra ID

ID de autenticação: oauth

Aplicável: todas as regiões

Use Microsoft Entra ID para acessar o serviço de pesquisa do IQ do Foundry.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Descrição	Obrigatório
Ponto de extremidade do serviço de pesquisa de IQ de pesquisa	cadeia	O ponto de extremidade de Pesquisa de IA do Azure	True

Service principal (aplicativo Microsoft Entra ID)

ID de autenticação: oauthSP

Aplicável: todas as regiões

Use um aplicativo de Microsoft Entra ID para acessar o serviço de pesquisa do IQ do Foundry.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Descrição	Obrigatório
Ponto de extremidade do serviço de pesquisa de IQ de pesquisa	cadeia	O ponto de extremidade de Pesquisa de IA do Azure	True
Tenant	cadeia		True
ID do cliente	cadeia		True
Segredo do Cliente	secureString		True

Padrão [PRETERIDO]

Aplicável: todas as regiões

Essa 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.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Descrição	Obrigatório
Ponto de extremidade do serviço de pesquisa de IQ de pesquisa	cadeia	O ponto de extremidade de Pesquisa de IA do Azure	True
Chave de API do Serviço de Pesquisa de IQ do Foundry	secureString	A chave de API Pesquisa de IA do Azure	True

Limitações

Nome	Chamadas	Período de renovação
Chamadas à API por conexão	5000	60 segundos

Ações

API de Recuperação de Conhecimento do IQ do Foundry (preterida) [PRETERIDA]	Microsoft recuperação da base de dados de conhecimento do IQ do Foundry. Aterrar seu agente usando a base de dados de conhecimento do IQ do Foundry para recuperação baseada em consumo de alta qualidade, fornecendo respostas com reconhecimento de permissão e citadas. (deprecated)
MCP de recuperação de conhecimento do IQ do Foundry	Microsoft recuperação da base de dados de conhecimento do IQ do Foundry por meio do protocolo MCP. Aterrar seu agente usando a base de dados de conhecimento do IQ do Foundry para recuperação baseada em consumo de alta qualidade, fornecendo respostas com reconhecimento de permissão e citadas.

API de Recuperação de Conhecimento do IQ do Foundry (preterida) [PRETERIDA]

ID da operação:: AzureAISearchKBRetrieve

Microsoft recuperação da base de dados de conhecimento do IQ do Foundry. Aterrar seu agente usando a base de dados de conhecimento do IQ do Foundry para recuperação baseada em consumo de alta qualidade, fornecendo respostas com reconhecimento de permissão e citadas. (deprecated)

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da base de dados de conhecimento	knowledgeBaseName	True	string	O nome da base de dados de conhecimento do IQ do Foundry a ser consultada.
Versão da API	api-version	True	string	Versão da API para o serviço da Base de Dados de Conhecimento Pesquisa de IA do Azure .
Token de autorização de origem de consulta	x-ms-query-source-authorization		string	Token de usuário passado para Pesquisa de IA do Azure para autorização no nível do documento.
função	role		string	A função do remetente da mensagem (por exemplo, 'user', 'assistant').
tipo	type		string	O tipo do conteúdo (por exemplo, 'text').
enviar SMS	text		string	O conteúdo de texto da mensagem.

Retornos

Corpo: RetrieveResponse

MCP de recuperação de conhecimento do IQ do Foundry

ID da operação:: AzureAISearchKBRetrieveMcp

Microsoft recuperação da base de dados de conhecimento do IQ do Foundry por meio do protocolo MCP. Aterrar seu agente usando a base de dados de conhecimento do IQ do Foundry para recuperação baseada em consumo de alta qualidade, fornecendo respostas com reconhecimento de permissão e citadas.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da base de dados de conhecimento	knowledgeBaseName	True	string	O nome da base de dados de conhecimento do IQ do Foundry a ser consultada.
Versão da API	api-version	True	string	Versão da API para o serviço da Base de Dados de Conhecimento Pesquisa de IA do Azure .

Definições

RetrieveResponse

Nome	Caminho	Tipo	Description
response	response	array of RetrieveResponseItem	A resposta de recuperação que contém o conteúdo citado da base de dados de conhecimento.
atividade	activity	array of RetrieveActivity	Log de atividades mostrando planejamento de consultas, chamadas de índice de pesquisa e etapas de raciocínio.
references	references	array of RetrieveReference	Referências de documento de origem com pontuações de relevância e metadados.

RetrieveResponseItem

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

RetrieveActivity

Nome	Caminho	Tipo	Description
tipo	type	string	O tipo de atividade (por exemplo, 'modelQueryPlanning', 'searchIndex', 'agenticReasoning').
id	id	integer	O identificador da etapa de atividade.
knowledgeSourceName	knowledgeSourceName	string	O nome da fonte de conhecimento consultada.
elapsedMs	elapsedMs	integer	Tempo decorrido em milissegundos para esta etapa de atividade.
inputTokens	inputTokens	integer	Número de tokens de entrada usados na etapa de planejamento de consulta de modelo.
outputTokens	outputTokens	integer	Número de tokens de saída produzidos na etapa de planejamento de consulta de modelo.
queryTime	queryTime	date-time	O carimbo de data/hora quando a consulta de índice de pesquisa foi executada.
count	count	integer	O número de resultados retornados da consulta de índice de pesquisa.
searchIndexArguments	searchIndexArguments	SearchIndexArguments	Os argumentos passados para a consulta de índice de pesquisa.
variante	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 agente.

SearchIndexArguments

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

Nome	Caminho	Tipo	Description
busca	search	string	O texto da consulta de pesquisa enviado para o índice.
filtro	filter	string	A expressão de filtro OData aplicada à consulta de pesquisa.
sourceDataFields	sourceDataFields	array of object	Os campos de dados de origem solicitados do índice de pesquisa.
name	sourceDataFields.name	string	O nome do campo de dados de origem.
camposDeBusca	searchFields	array of string	Os campos específicos a serem pesquisados no índice.
semanticConfigurationName	semanticConfigurationName	string	O nome da configuração semântica usada para classificação.

RetrieveReference

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