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.
Se aplica a: Desarrollador
Las experiencias de agente de SharePoint Embedded permiten que la aplicación responda a preguntas sobre los archivos almacenados en contenedores de SharePoint Embedded. Dos productos distintos fundamentan esas experiencias en el contenido del contenedor:
- Microsoft Foundry Agent Service con un origen de conocimiento de SharePoint , para los agentes que compiles en Foundry. Fundición ejecuta la recuperación por usted como parte del agente. Para obtener los pasos de configuración, consulte Configurar SharePoint Embedded como un origen de conocimiento de Fundición.
- API de recuperación de Microsoft 365 Copilot: para agentes personalizados y aplicaciones que ejecutan su propio paso de conexión a tierra. Llámelo desde cualquier aplicación, incluido un agente de Fundición que no use el origen de conocimiento de SharePoint.
Elija el origen de conocimiento cuando desee que Foundry administre la recuperación y la orquestación del agente. Elige la API de recuperación cuando desees controlar el paso de conexión a tierra, la consulta y el modelo tú mismo.
Sugerencia
Para aprovisionar y administrar los recursos de SharePoint Embedded detrás de estas experiencias desde un agente de codificación, use el servidor MCP de SharePoint Embedded.
Cómo SharePoint Embedded fundamenta a los agentes
SharePoint Embedded conecta agentes de IA al contenido empresarial a la vez que mantiene ese contenido y sus controles de cumplimiento dentro del inquilino de Microsoft 365 del cliente. No se copia contenido en una base de datos vectorial externa. Datos clave:
- La detectabilidad de contenido es una configuración del tipo de contenedor que rige si Microsoft 365 Copilot puede exponer el contenido. El gobierno de inquilinos controla esta configuración, por lo que una aplicación no puede exponer contenido cambiando su propia configuración.
-
Recupere contenido con la API de Búsqueda de Microsoft, con el ámbito del identificador de tipo de contenedor (
ContainerTypeId), o con un origen de conocimiento de SharePoint de Fundición. - El contenido permanece en el inquilino de Microsoft 365 del cliente, por lo que se aplican la prevención de pérdida de datos (DLP), la retención y eDiscovery de Microsoft Purview.
- Nada está autoexpuesto. El contenido de SharePoint Embedded no está disponible para Copilot hasta que se habilita la detectabilidad en el tipo de contenedor.
Para obtener el contexto de decisión, consulte IA terrestre sin una base de datos vectorial externa.
Precaución
El SDK anterior del agente de SharePoint Embedded (el control ReactChatEmbedded) quedó en desuso en marzo de 2026 y fue sustituido por el servicio de agente de Microsoft Foundry por un origen de conocimiento de SharePoint (versión preliminar) configurado para SharePoint Embedded. Use una de las dos opciones de este artículo para trabajos nuevos.
Uso de la API de recuperación
La API de recuperación de Microsoft 365 Copilot devuelve extractos de texto relevantes que la aplicación pasa a su propio modelo como datos de fundamentación. Establézcalo dataSource en sharePointEmbedded para recuperar desde el contenido de SharePoint Embedded.
Nota:
La compatibilidad de la API de recuperación con el origen de sharePointEmbedded datos está en versión preliminar.
Requisitos previos de la API de recuperación
- Una aplicación de SharePoint Embedded con al menos un contenedor, más el identificador de tipo de contenedor.
- Facturación de pago por uso configurada para el tipo de contenedor.
- Al menos un usuario en el inquilino con una licencia de Microsoft 365 Copilot, por lo que se inicializa el índice semántico. Para obtener más información, consulte Índice semántico para Microsoft 365 Copilot.
El sharePointEmbedded origen de datos factura el pago por uso, por lo que cada usuario que consulta la API de recuperación no necesita una licencia individual de Microsoft 365 Copilot.
Recuperar contenido de un tipo de contenedor
Llamada POST /copilot/retrieval con un token delegado. Establézcalo dataSource y pase el identificador de tipo de contenedor en dataSourceConfiguration.sharePointEmbedded La solicitud necesita el FileStorageContainer.Selected permiso delegado y el servicio recorta los resultados al contenido al que pueda acceder el usuario que ha iniciado sesión.
POST https://graph.microsoft.com/v1.0/copilot/retrieval
Content-Type: application/json
{
"queryString": "What are the terms of the Contoso agreement?",
"dataSource": "sharePointEmbedded",
"dataSourceConfiguration": {
"sharePointEmbedded": {
"containerTypeId": "{containerTypeId}"
}
}
}
Reemplácelo {containerTypeId} por el identificador de tipo de contenedor.
La respuesta devuelve una retrievalHits colección. Cada resultado identifica un archivo de origen y webUrl lleva uno o varios extracts, ordenados por relevanceScore.
{
"retrievalHits": [
{
"webUrl": "https://contoso.com/spe/file",
"extracts": [
{
"text": "The agreement renews annually unless either party gives 30 days' notice.",
"relevanceScore": 0.8421
}
]
}
]
}
La forma depende de la configuración del tipo de webUrlurlTemplate contenedor, por lo que debe tratarlo como un vínculo opaco en lugar de analizarlo. Para resolver los detalles del archivo, llame a Obtener un elemento de unidad. Para obtener más información sobre urlTemplate, consulte Creación y configuración de un tipo de contenedor.
Para devolver campos adicionales, como title o author con cada visita, agregue una resourceMetadata colección a la solicitud. Solicite solo los campos que usa la aplicación, ya que cada campo se suma a la carga de respuesta.
Filtrar la recuperación por metadatos personalizados
Se usa filterExpression para limitar la recuperación a archivos con metadatos personalizados específicos. En primer lugar, cree una columna personalizada indexada, establezca los valores del archivo y espere a que finalice la indexación de búsqueda. Para obtener instrucciones, consulte Almacenamiento y consulta de metadatos de contenedores.
SharePoint Embedded almacena los valores de columna personalizados de un archivo en su recurso asociado listItem/fields . La recuperación filtra en la propiedad administrada de SharePoint indexada de la columna, no en el nombre del campo almacenado.
Por ejemplo, una columna de texto de una sola línea con nombre ClientMatterCode normalmente tiene esta propiedad administrada:
ClientMatterCodeOWSTEXT
Las propiedades administradas creadas automáticamente son propiedades de texto, incluso cuando sus columnas de origen usan otro tipo de datos. El formato del sufijo y del valor indizado depende del tipo de columna. Confirme el nombre de propiedad generado y el formato de valor en el inquilino de destino. Para obtener detalles sobre cómo nomenclatura, vea Propiedades administradas creadas automáticamente en SharePoint Server.
Esta solicitud limita los candidatos a archivos con un valor de metadatos indexado exacto. También devuelve el valor con cada acierto coincidente:
POST https://graph.microsoft.com/v1.0/copilot/retrieval
Content-Type: application/json
{
"queryString": "What obligations are described in the client agreement?",
"dataSource": "sharePointEmbedded",
"dataSourceConfiguration": {
"sharePointEmbedded": {
"containerTypeId": "{containerTypeId}"
}
},
"filterExpression": "ClientMatterCodeOWSTEXT=\"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\"",
"resourceMetadata": [
"title",
"containerTypeId",
"ClientMatterCodeOWSTEXT"
],
"maximumNumberOfResults": 10
}
Se usa = cuando el valor indexado completo debe coincidir:
ClientMatterCodeOWSTEXT="aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
No use el : operador para un límite exacto. El operador de dos puntos realiza la coincidencia de términos y puede comparar valores o prefijos relacionados. Para obtener más información, consulte la referencia de sintaxis del lenguaje de consulta por palabra clave.
El filtro limita los archivos candidatos antes queryString de clasificar extractos semánticamente relevantes. Es posible que un archivo con metadatos coincidentes no aparezca cuando su contenido no esté relacionado con queryString.
Pase las extracciones a su propio modelo o paso de generación de respuestas como datos de fundamentación. Este fragmento envía la consulta y lee el extracto principal de cada acierto:
const response = await fetch("https://graph.microsoft.com/v1.0/copilot/retrieval", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`
},
body: JSON.stringify({
queryString: query,
dataSource: "sharePointEmbedded",
dataSourceConfiguration: {
sharePointEmbedded: { containerTypeId: containerTypeId }
}
})
});
const data = await response.json();
const grounding = (data.retrievalHits ?? []).map(hit => ({
url: hit.webUrl,
text: hit.extracts?.[0]?.text?.trim(),
score: hit.extracts?.[0]?.relevanceScore
}));
La recuperación cubre todos los contenedores del tipo de contenedor a los que puede acceder el usuario que ha iniciado sesión. Si una solicitud no devuelve resultados, confirme que el índice semántico se inicializó, que la indexación finalizó y que el usuario tiene acceso al contenido.
Facturación de API de recuperación
Las solicitudes de API de recuperación que usan la factura del origen de sharePointEmbedded datos en el medidor de mensajes de Copilot Studio. Los cargos siguen el modelo de facturación configurado para el tipo de contenedor. La facturación Standard cobra la suscripción a Azure del inquilino propietario y la facturación transferida cobra la suscripción del inquilino consumidor.
Para obtener detalles sobre los medidores, consulte Medidores de facturación. Para comparar modelos, consulte Elegir un modelo de facturación.
Probar la experiencia del usuario
Inicie sesión con un usuario que pueda acceder al contenido del contenedor. Cargue los archivos compatibles en un contenedor, espere a que se indexen, abra el chat y formule preguntas que el contenido del archivo pueda responder. Si las respuestas omiten los archivos esperados, compruebe:
- Detectabilidad.
- Formatos de archivo admitidos.
- Acceso a la aplicación.
- Acceso de usuarios.
- Selección de ámbito.
- Retraso de indexación.