Azure - Foundry IQ (versión preliminar)

Conéctese a las bases de conocimiento de Foundry IQ con tecnología de Búsqueda de Azure AI. Foundry IQ es una capa de conocimiento administrada que proporciona a los agentes respuestas con permisos, citadas de los datos de la organización en Azure, SharePoint, OneLake y la web. Este conector está en versión preliminar.

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Estándar	Todas las regiones de Power Automate
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps
Power Apps	Estándar	Todas las regiones de Power Apps
Power Automate	Estándar	Todas las regiones de Power Automate

Contacto
Nombre	Microsoft
URL	https://support.microsoft.com/
Correo Electrónico	[email protected]

Metadatos del conector
Publicador	Microsoft
Sitio web	https://mms.heiai.top/en-us/azure/search/
Directiva de privacidad	https://privacy.microsoft.com/en-us/privacystatement
Categories	AI

Creación de una conexión

El conector admite los siguientes tipos de autenticación:


Clave de API	Proporcione una clave de API para acceder al servicio de búsqueda Foundry IQ.	Todas las regiones	Compartible
Autenticación de certificado de cliente	Proporcione Microsoft Entra ID credenciales mediante un certificado PFX y una contraseña.	Todas las regiones	Compartible
Identidad administrada de Logic Apps	Cree una conexión mediante una identidad administrada de Logic Apps.	Solo LOGICAPPS	Compartible
Microsoft Entra ID Integrado	Use Microsoft Entra ID para acceder al servicio de búsqueda Foundry IQ.	Todas las regiones	No se puede compartir
Principal de servicio (aplicación Microsoft Entra ID)	Use una aplicación de Microsoft Entra ID para acceder al servicio de búsqueda Foundry IQ.	Todas las regiones	No se puede compartir
Valor predeterminado [EN DESUSO]	Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.	Todas las regiones	No se puede compartir

Clave de API

Identificador de autenticación: apiKeyAuth

Aplicable: Todas las regiones

Proporcione una clave de API para acceder al servicio de búsqueda Foundry IQ.

Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs

Nombre	Tipo	Descripción	Obligatorio
Foundry IQ Search Service Endpoint	string	Punto de conexión de Búsqueda de Azure AI	Verdadero
Clave de API de Foundry IQ Search Service	securestring	Clave de API de Búsqueda de Azure AI	Verdadero

Autenticación de cliente mediante certificado

Identificador de autenticación: certOauth

Aplicable: Todas las regiones

Proporcione Microsoft Entra ID credenciales mediante un certificado PFX y una contraseña.

Nombre	Tipo	Descripción	Obligatorio
Foundry IQ Search Service Endpoint	string	Punto de conexión de Búsqueda de Azure AI	Verdadero
Inquilino	string		Verdadero
Id de cliente	string	Identificador de cliente de la aplicación de Microsoft Entra ID
Secreto de certificado de cliente	Certificado de cliente	Secreto de certificado de cliente permitido por esta aplicación	Verdadero

Identidad administrada de Logic Apps

Identificador de autenticación: managedIdentityAuth

Aplicable: SOLO LOGICAPPS

Cree una conexión mediante una identidad administrada de Logic Apps.

Nombre	Tipo	Descripción	Obligatorio
Identidad administrada de Logic Apps	managedIdentity	Inicio de sesión con una identidad administrada de Logic Apps	Verdadero
Foundry IQ Search Service Endpoint	string	Punto de conexión de Búsqueda de Azure AI	Verdadero

Microsoft Entra ID integrado

Identificador de autenticación: oauth

Aplicable: Todas las regiones

Use Microsoft Entra ID para acceder al servicio de búsqueda Foundry IQ.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Descripción	Obligatorio
Foundry IQ Search Service Endpoint	string	Punto de conexión de Búsqueda de Azure AI	Verdadero

Principal de servicio (aplicación de Microsoft Entra ID)

Identificador de autenticación: oauthSP

Aplicable: Todas las regiones

Use una aplicación de Microsoft Entra ID para acceder al servicio de búsqueda Foundry IQ.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Descripción	Obligatorio
Foundry IQ Search Service Endpoint	string	Punto de conexión de Búsqueda de Azure AI	Verdadero
Inquilino	string		Verdadero
Id de cliente	string		Verdadero
Secreto del cliente	securestring		Verdadero

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Descripción	Obligatorio
Foundry IQ Search Service Endpoint	string	Punto de conexión de Búsqueda de Azure AI	Verdadero
Clave de API de Foundry IQ Search Service	securestring	Clave de API de Búsqueda de Azure AI	Verdadero

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	5000	60 segundos

Acciones

Recuperación de conocimiento de Foundry IQ (API)	Microsoft recuperación de la base de conocimiento de Foundry IQ. Base de conocimiento de Foundry IQ para la recuperación basada en consumo y alta calidad, entregando respuestas con reconocimiento de permisos, citadas.
Recuperación de conocimiento de Foundry IQ (MCP)	Microsoft recuperación de la base de conocimiento de Foundry IQ a través del protocolo MCP. Base de conocimiento de Foundry IQ para la recuperación basada en consumo y alta calidad, entregando respuestas con reconocimiento de permisos, citadas.

