SharePoint orígenes de conocimiento no devuelven resultados en Copilot Studio

Resumen

Este artículo le ayuda a solucionar problemas en los que SharePoint orígenes de conocimiento no devuelven resultados en Microsoft Copilot Studio. Al configurar un origen de datos de SharePoint, varios factores pueden impedir que el agente proporcione una respuesta. Estos factores incluyen resultados de búsqueda que faltan, permisos de usuario, contenido protegido, problemas de registro de aplicaciones, limitaciones de tamaño de archivo, condiciones de filtro o filtrado de moderación de contenido. En tales casos, el agente podría devolver un mensaje como "No estoy seguro de cómo ayudar con eso. ¿Puede probar la repetición?"

Copilot Studio proporciona dos maneras de configurar SharePoint como origen de conocimiento y en este artículo se tratan ambos métodos:

  • Origen de conocimiento de nivel de agente. Agregue desde el cuadro de diálogo Agregar conocimiento en las páginas Información general, Conocimiento o Propiedades del agente. Esta ruta de acceso admite SharePoint sitios (direcciones URL) y listas de SharePoint, recorte de etiquetas de confidencialidad y condiciones de filtro. Para obtener más información, consulte Agregar SharePoint como origen de conocimiento.
  • Origen de conocimiento de nivel de tema. Agregue dentro de un nodo Crear respuestas generativas en un tema. Esta ruta de acceso empareja el nodo con una dirección URL de SharePoint. Para obtener más información, vea Usar SharePoint contenido para respuestas generativas.

Note

Antes de continuar, asegúrese de seguir las instrucciones de configuración de la ruta de acceso de configuración que usa el agente: agregue SharePoint como origen de conocimiento para la ruta de acceso de nivel de agente o Use SharePoint contenido para respuestas generativas para el nodo de respuestas generativas de nivel de tema.

Para obtener mejores resultados de búsqueda, use una licencia de Microsoft 365 Copilot dentro del mismo inquilino que el agente.

Faltan resultados de la búsqueda de SharePoint

Cuando Copilot Studio busca SharePoint, solo usa los tres primeros resultados de búsqueda para resumir y generar una respuesta. Si no se devuelve ningún resultado de búsqueda, el agente no proporciona una respuesta. Copilot Studio se basa en Búsqueda de Microsoft indexación y aplica restricciones específicas en los diseños de página, componentes y formatos de archivo que se usan para generar respuestas.

Corregir los resultados de búsqueda de SharePoint que faltan

  1. Asegúrese de que el origen de conocimiento de SharePoint (origen de nivel de agente o Crear nodo de respuestas generativas) apunta a una ubicación de SharePoint con contenido relevante.

  2. Solo se utilizan documentos en formatos admitidos para generar respuestas.

  3. Compruebe que las páginas de SharePoint que espera que el agente use cumplan las restricciones siguientes:

    • Páginas modernas: Solo se admiten páginas modernas SharePoint. No se admiten páginas modernas que contienen componentes de SharePoint Framework (SPFx).
    • Páginas clásicas: El contenido de las páginas clásicas .aspx de SharePoint no se usa para generar respuestas.
    • Para obtener una lista completa de los límites técnicos, consulte SharePoint límites de aplicaciones web.
  4. Es posible que los documentos se hayan cargado recientemente en SharePoint y que aún no se hayan indexado. También es posible que algunas configuraciones impidan que algunos sitios aparezcan en los resultados de búsqueda. Para obtener más información, consulte Faltan resultados de búsqueda en SharePoint En línea.

    Cómo comprobarlo

    • En la barra de búsqueda del portal de SharePoint, escriba una palabra clave única del documento de destino y compruebe que el archivo aparece en los resultados de búsqueda. Si el archivo no aparece, la indexación está incompleta.

    Solución

    • Espere a que se complete el ciclo de indexación automatizado.
    • Para las actualizaciones urgentes, SharePoint los administradores del sitio pueden desencadenar manualmente un reindexación. En SharePoint configuración, vaya a Site Information>View all site settingsSearch and offline availability> (Ver toda la configuración del sitio> sin conexión). Para obtener más información, vea Solicitud manual de rastreo y reindexación de un sitio, una biblioteca o una lista.

