Agregar SharePoint como origen de conocimiento

SharePoint como origen de conocimiento funciona emparejando el agente con una dirección URL de SharePoint o listas de SharePoint. En este artículo se describe la funcionalidad completa de integración de SharePoint proporcionada seleccionando la opción SharePoint en el cuadro de diálogo Agregar conocimiento.

Cuando publica su agente, las llamadas que utilizan respuestas generativas se realizan en nombre del usuario que chatea con el agente, utilizando la configuración de autenticación configurada en el agente. De forma predeterminada, los agentes creados en Copilot Studio y en Microsoft Teams se configuran con la opción Authenticate con Microsoft, que funciona en entornos como Microsoft Teams, Power Apps y Microsoft 365 Copilot.

Agregar sitios SharePoint como origen de conocimiento

Cuando un usuario hace una pregunta y el agente no tiene un tema para usar como respuesta, el agente busca en la URL y en todas las subrutas. Por ejemplo, una URL como contoso.sharepoint.com/sites también incluye subrutas como contoso.sharepoint.com/sites/policies. Las respuestas generativas resumen este contenido en una respuesta específica.

Para agregar un sitio de SharePoint como origen de conocimiento, realice los pasos siguientes:

1. Abrir el agente.

2. Seleccione Agregar conocimiento desde las páginas Resumen general o Conocimiento o las Propiedades de un nodo de respuestas generativas.

3. En la sección Featured, seleccione SharePoint.

   

4. Proporcione la dirección URL de SharePoint. Separe varias direcciones URL con saltos de línea manuales (use Mayús+Enter).

5. Agregue un nombre y una descripción. La descripción debe ser tan detallada como sea posible, especialmente si la IA generativa está habilitada, ya que la descripción ayuda a la orquestación generativa.

6. Seleccione Agregar al agente para terminar de agregar el origen de conocimiento.

Agregar listas de SharePoint como origen de conocimiento

SharePoint listas son una manera popular de almacenar datos tabulares y proporcionar acceso rápido y fácil a la información. El agente puede usar estas listas como origen de conocimiento. Al agregar una lista de SharePoint como origen de conocimiento, se crea una conexión en tiempo real al origen, por lo que los datos más actuales se usan para las consultas y el razonamiento. Los usuarios se autentican con sus credenciales de SharePoint, lo que garantiza que tienen permiso para acceder a los datos antes de que el agente proporcione una respuesta.

1. Abrir el agente.

2. Seleccione Agregar conocimiento desde las páginas Resumen general o Conocimiento o las Propiedades de un nodo de respuestas generativas.

3. En la sección Featured, seleccione SharePoint.

4. Seleccione Browse items para buscar la lista deseada o escriba la dirección URL de una lista de SharePoint específica.

   

5. Al seleccionar Examinar elementos, el cuadro de diálogo se rellena automáticamente con Mis listas y Listas recientes. My Lists solo muestra listas creadas en la aplicación listas de SharePoint. Todas las demás listas aparecen en las Listas recientes. Si no ve una lista que necesita, abra SharePoint y acceda a la lista y, a continuación, aparecerá en Recent Lists.

   

   Puede seleccionar hasta 15 listas cada vez. Cada lista se agrega a las fuentes de conocimiento del agente como ítems individuales. Para agregar más listas al agente, vuelva a usar estos pasos y seleccione más listas.

   Nota

   Si desea usar una lista de SharePoint con acceso compartido, pero no se muestra en la Recent Lists, pegue la dirección URL de la lista en la selección de direcciones URL.

6. Después de seleccionar las listas deseadas, seleccione Confirmar selección.

7. Agregue un nombre y una descripción. La descripción debe ser tan detallada como sea posible, especialmente si la IA generativa está habilitada, ya que la descripción ayuda a la orquestación generativa.

8. Seleccione Agregar al agente para terminar de agregar el origen de conocimiento.

Escenarios de autenticación avanzados

De forma predeterminada, Copilot Studio preconfigura los agentes para autenticar a los usuarios mediante la autenticación de Microsoft para acceder a orígenes de SharePoint cuando se conectan a un agente a través de Microsoft Teams, Power Apps o Microsoft 365 Copilot. Sin embargo, si necesita configurar manualmente la autenticación, se requieren los pasos siguientes para que las respuestas generativas funcionen con fuentes de datos de SharePoint.

• Las respuestas generativas de orígenes de SharePoint no están disponibles para los usuarios guest en aplicaciones compatibles con SSO.

• Para autenticar su agente, consulte Autenticación.

• Para obtener instrucciones sobre cómo crear el registro de aplicación de Microsoft Entra ID necesario, consulte Configurar la autenticación de usuario con Microsoft Entra ID. Al crear este registro, usted o el administrador deben especificar los ámbitos Sites.Read.All y Files.Read.All en el registro de aplicaciones de Microsoft Entra ID.

• Al seleccionar No authentication especifica que el agente no recupera información de SharePoint.

• Al configurar la autenticación, los ámbitos controlan el acceso de los usuarios. Especifique Sites.Read.All y Files.Read.All en el campo de ámbitos cerca de los valores existentes profile y openid en Copilot Studio. Estos ámbitos no conceden a los usuarios permisos mayores al usar el agente, pero permiten su contenido permitido desde el sitio de SharePoint tal como está configurado para respuestas generativas.

• SharePoint admite la configuración Authenticate manualmente con los siguientes proveedores de servicios de autenticación:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 con credenciales federadas
  • Microsoft Entra ID V2 con certificados
  • Microsoft Entra ID V2 con secretos de cliente

• SharePoint no admite la autenticación manual mediante OAuth genérico.

• Esta configuración solo se aplica a las respuestas generativas y no a los conectores de Power Platform.

Filtrar tu fuente de SharePoint

Los desarrolladores pueden mejorar el rendimiento del origen de conocimiento de SharePoint de su agente especificando parámetros para consultas de búsqueda. Estos parámetros de consulta definen lo que se busca dentro de la fuente de conocimiento. Por ejemplo, podrías especificar que solo quieres búsquedas de elementos que hayan sido modificados en los últimos seis meses. Este tipo de filtro se construiría como:

Crear condiciones de filtro

Después de agregar una SharePoint origen de conocimiento, puede establecer condiciones de búsqueda.

1. En la página Knowledge, seleccione el origen de SharePoint.

2. Seleccione los tres puntos (... ) para el origen de SharePoint y seleccione Edit.

3. Seleccione Configuración avanzada.

4. Compile los filtros para incluir o excluir información del origen de conocimiento de SharePoint. Puede basar el filtro en una de las siguientes selecciones:

   • Título
   • Autor
   • Modificado por
   • Fecha de modificación

5. Puede establecer el valor de la condición en uno de los siguientes valores:

   • Un valor estático
   • Una entrada de variable que el usuario proporciona durante la conversación con el agente, que luego se guarda como una variable global personalizada
   • Una variable del sistema

6. Seleccione Guardar cuando haya terminado de configurar sus filtros.

Más opciones de configuración para mejorar la búsqueda

Si desea filtrar el origen de SharePoint, debe desactivar las siguientes configuraciones:

• Búsqueda web
• En el nivel de agente, la opción Usar conocimientos generales en la configuración de IA Generativa del agente.
• En el nivel de tema, permitir que la inteligencia artificial use su propio conocimiento general (versión preliminar) en las respuestas generativas

Desactivar esta configuración garantiza que el agente responda con "sin respuesta" si no encuentra un resultado en el origen de conocimiento de SharePoint filtrado.