El agente de Copilot studio no puede leer el origen de conocimiento de SharePoint: solución

Creó un agente de Copilot Studio y lo conectó a un origen de conocimiento de SharePoint, pero el agente no devuelve respuestas o indica que no puede encontrar información. Esto ocurre cuando el agente carece de permiso para leer el sitio de SharePoint, el origen está mal configurado o el formato del contenido no es compatible. Este artículo explica las tres causas principales y proporciona soluciones paso a paso para restaurar el acceso a los datos de SharePoint para su agente de Copilot Studio.

Por qué los agentes de Copilot Studio no pueden leer los orígenes de conocimiento de SharePoint

Los agentes de Copilot Studio usan Microsoft Graph para obtener contenido de SharePoint. Se deben cumplir tres condiciones: el agente debe autenticarse como un usuario o una entidad de servicio con acceso al sitio de SharePoint, el origen de SharePoint debe ser un tipo de contenido compatible y el agente debe estar configurado para usar Microsoft Entra ID para la autenticación. Si alguna de estas falla, el agente no puede leer el origen de conocimiento.

La causa principal más común son los permisos. Cuando agrega un origen de conocimiento de SharePoint en Copilot Studio, el agente no hereda los permisos automáticamente. Debe conceder explícitamente a la entidad de servicio del agente o al usuario autenticado acceso al sitio de SharePoint y a sus documentos. Sin esto, Graph devuelve un error 403 Prohibido de forma silenciosa y el agente responde con “No puedo encontrar esa información”.

Tipos de contenido no compatibles

Copilot Studio solo indexa bibliotecas de documentos estándar y páginas wiki. No indexa elementos de lista de SharePoint, columnas de datos externos ni archivos almacenados fuera de una biblioteca de documentos. Si su origen de conocimiento apunta a una lista o a una biblioteca con formatos de archivo no compatibles, como .zip o .exe, el agente ve un origen vacío.

Discrepancia en el modo de autenticación

Los agentes de Copilot Studio pueden usar dos modos de autenticación: “Authenticate with Microsoft”, que usa la propia entidad de servicio del agente, o “Custom website”, que requiere un registro de aplicación de Microsoft Entra ID. Si el agente está configurado en “No authentication”, las llamadas a Graph se bloquean por completo.

Pasos para solucionar el acceso a SharePoint del agente de Copilot Studio

Siga estos pasos en orden. Pruebe el agente después de cada paso para confirmar la solución.

1. Verifique la configuración de autenticación del agente
   Abra Copilot Studio. Vaya a Configuración > Seguridad > Autenticación. Seleccione “Authenticate with Microsoft” si desea que el agente use su propia identidad. Para agentes de producción, seleccione “Custom website” y registre una aplicación de Microsoft Entra ID con los permisos de Graph necesarios. No deje la autenticación configurada en “No authentication” cuando use orígenes de SharePoint.
2. Conceda al agente acceso al sitio de SharePoint
   Abra el sitio de SharePoint en un navegador. Haga clic en el icono de engranaje y seleccione Permisos del sitio > Compartir sitio. En el cuadro de diálogo, escriba el nombre de la entidad de servicio del agente de Copilot Studio. El nombre de la entidad de servicio se muestra en Copilot Studio en Configuración > Canales > Microsoft Teams > Administrar. Normalmente tiene el formato “copilot-studio-@.onmicrosoft.com”. Asigne el nivel de permiso Lectura. Haga clic en Compartir.
3. Verifique la URL del origen de conocimiento
   En Copilot Studio, vaya a Conocimiento > Agregar origen de conocimiento > SharePoint. Pegue la URL completa del sitio de SharePoint o de la biblioteca de documentos. No incluya filtros ni parámetros de consulta. Para una biblioteca de documentos, use el formato de URL: https://.sharepoint.com/sites//Shared%20Documents. Para un sitio, use la URL raíz: https://.sharepoint.com/sites/.
4. Confirme el contenido compatible
   Asegúrese de que el origen de SharePoint contenga solo tipos de archivo compatibles: .docx, .pptx, .xlsx, .pdf, .txt y .html. Quite o mueva los archivos no compatibles, como .zip, .exe, .msg o .csv, a una biblioteca aparte. Copilot Studio también indexa páginas wiki de SharePoint. Los elementos de una lista no se indexan.