Faltan permisos de usuario para SharePoint

Copilot Studio respeta Seguridad de Microsoft 365 recorte. Como mínimo, un usuario debe tener permisos de lectura en los sitios y archivos pertinentes, o no se devuelve ningún resultado de búsqueda.

Si faltan permisos al usuario, el sistema no devuelve ningún resultado ni errores ni excepciones. Para un usuario sin permisos, parece como si no se hubieran encontrado documentos.

Note

Cuando un usuario no tiene permiso, el sistema no produce un error o una excepción. En su lugar, se comporta silenciosamente como si el documento no existiera. No confíe únicamente en estructuras de herencia de nivel de carpeta para conceder acceso.

Comprobar SharePoint permisos de usuario

  1. Haga que el usuario afectado vaya directamente a la ruta de acceso exacta del documento SharePoint para comprobar que puede abrir el archivo.
  2. Pruebe la consulta mediante la misma cuenta de usuario en Microsoft 365 Copilot Chat. Si Microsoft 365 Copilot Chat no puede recuperar una respuesta, confirma una barrera de indexación de búsqueda o permiso.

Corrección de la falta de permisos de usuario SharePoint

Modifique los permisos para que los usuarios puedan acceder a los sitios y archivos relevantes. Para obtener más información, consulte Uso compartido y permisos en la experiencia moderna de SharePoint.

El contenido está protegido por etiquetas de confidencialidad, DKE o una contraseña

El SharePoint origen de conocimiento de nivel de agente respeta las etiquetas de confidencialidad para el recorte de permisos y solo expone el contenido permitido por etiquetas para el usuario que ha iniciado sesión. Sin embargo, el agente no puede extraer ni aplicar tierra sobre contenido cuya protección cifre el archivo. Esta limitación incluye etiquetas de sensibilidad que aplican cifrado, cifrado doble clave (DKE) y archivos protegidos con contraseña.

Estos documentos pueden mostrarse como Listos en la lista de orígenes de conocimiento y el usuario podría abrirlos en SharePoint, pero devolver "sin respuesta" cuando el agente se pregunte sobre su contenido.

Comprobación del contenido de SharePoint protegido

  1. Abra el archivo directamente en SharePoint o en su aplicación de escritorio y compruebe si solicita una contraseña, indica la protección de DKE o muestra una etiqueta de confidencialidad de cifrado.
  2. Pregunte sobre el contenido que se sabe que solo aparece en archivos no protegidos en el mismo origen. Si esas consultas se realizan correctamente mientras las consultas con ámbito de archivos protegidos no devuelven ninguna respuesta, la protección es la causa.

Corrección del contenido de SharePoint protegido

  • Quite la etiqueta de confidencialidad de cifrado, la protección contra DKE o la contraseña del archivo, si las directivas de su organización lo permiten.
  • Publique una copia desprotegida del contenido necesario en una ubicación de SharePoint a la que el agente pueda acceder.
  • Apunte el origen de conocimiento a una ubicación de SharePoint que no contenga contenido cifrado.

Si cambia el nombre de un sitio o carpeta de SharePoint que usa un origen de conocimiento de nivel de agente, el vínculo de origen existente puede interrumpirse y provocar una brecha de permisos. Cuando esto sucede, es posible que el agente no pueda acceder a la base de conocimiento y no devuelva ninguna respuesta.

  1. Pida a su Administrador de SharePoint que conceda los permisos adecuados en la ubicación cuyo nombre ha cambiado y genere un nuevo vínculo de origen.
  2. Abra el agente y actualice el SharePoint origen de conocimiento con el vínculo recién generado.

El registro o el agente de la aplicación están mal configurados para SharePoint

Cuando los administradores configuran SharePoint orígenes de conocimiento, deben configurar la autenticación mediante un registro de aplicaciones Microsoft Entra ID y configurar ámbitos adicionales. Como mínimo, el registro de la aplicación debe especificar los Sites.Read.All ámbitos y Files.Read.All y agregar esos ámbitos a la configuración de autenticación del agente junto con profile y openid. Si faltan ámbitos del registro de aplicaciones o de la configuración de autenticación del agente, o si no se concede consentimiento a los ámbitos necesarios, el agente no devuelve ningún resultado ni errores ni excepciones. Para un usuario, parece como si no se hubiera encontrado ningún documento.

