Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Nota
Foundry IQ (Búsqueda de Azure AI) proporciona API directas de indexación y consulta junto con las API de origen de conocimiento y base de conocimiento de nivel superior para la recuperación administrada. Use el portal de Azure, las API REST o SDK de Azure para configurar estas funcionalidades o conectar agentes a las bases de conocimiento en el portal de Microsoft Foundry.
Important
Las características o funcionalidades marcadas (versión preliminar) de este artículo están en versión preliminar pública y están sujetas a los Términos de uso complementarios para las versiones preliminares de Microsoft Azure.
Para obtener los términos de versión preliminar específicos de Foundry IQ (Búsqueda de Azure AI), consulte Funcionalidad de versión preliminar.
Un origen de conocimiento es un recurso de nivel superior en el servicio Foundry IQ (Búsqueda de Azure AI) que define el contenido usado en una canalización de recuperación agente. Cada fuente de conocimiento está indexada o es remota, lo que determina cómo se ingiere, procesa y consulta el contenido. Los orígenes de conocimiento son componentes necesarios de una base de conocimiento.
Hacer referencia a varios orígenes de conocimiento en una base de conocimiento. La recuperación convencional minimal consulta todos los orígenes candidatos, mientras que el esfuerzo low y medium puede seleccionar un subconjunto. La respuesta combina los resultados más relevantes de los orígenes consultados.
El número de orígenes configurados y el número seleccionado durante la recuperación son límites independientes.
Fuentes de conocimiento aceptadas
Foundry IQ admite los siguientes orígenes de conocimiento para cargas de trabajo de recuperación agéntica.
| Tipo | Description | Indizado o remoto |
|---|---|---|
| Índice de búsqueda | Encapsula un índice existente. | Indexado |
| blob de Azure | Genera una canalización de indexación a partir de un contenedor de blobs. | Indexado |
| Azure SQL | Genera una canalización de indexador a partir de una tabla o vista de Azure SQL. | Indexado |
| Archivo | Carga los archivos directamente en Foundry IQ. | Indexado |
| OneLake | Genera una canalización de indexación a partir de un lakehouse. | Indexado |
| SharePoint indexado | Genera una canalización de indexador a partir de sitios de SharePoint. | Indexado |
| SharePoint remoto (versión preliminar) | Recupera contenido de SharePoint. | Remoto |
| Fabric Data Agent (versión preliminar) | Recupera respuestas y recursos incrustados de un agente de datos de Microsoft Fabric. | Remoto |
| Ontología de Fabric (versión preliminar) | Recupera respuestas basadas en entidades y relaciones de una ontología de Microsoft Fabric. | Remoto |
| Servidor MCP (versión preliminar) | Recupera los resultados activos y respaldados por herramientas de un servidor MCP externo. | Remoto |
| Work IQ (versión preliminar) | Obtiene inteligencia organizativa de Work IQ. | Remoto |
| Web | Recupera datos de puesta en tierra en tiempo real de Microsoft Bing. | Remoto |
Orígenes de conocimiento indexados
Una fuente de conocimiento indexada apunta a un índice de búsqueda que cumple los criterios para la recuperación agencial. El contenido se ingiere en el índice antes del tiempo de consulta a través de una de las tres rutas de acceso:
Use su propio índice: Use un origen de conocimiento de índice de búsqueda para envolver un índice existente en su servicio Foundry IQ.
Carga directa de archivos: Use un origen de conocimiento de archivos para cargar archivos directamente en Foundry IQ. El servicio procesa los archivos y almacena el contenido extraído en un índice de búsqueda generado, sin que se requiera ninguna canalización de indexador o almacenamiento externo.
Canalización del indexador generada automáticamente: En el caso de los orígenes de conocimiento de blob, OneLake y SharePoint indexados, Foundry IQ crea automáticamente una canalización completa del indexador a partir del origen de datos externo. La canalización incluye un origen de datos, un conjunto de aptitudes, un indexador y un índice que se rellena y fragmenta. Para Azure SQL, cada fila se convierte en un documento lógico y el servicio crea un conjunto de habilidades solo cuando se configura
embeddingColumns.
En 2026-11-01-preview, use el gráfico de temas para aumentar la recuperación de vectores para un origen de conocimiento existente searchIndex. Vincule un índice de temas preparado, completado y compatible a través del perfil del gráfico de temas del campo vectorial de búsqueda.
En el caso de los indexadores generados, el sondeo de cambios de origen y la continuación automática de la ingesta sin terminar son independientes. La carga directa de archivos no usa una programación de sondeo del indexador.
Las consultas se ejecutan localmente en el servicio Foundry IQ mediante consultas de texto completo (palabra clave), de vector o híbridas.
Dado que un origen de conocimiento indexado tiene un índice de búsqueda de respaldo, las referencias pueden incluir direcciones URL de cita generadas por el servicio que se resuelven en sus documentos en el índice. Los orígenes de conocimiento remotos no tienen ningún índice de respaldo, por lo que no devuelven direcciones URL de cita.
Orígenes de conocimiento remotos
Un origen de conocimiento remoto se conecta directamente a una plataforma externa. El contenido nunca se ingiere en Foundry IQ. En su lugar, se recupera en el momento de la consulta a través de las API nativas de cada plataforma. El motor de recuperación agente realiza la llamada API y expone los resultados junto con cualquier origen de conocimiento indexado en la misma respuesta.
Dependiendo de la plataforma, las conexiones remotas llegan al contenido a través de la red pública de Internet (como Bing) o dentro del inquilino de Microsoft (como SharePoint y Fabric).
Opciones de arquitectura de SharePoint
Elija cómo llega el contenido a la aplicación antes de decidir cuántos sitios o canalizaciones de procesamiento configurar.
| Approach | Elíjalo cuando | Propiedad y permisos |
|---|---|---|
| Origen de conocimiento de SharePoint indexado | Quiere una ruta de acceso de ingesta administrada que cree una copia que se pueda buscar del contenido SharePoint seleccionado. | Configure la selección de origen y contentExtractionMode mediante la API de origen de conocimiento. Habilite el flujo de permisos de documento admitido por separado; el acceso de ingesta no concede a los usuarios finales acceso a todos los elementos indexados. |
| indexador de SharePoint más un origen de conocimiento del índice de búsqueda | Debe controlar el esquema de índice, la programación de indexación o la canalización de enriquecimiento. | Configure y mantenga los recursos de indexación y, a continuación, conecte el índice rellenado a una base de conocimiento. Conserve los campos de permisos necesarios y el contexto de sitio de origen, incluidos los fragmentos derivados. |
| Origen de conocimiento de SharePoint remoto (versión preliminar) | Quiere la recuperación a través de Microsoft 365 sin crear un índice de contenido de SharePoint en Foundry IQ. | La recuperación usa la API de recuperación de Copilot y los permisos de SharePoint del usuario. Compruebe las limitaciones de licencia, filtrado y contenido del origen remoto. |
| Ingesta personalizada más un origen de conocimiento de índice de búsqueda | Las rutas de acceso integradas no cumplen los requisitos de ingesta o transformación. | Su aplicación se encarga de la extracción, el control de cambios y la gestión de eliminaciones, y la sincronización de permisos. La carga del contenido no conserva automáticamente los permisos SharePoint; implemente un flujo de permisos de documento admitido. |
Use una canalización indexada para el contenido que comparte un esquema de índice y los requisitos de administración. Utilice canalizaciones e índices independientes cuando el contenido necesite esquemas independientes, procesamiento o gobernanza. Un índice compartido todavía requiere permisos de nivel de documento cuando los usuarios tienen acceso diferente.
El contenido indizado refleja la sincronización de permisos y ingesta completadas, no una comprobación dinámica de todos los elementos de origen. Revisa sincronización de permisos de SharePoint. Para ámbitos de sitio más grandes, siga las instrucciones de topología de permisos de grupo de SharePoint en lugar de asumir que un recuento de sitios se aplica a cada configuración de permisos.
SharePoint indizado está disponible con la API REST 2026-10-01; el SharePoint remoto permanece en versión preliminar. Una base de conocimiento que combine orígenes indexados y remotos debe usar una versión de API que admita todos los tipos de origen a los que se hace referencia. No suponga que la API estable de octubre admite SharePoint remoto.
Para la ingesta indizada administrada, elija la extracción de contenido minimal o standard en la configuración de SharePoint indexada. Para una canalización de enriquecimiento configurada directamente, compare las opciones de extracción multimodal. Las funcionalidades de extracción dependen del recurso de origen y la ruta de procesamiento; los archivos, los elementos de lista y las páginas modernas tienen diferentes representaciones de contenido.
Clasificación unificada
Para los orígenes de conocimiento indexados y remotos, todo el contenido recuperado fluye a través de la misma canalización de clasificación. Los resultados se clasifican según su relevancia, se fusionan entre las distintas consultas y se reclasifican antes de devolverse en la respuesta de recuperación.
Trabajar con orígenes de conocimiento
Los orígenes de conocimiento son objetos independientes que se crean y administran independientemente de las bases de conocimiento. Tenga en cuenta lo siguiente:
Cree un origen de conocimiento antes de crear una base de conocimiento. Las bases de conocimiento hacen referencia a orígenes de conocimiento por identificador, por lo que el origen de conocimiento debe existir primero.
Para eliminar un origen de conocimiento, actualice primero o elimine las bases de conocimiento que hagan referencia a él. A continuación, puede eliminar el origen de conocimiento.
Un origen de conocimiento y su base de conocimiento deben existir en el mismo servicio Foundry IQ.
Las respuestas GET y LIST pueden censurar o omitir secretos. Para volver a crear recursos con autenticación y dependencias de destino válidas, siga Copia de seguridad segura, restauración y clonación.
Creación de orígenes de conocimiento
La compatibilidad con la creación en el portal de Azure, el portal de Microsoft Foundry, la API REST y la SDK de Azure varían según el tipo de origen de conocimiento. Para obtener instrucciones por tipo, consulte los vínculos de Orígenes de conocimiento admitidos.
Incorporar etiquetas de confidencialidad (versión preliminar)
Para las fuentes de conocimiento de blobs, OneLake indexado y SharePoint indexado, puede incorporar etiquetas de confidencialidad de Microsoft Purview configurando ingestionPermissionOptions para incluir sensitivityLabel. Siga todos los requisitos previos antes de establecer este valor. Una vez sincronizados con el índice, las etiquetas se muestran en las respuestas recuperadas y se usan para aplicar el acceso de nivel de documento en el momento de la consulta. Para obtener más información, consulte Aplicar permisos en tiempo de consulta (versión preliminar).
Si la fuente de conocimientos indexada usa un índice fragmentado, por ejemplo, con vectorización integrada o una aptitud personalizada de División de texto, también debe asignar la etiqueta de confidencialidad a la fila de cada fragmento mediante proyecciones de índice en el conjunto de aptitudes. De lo contrario, las referencias a nivel de fragmento en las respuestas de recuperación no se devolverán si tienen etiquetas en el documento de origen.
Mostrar imágenes incrustadas en documentos (versión preliminar)
Para las fuentes de conocimiento de blobs, OneLake indexado y SharePoint indexado, puede configurar un assetStore en el ingestionParameters de la fuente de conocimiento para conservar las imágenes incrustadas en sus documentos de origen. Cuando también habilita servicio de imágenes en la base de conocimiento, la acción de recuperación inserta esas imágenes en la indicación de síntesis de respuestas para que el LLM pueda razonar con diagramas, gráficos y contenido extraído de las imágenes. Para obtener más información, consulte Mostrar imágenes incrustadas en documentos en recuperación de agentes (versión preliminar).
No configure assetStore y ingestionPermissionOptions en el mismo origen de conocimiento. El servicio de imágenes no es compatible cuando se configura ingestionPermissionOptions.
Restricción de la ingesta a una red privada
La ingesta privada está disponible con carácter general en la API 2026-10-01 REST para blobs y ADLS Gen2, Azure SQL indexado y OneLake indexado como orígenes de conocimiento en los servicios dedicados aptos. Los vínculos privados compartidos aprobados pueden proteger las conexiones de origen aptas y las dependencias de Azure. Siga los requisitos de configuración y nivel para cada ruta de acceso y cualquier requisito de versión preliminar independiente.
Serverless no admite la ejecución del indexador privado ni los vínculos privados compartidos de Search saliente. Use la configuración perimetral de seguridad de red para los controles de acceso de punto de conexión público admitidos. Un perímetro no crea una conexión privada ni habilita la ejecución privada.
SharePoint Online no es un destino de vínculo privado compartido, por lo que la conexión de origen sigue siendo pública.
networkAccessMode sigue siendo solo para el momento de la creación. Para los orígenes de Blob, ADLS Gen2 y SQL aptos, consulte Cambiar la red después de crear el origen de conocimiento para la invalidación provisional del indexador y sus limitaciones.
Uso de analizadores automáticos por idioma (versión preliminar)
Los orígenes de conocimiento de Blob indexado, OneLake indexado y SharePoint indexado admiten analizadores automáticos por idioma para contenido multilingüe. Cuando está habilitada, Foundry IQ detecta el idioma de cada documento de origen y aplica automáticamente un analizador de idioma Microsoft coincidente. No se especifica un analizador en la definición del origen de conocimiento ni en una consulta.
Habilita esta característica de vista previa con minimal extracción de contenido y ingestionParameters.aiServices. Las instrucciones del conector vinculado proporcionan los pasos de configuración compartida, idiomas admitidos, comportamiento de respaldo, facturación y comprobación. Esta opción administrada difiere de asignar analizadores de lenguaje a campos de un índice que configure usted mismo.
Uso de orígenes de conocimiento
Después de crear un origen de conocimiento, haga referencia a él en una base de conocimiento. La base de conocimiento determina qué orígenes de conocimiento se van a consultar. En las secciones siguientes se describen las opciones para controlar qué orígenes se incluyen y cómo selecciona el motor entre ellos.
Consultar siempre un origen de conocimiento
Establezca true en alwaysQuerySource en la entrada de knowledgeSourceParams del origen en una solicitud de recuperación. Esta configuración de nivel de solicitud se admite en 2026-10-01; no es una propiedad almacenada en el origen de conocimiento. Para ver el comportamiento de las solicitudes y los controles de selección de origen, consulte Recuperación con la API REST de disponibilidad general.
Configuración almacenada y de solicitud
Tres niveles de configuración son independientes:
| Surface | Examples |
|---|---|
| Fuente de conocimiento almacenada |
searchIndexParameters.baseFilter; webParameters.language, market, county freshness. La configuración del índice de búsqueda existente incluye searchIndexName, sourceDataFields, searchFieldsy semanticConfigurationName. |
| Pertenencia a la KB | Cada knowledgeSources entrada contiene solo name. |
| Solicitud de recuperación | Una entrada knowledgeSourceParams especifica knowledgeSourceName, que coincide con kind, y opciones como alwaysQuerySource, failOnError, controles de referencia, rerankerThreshold y maxOutputDocuments. |
Una solicitud filterAddOn se combina con un valor almacenado baseFilter no vacío mediante AND. Las opciones web de la solicitud sustituyen los valores web almacenados. Consulte Recuperar parámetros.
Para conocer las opciones de ingesta de archivos y la compatibilidad con versiones, consulte Compatibilidad y límites de archivos.
Usa el esfuerzo de razonamiento de recuperación para controlar el uso de LLM
El esfuerzo de razonamiento en la recuperación de información controla la planificación de consultas. La recuperación normal minimal omite la planeación basada en modelos. En 2026-11-01-preview, una base de conocimiento configurada con Microsoft Retriever 1 puede usarla para el planeamiento mínimo con exactamente una intención semántica que contenga la pregunta completa. Con varias intenciones semánticas, Minimal omite la planificación de Microsoft Retriever 1 y combina resultados mínimos normales para cada intención. Una base de conocimiento con solo Microsoft Retriever 1 admite la salida extractiva, no la síntesis de respuesta externa. En low y medium, una instancia de LLM planea consultas y selecciona fuentes, y medium ejecuta una recuperación más profunda. Consulte Definir el esfuerzo de razonamiento de recuperación.
Los siguientes factores influyen en la selección con un esfuerzo de low y medium:
El
namede la fuente de conocimientos.El
descriptionde un índice (para fuentes de conocimiento indexadas).El
retrievalInstructionsespecificado en la definición de la base de conocimiento o la acción de recuperación. Las instrucciones de recuperación guían al LLM sobre qué fuentes de conocimiento seleccionar u omitir. Funcionan como un aviso: puede especificar brevedad, tono y formato.