5. Vuelva a indexar el origen de conocimiento
   Después de cambiar los permisos o el contenido, quite el origen de conocimiento de SharePoint del agente. Guarde el agente. Agregue el origen de nuevo con la URL correcta. Copilot Studio vuelve a indexar el contenido en un plazo de 15 minutos. Para forzar una actualización, vaya a Conocimiento, seleccione el origen y haga clic en Sincronizar.
6. Pruebe con una consulta específica
   Abra el panel de prueba del agente. Formule una pregunta que coincida con el título o el contenido de un documento conocido de la biblioteca de SharePoint. Por ejemplo, si tiene un archivo llamado “Onboarding Policy.docx”, pregunte “¿Cuál es la política de incorporación?”. Si el agente sigue sin devolver respuesta, inspeccione el estado del origen en Conocimiento. Un estado rojo indica un error de permisos o de indexación.

Si el agente de Copilot Studio sigue sin poder leer SharePoint

Si los pasos de solución principales no resuelven el problema, revise estos patrones de error adicionales.

Error “El origen de conocimiento no devolvió datos”

Este error aparece en el panel de estado del origen de conocimiento de Copilot Studio. La causa suele ser una URL de sitio que no coincide. Verifique que la URL no incluya una ruta de archivo ni una cadena de consulta. Confirme también que el sitio de SharePoint no sea un sitio de comunicación con acceso restringido. Conceda al agente acceso al sitio como se describe en el Paso 2.

El agente devuelve respuestas genéricas en lugar de datos de SharePoint

Esto indica que el agente puede conectarse a SharePoint, pero no puede leer los archivos específicos. Compruebe que los documentos no estén desprotegidos (checked out) para otro usuario. Los documentos desprotegidos son invisibles para Graph. Confirme también que los documentos no estén en una carpeta con permisos únicos. El agente debe tener acceso de Lectura a cada carpeta y archivo de la biblioteca.

El origen de SharePoint muestra “Sincronizando” indefinidamente

Esto ocurre cuando el sitio de SharePoint es muy grande o tiene muchas carpetas anidadas. Copilot Studio indexa hasta 10.000 elementos por origen. Si la biblioteca supera este límite, quite el origen y agregue una URL de biblioteca de documentos más específica en lugar de la raíz del sitio. Por ejemplo, use https://.sharepoint.com/sites//Shared%20Documents/HR%20Policies en lugar de la raíz del sitio.

El agente falla después de cambios en el registro de aplicación de Microsoft Entra ID

Si usa autenticación personalizada, verifique que el registro de aplicación tenga el permiso delegado “Sites.Read.All” o “Sites.ReadWrite.All” en Microsoft Graph. Conceda también el consentimiento de administrador para los permisos. Sin el consentimiento, el agente no puede autenticarse en SharePoint. Vaya a Microsoft Entra ID > Registros de aplicaciones > Su aplicación > Permisos de API y haga clic en Conceder consentimiento de administrador.

Elemento	Authenticate with Microsoft	Custom website
Descripción	El agente usa su propia identidad de entidad de servicio integrada	El agente usa una aplicación de Microsoft Entra ID que usted registra
Tiempo de configuración	Minutos	Horas
Permisos de Graph necesarios	Ninguno para configurar	Permiso delegado Sites.Read.All
Ideal para	Pruebas y equipos pequeños	Agentes de producción con personalización de marca o SSO
Limitación	No se puede usar con orígenes de datos personalizados fuera de Microsoft 365	Requiere consentimiento de administrador y manejo de la actualización de tokens

Ahora puede diagnosticar y solucionar los errores de acceso a SharePoint del agente de Copilot Studio revisando la autenticación, los permisos y los tipos de contenido. Comience verificando el modo de autenticación del agente y concediendo acceso de Lectura al sitio de SharePoint. Si los problemas persisten, limite la URL del origen de conocimiento a una biblioteca de documentos específica y confirme que todos los archivos sean compatibles y no estén desprotegidos. Para escenarios avanzados, revise los permisos del registro de aplicación de Microsoft Entra ID y asegúrese de que se haya concedido el consentimiento de administrador.