Importante

Si Restricted SharePoint Search está activado para el inquilino, el uso de SharePoint como origen de conocimiento se bloquea independientemente del registro de la aplicación o la configuración del agente, y no se devuelve ningún resultado. Confirme con su Administrador de SharePoint que Restricted SharePoint Search no está activado o agregue los sitios pertinentes a la lista de permitidos.

Las respuestas generativas de SharePoint orígenes tampoco están disponibles para los usuarios invitados en aplicaciones habilitadas para SSO.

Corrige el registro de la aplicación mal configurado o la autenticación del agente

Agregue los ámbitos necesarios al registro de la aplicación y a la configuración de autenticación del agente y conceda consentimiento.

El siguiente ejemplo es una referencia a un registro de aplicación bien configurado:

Captura de pantalla de la página Permisos configurados para un registro de aplicación con los permisos Files.Read.All y Sites.Read.All delegados concedidos.

El siguiente ejemplo muestra la configuración de autenticación requerida en Copilot Studio:

Captura de pantalla del panel Autenticación de Copilot Studio con Autenticación seleccionada manualmente y los ámbitos necesarios especificados.

Límites de tamaño de archivo para SharePoint respuestas generativas

Para las fuentes de SharePoint, si no tiene una licencia de Microsoft 365 Copilot en el mismo tenant que su agente, las respuestas generativas solo pueden procesar archivos de hasta 7 MB. También debe desactivar el gráfico de inquilinos con la configuración de búsqueda semántica .

Si tiene una licencia de Microsoft 365 Copilot en el mismo inquilino que su agente, el tamaño máximo de archivo es de 200 MB. También debe activar el grafo de inquilinos con la configuración de búsqueda semántica .

Los archivos más grandes se pueden almacenar en SharePoint y los devuelve una búsqueda de Microsoft Graph, pero las respuestas generativas no los procesan. Como alternativa, puede cargar sus propios archivos, que pueden tener un tamaño de hasta 512 MB.

Para obtener una lista de los límites y la funcionalidad de SharePoint admitida, consulte Límites de aplicaciones web de SharePoint.

Corrija los problemas con el tamaño de los archivos para las respuestas generativas de SharePoint

Si los archivos relevantes para su experiencia de IA conversacional superan la limitación de tamaño, es posible que desee explorar arquitecturas alternativas, como usar Microsoft 365 Indexación semántica o conectar sus datos a Azure OpenAI para obtener respuestas generativas.

SharePoint list origen no devuelve ningún resultado

En el caso de los orígenes de conocimiento de nivel de agente que usan listas de SharePoint, varios factores específicos de la lista pueden hacer que el agente no devuelva ninguna respuesta aunque la lista contenga datos pertinentes.

  • Se requiere la búsqueda de Dataverse. Copilot Studio agentes requieren la búsqueda de Dataverse para usar un SharePoint list como origen de conocimiento. Si la búsqueda de Dataverse está desactivada en el entorno, no se puede consultar la lista y no se devuelve ningún resultado. Para obtener más información sobre cómo activar la búsqueda de Dataverse, consulte Configuración de la búsqueda de Dataverse para su entorno.
  • El tamaño de la lista afecta a la calidad y la latencia. Las listas que contienen más de 35 000 filas pueden degradar la calidad de los resultados y aumentar la latencia, lo que puede presentarse como ninguna respuesta para consultas válidas en caso contrario.
  • Demasiadas listas en un agente. Puede seleccionar hasta 10 listas a la vez y, para obtener los mejores resultados, use no más de 10 listas por agente. Agregar más listas aumenta la posibilidad de que el contenido relevante no se muestre.
  • La lista no aparece en Listas recientes. Si un SharePoint list con acceso compartido no aparece en Mis listas o listas recientes en el explorador, abra la lista en SharePoint una vez para que aparezca en listas recientes o pegue la dirección URL directamente en la selección de dirección URL al agregar el origen.