Recuperación de conocimiento de Foundry IQ (API)

Id. de la operación:: AzureAISearchKBRetrieve

Microsoft recuperación de la base de conocimiento de Foundry IQ. Base de conocimiento de Foundry IQ para la recuperación basada en consumo y alta calidad, entregando respuestas con reconocimiento de permisos, citadas.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre de la base de conocimiento	knowledgeBaseName	True	string	Nombre de la base de conocimiento foundry IQ que se va a consultar.
Versión de la API	api-version	True	string	Versión de la API del servicio Búsqueda de Azure AI Knowledge Base.
Token de autorización de origen de consulta	x-ms-query-source-authorization		string	Token de usuario pasado a Búsqueda de Azure AI para la autorización de nivel de documento.
role	role		string	Rol del remitente del mensaje (por ejemplo, "usuario", "asistente").
type	type		string	Tipo del contenido (por ejemplo, "texto").
Mensaje de texto	text		string	Contenido de texto del mensaje.

Devoluciones

Body: RetrieveResponse

Recuperación de conocimiento de Foundry IQ (MCP)

Id. de la operación:: AzureAISearchKBRetrieveMcp

Microsoft recuperación de la base de conocimiento de Foundry IQ a través del protocolo MCP. Base de conocimiento de Foundry IQ para la recuperación basada en consumo y alta calidad, entregando respuestas con reconocimiento de permisos, citadas.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre de la base de conocimiento	knowledgeBaseName	True	string	Nombre de la base de conocimiento foundry IQ que se va a consultar.
Versión de la API	api-version	True	string	Versión de la API del servicio Búsqueda de Azure AI Knowledge Base.
Token de autorización de origen de consulta	x-ms-query-source-authorization		string	Token de usuario pasado a Búsqueda de Azure AI para la autorización de nivel de documento.

Definiciones

RetrieveResponse

Nombre	Ruta de acceso	Tipo	Description
response	response	array of RetrieveResponseItem	Respuesta de recuperación que contiene contenido citado de la base de conocimiento.
activity	activity	array of RetrieveActivity	Registro de actividad que muestra el planeamiento de consultas, las llamadas de índice de búsqueda y los pasos de razonamiento.
references	references	array of RetrieveReference	Referencias de documento de origen con puntuaciones de relevancia y metadatos.

RetrieveResponseItem

Nombre	Ruta de acceso	Tipo	Description
contenido	content	array of object	Elementos de contenido de la respuesta.
type	content.type	string	Tipo de contenido (por ejemplo, "texto").
Mensaje de texto	content.text	string	Contenido de texto recuperado con los resultados citados de la base de conocimiento.

RetrieveActivity

Nombre	Ruta de acceso	Tipo	Description
type	type	string	El tipo de actividad (por ejemplo, "modelQueryPlanning", "searchIndex", "agenticReasoning").
id	id	integer	Identificador del paso de actividad.
knowledgeSourceName	knowledgeSourceName	string	Nombre del origen de conocimiento consultado.
elapsedMs	elapsedMs	integer	Tiempo transcurrido en milisegundos para este paso de actividad.
inputTokens	inputTokens	integer	Número de tokens de entrada usados en el paso de planeamiento de consultas del modelo.
outputTokens	outputTokens	integer	Número de tokens de salida generados en el paso de planeamiento de consultas del modelo.
queryTime	queryTime	date-time	Marca de tiempo cuando se ejecutó la consulta de índice de búsqueda.
count	count	integer	Número de resultados devueltos de la consulta de índice de búsqueda.
searchIndexArguments	searchIndexArguments	SearchIndexArguments	Argumentos pasados a la consulta de índice de búsqueda.
amable	retrievalReasoningEffort.kind	string	Nivel de esfuerzo de razonamiento aplicado (por ejemplo, "bajo", "medio", "alto").
razonamientoTokens	reasoningTokens	integer	Número de tokens usados en el paso de razonamiento agente.

SearchIndexArguments

Argumentos pasados a la consulta de índice de búsqueda.

Nombre	Ruta de acceso	Tipo	Description
search	search	string	Texto de consulta de búsqueda enviado al índice.
filter	filter	string	Expresión de filtro de OData aplicada a la consulta de búsqueda.
sourceDataFields	sourceDataFields	array of object	Campos de datos de origen solicitados desde el índice de búsqueda.
name	sourceDataFields.name	string	Nombre del campo de datos de origen.
Campos de búsqueda	searchFields	array of string	Campos específicos que se van a buscar en el índice.
semanticConfigurationName	semanticConfigurationName	string	Nombre de la configuración semántica utilizada para la clasificación.

RetrieveReference

Nombre	Ruta de acceso	Tipo	Description
type	type	string	Tipo de referencia (por ejemplo, "searchIndex").
id	id	string	Identificador de referencia.
activitySource	activitySource	integer	Identificador del paso de actividad que generó esta referencia.
sourceData	sourceData	object	Datos de origen adicionales asociados a la referencia.
docKey	docKey	string	Clave del documento de origen en el índice de búsqueda.
title	title	string	Título del documento de origen al que se hace referencia.
rerankerScore	rerankerScore	float	Puntuación de relevancia del reranker semántico para esta referencia.