Corrección de problemas de origen de SharePoint list

  1. Pida al administrador que active la búsqueda de Dataverse en el entorno donde se ejecuta el agente.
  2. Reduzca el número de filas de la lista o divida listas grandes en listas centradas más pequeñas.
  3. Reduzca el número de listas adjuntas al agente a 10 o menos, manteniendo solo las listas que son relevantes para los temas que admite el agente.
  4. Vuelva a agregar listas pegando su dirección URL cuando no aparezcan automáticamente en listas recientes.

Las condiciones de filtro excluyen el contenido esperado

Ambas rutas de acceso de configuración permiten restringir qué SharePoint contenido que puede usar el agente. Si esos filtros son demasiado restrictivos o están mal configurados, el agente no devuelve ninguna respuesta incluso cuando existe contenido coincidente.

  • Origen de nivel de agente, Filtros de configuración avanzada. En un origen de conocimiento de nivel de agente SharePoint, los filtros basados en Título, Autor, Modificado por o Modificado pueden excluir el contenido sobre el que el usuario está preguntando. Los filtros enlazados a una variable personalizada, una variable del sistema o una variable de entorno pueden resolverse en un valor no deseado en tiempo de ejecución.
  • Nodo de respuestas generativas de nivel de tema, Buscar solo orígenes seleccionados. Cuando buscar solo los orígenes seleccionados está activado para un nodo Crear respuestas generativas , solo se usan los orígenes seleccionados en ese nodo. Si el origen de SharePoint esperado no está en la selección, el agente no devuelve ninguna respuesta en lugar de revertir a otros orígenes de conocimiento.

Comprobación de condiciones de filtro

  1. En la página Conocimiento, seleccione el origen de la SharePoint y, a continuación, seleccione Editar>configuración avanzada para revisar las condiciones de filtro activas y los valores a los que se resuelven.
  2. En el tema que hospeda el nodo Crear respuestas generativas, abra el origen dedatos> del nodo y confirme la opción Buscar solo los orígenes seleccionados y los orígenes específicos seleccionados.

Corrección de condiciones de filtro

  • Relájate o quite las condiciones de filtro que excluyen el contenido esperado.
  • Si un filtro usa una variable, agregue un paso de depuración en la conversación para confirmar que la variable se resuelve en el valor esperado en tiempo de ejecución.
  • En el nodo de nivel de tema, agregue el origen de SharePoint esperado a los orígenes seleccionados o desactive Buscar solo los orígenes seleccionados para que también se consulten los orígenes de conocimiento de nivel de agente.

Contenido bloqueado por moderación de contenido en Copilot Studio

Cuando generan respuestas, los agentes de Copilot Studio moderan el contenido que se encuentra bajo las categorías de daños. Cuando el contenido se modera, las respuestas generativas no proporcionan una respuesta ni una indicación de que el contenido se ha moderado. Sin embargo, los eventos de moderación se registran cuando el agente está configurado para enviar datos de telemetría a Azure Applications Insights.

Después de conectar el agente a App de Azure Insights, puede usar la siguiente consulta del lenguaje de consulta Kusto (KQL) para averiguar si se filtró contenido:

customEvents
| extend cd = todynamic(customDimensions)
| extend conversationId = tostring(cd.conversationId)
| extend topic = tostring(cd.TopicName)
| extend message = tostring(cd.Message)
| extend result = tostring(cd.Result)
| extend SerializedData = tostring(cd.SerializedData)
| extend Summary = tostring(cd.Summary)
| extend feedback = tostring(todynamic(replace_string(SerializedData,"$","")).value)
| where name == "GenerativeAnswers" and result contains "Filtered"
| where cloud_RoleInstance == "myCopilot"
| project cloud_RoleInstance, name, timestamp, conversationId, topic, message, result, feedback, Summary
| order by timestamp desc

En el siguiente ejemplo, la consulta KQL destaca un intento de utilizar respuestas generativas filtradas por moderación de contenido:

Captura de pantalla de un resultado de consulta de Application Insights que muestra un evento de respuestas generativas con el resultado filtrado por moderación de contenido.

Corregir el bloqueo de respuestas generativas por la moderación de contenido