View a markdown version of this page

Conéctese a Microsoft SharePoint para obtener su base de conocimientos - Amazon Bedrock
Características admitidasRequisitos previosConfiguración de la conexión

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Conéctese a Microsoft SharePoint para obtener su base de conocimientos

importante

Para obtener una precisión de recuperación optimizada y una experiencia gestionada, recomendamos Amazon Bedrock Managed Knowledge Base.

Microsoft SharePoint es un servicio colaborativo basado en la web para trabajar en documentos, páginas web, sitios web, listas y más. Puede conectarse a la SharePoint instancia de su base de conocimientos de Amazon Bedrock mediante la consola de AWS administración de Amazon Bedrock o la CreateDataSource API (consulte los SDK compatibles con Amazon Bedrock y). AWS CLI

nota

SharePoint El conector de la fuente de datos está en versión preliminar y está sujeto a cambios.

Las fuentes de SharePoint datos de Microsoft no admiten datos multimodales, como tablas, gráficos, diagramas u otras imágenes.

Amazon Bedrock admite la conexión a instancias SharePoint en línea. Actualmente, no se OneNote admite el rastreo de documentos. Actualmente, solo el almacén vectorial Amazon OpenSearch Serverless está disponible para su uso con esta fuente de datos.

Existen límites en cuanto al número de archivos y MB por archivo que pueden rastrearse. Consulte Cuotas de las bases de conocimientos.

Características admitidas

  • Detección automática de los campos principales del documento

  • Inclusion/exclusion filtros de contenido

  • El contenido incremental se sincroniza para añadir, actualizar o eliminar contenido

  • Autenticación Microsoft Entra ID (credenciales de cliente OAuth2)

Requisitos previos

SharePoint (En línea)

importante

SharePoint App-Only Microsoft retiró la autenticación mediante Azure ACS el 2 de abril de 2026 y ya no funciona. En su lugar, utilice la autenticación Microsoft Entra ID (credenciales de cliente OAuth2). Al configurar la fuente de datos, configúrela enauthType. OAUTH2_CLIENT_CREDENTIALS

En su SharePoint (en línea), complete los siguientes pasos para configurar la autenticación de Microsoft Entra ID:

  • Toma nota de tu sitio SharePoint en línea URL/URLs. Por ejemplo, https://yourdomain.sharepoint.com/sites/mysite. La URL debe empezar por https y contener sharepoint.com. La URL de su sitio debe ser el SharePoint sitio real, no sharepoint.com/ o sites/mysite/home.aspx

  • Toma nota del nombre de dominio de tu instancia SharePoint en línea URL/URLs.

  • Copie su ID de inquilino de Microsoft 365. Puede encontrar su ID de inquilino en las propiedades de su portal de Microsoft Entra. Consulte Find your Microsoft 365 tenant ID para obtener más información.

  • Registra una aplicación en Microsoft Entra ID. Ve al centro de administración de Microsoft Entra, ve a Registros de aplicaciones y selecciona Nuevo registro. Anote el ID de la aplicación (cliente) y el ID del directorio (inquilino).

  • Configure los permisos de API para la aplicación registrada. Agregue Microsoft Graph → Permisos de aplicación →Sites.Read.All. A continuación, conceda el consentimiento del administrador a su organización.

  • Crea un secreto de cliente. Al registrar tu aplicación, ve a Certificados y secretos → Nuevo secreto de cliente. Copia el valor secreto inmediatamente, ya que no se volverá a mostrar.

  • Guarde el ID del inquilino, el ID del cliente y el secreto del cliente en AWS Secrets Manager. Su secreto debe contener los siguientes pares clave-valor:clientId,. clientSecret

Cuenta de AWS

En tu AWS cuenta, asegúrate de:

  • Almacenar sus credenciales de autenticación en un secreto de AWS Secrets Manager y tomar nota del nombre de recurso de Amazon (ARN) del secreto. Siga las instrucciones de la sección Configuración de la conexión que aparecen en esta página para incluir los pares clave-valor que deben incluirse en el secreto.

  • Incluye los permisos necesarios para conectarte a tu fuente de datos en la role/permissions política AWS Identity and Access Management (IAM) de tu base de conocimientos. Para obtener información sobre los permisos necesarios para agregar esta fuente de datos a tu IAM rol en la base de conocimientos, consulta Permisos para acceder a las fuentes de datos.

nota

Si usa la consola, puede ir AWS Secrets Manager a para agregar su secreto o usar un secreto existente como parte del paso de configuración de la fuente de datos. Puedes crear el IAM rol con todos los permisos necesarios para ti como parte de los pasos de la consola para crear una base de conocimientos. Una vez que haya configurado la fuente de datos y otras configuraciones, el IAM rol con todos los permisos necesarios se aplicará a su base de conocimientos específica.

Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. No recomendamos reutilizar las credenciales y los secretos en distintos orígenes de datos.

Configuración de la conexión

Para conectarse a su SharePoint instancia, debe proporcionar la información de configuración necesaria para que Amazon Bedrock pueda acceder a sus datos y rastrearlos. También debe seguir los Requisitos previos.

En esta sección se incluye un ejemplo de configuración para este origen de datos.

Para obtener más información sobre la detección automática de los campos del documento, inclusion/exclusion los filtros, la sincronización incremental y las credenciales de autenticación secretas y su funcionamiento, seleccione lo siguiente:

El conector del origen de datos detecta y rastrea automáticamente todos los campos de metadatos principales de sus documentos o del contenido. Por ejemplo, el conector del origen de datos puede rastrear el equivalente del cuerpo del documento de sus documentos, el título del documento, la fecha de creación o modificación del documento u otros campos principales que puedan aplicarse a los documentos.

importante

Si tu contenido incluye información confidencial, Amazon Bedrock puedes responder con información confidencial.

Puede aplicar operadores de filtrado a los campos de metadatos para mejorar aún más la relevancia de las respuestas. Por ejemplo, documente “epoch_modification_time” o el número de segundos transcurridos desde el 1 de enero de 1970 hasta que se actualizó el documento por última vez. Puede filtrar por los datos más recientes, donde “epoch_modification_time” es mayor que un número determinado. Para obtener más información sobre los operadores de filtrado que puede aplicar a los campos de metadatos, consulte Metadatos y filtrado.

Puede incluir o excluir el rastreo de determinado contenido. Por ejemplo, puede especificar un patrón de prefix/regular expresión de exclusión para omitir el rastreo de cualquier archivo que contenga la palabra «privado» en el nombre del archivo. También puedes especificar un patrón de prefix/regular expresión de inclusión para incluir determinadas entidades de contenido o tipos de contenido. Si especifica un filtro de inclusión y exclusión y ambos coinciden con un documento, el filtro de exclusión tiene prioridad y el documento no se rastrea.

Un ejemplo de patrón de expresiones regulares para excluir o filtrar archivos PDF que contienen la palabra “privado” en el nombre del archivo: ".*private.*\\.pdf".

Puede aplicar inclusion/exclusion filtros a los siguientes tipos de contenido:

  • Page: título de la página principal

  • Event: nombre del evento

  • File: nombre del archivo con su extensión para los archivos adjuntos y todos los archivos del documento

Actualmente, no se admite el rastreo de OneNote documentos.

El conector de fuentes de datos rastrea el contenido nuevo, modificado y eliminado cada vez que la fuente de datos se sincroniza con la base de conocimientos. Amazon Bedrock puede usar el mecanismo de la fuente de datos para realizar un seguimiento de los cambios en el contenido y rastrear el contenido que ha cambiado desde la última sincronización. Al sincronizar el origen de datos con la base de conocimientos por primera vez, todo el contenido se rastrea de forma predeterminada.

Para sincronizar tu fuente de datos con tu base de conocimientos, usa la StartIngestionJob API o selecciona tu base de conocimientos en la consola y selecciona Sincronizar en la sección de información general de la fuente de datos.

importante

Todos los datos que sincronice desde el origen de datos estarán disponibles para cualquier persona que tenga permisos bedrock:Retrieve para obtenerlos. Esto también puede incluir los datos con permisos de orígenes de datos controlados. Para obtener más información, consulte Permisos de la base de conocimientos.

Cuando utilices la autenticación Entra ID de Microsoft (OAUTH2_CLIENT_CREDENTIALS), tus credenciales de autenticación secretas AWS Secrets Manager deben incluir los siguientes pares clave-valor:

  • clientId: Application (client) ID from your Microsoft Entra ID app registration

  • clientSecret: client secret value from your Microsoft Entra ID app registration

nota

Tu clave secreta AWS Secrets Manager debe usar la misma región de tu base de conocimientos.

Console
Conecta una SharePoint instancia a tu base de conocimientos

  1. Siga los pasos que se indican en Creación de una base de conocimiento conectándola a un origen de datos de Bases de conocimiento de Amazon Bedrock y elija SharePoint como fuente de datos.

  2. Proporcione un nombre y una descripción opcional para el origen de datos.

  3. Proporcione su SharePoint sitio URL/URLs. Por ejemplo, para SharePoint Online,https://yourdomain.sharepoint.com/sites/mysite. La URL debe empezar por https y contener sharepoint.com. La URL de su sitio debe ser el SharePoint sitio real, no sharepoint.com/ o sites/mysite/home.aspx

  4. Proporciona el nombre de dominio de tu SharePoint instancia.

  5. En la sección Configuración avanzada, si lo desea, puede configurar lo siguiente:

    • Clave de KMS para el almacenamiento de datos transitorios: — Puedes cifrar los datos transitorios mientras los conviertes en incrustaciones con la clave de KMS predeterminada Clave administrada de AWS o con tu propia clave de KMS. Para obtener más información, consulte Cifrado del almacenamiento de datos transitorios durante la ingesta de datos.

    • Política de eliminación de datos: puede eliminar las incrustaciones vectoriales de su origen de datos que están almacenadas en el almacén de vectores de forma predeterminada u optar por conservar los datos del almacén de vectores.

  6. Proporciona la información de autenticación para conectarte a tu instancia. SharePoint Para la autenticación de Microsoft Entra ID:

    1. Proporcione el ID de inquilino. Puedes encontrar tu identificador de inquilino en las propiedades de tu centro de administración de Microsoft Entra.

    2. Ve AWS Secrets Manager a para añadir tus credenciales secretas o utiliza un nombre de recurso de Amazon (ARN) existente para el secreto que has creado. Tu secreto debe contener el ID de cliente y el secreto de cliente de tu registro en la aplicación Microsoft Entra ID.

  7. (Opcional) En la sección Análisis y fragmentación del contenido, puede personalizar la forma de analizar y fragmentar los datos. Para obtener más información sobre estas personalizaciones, consulte los siguientes recursos:

  8. Elige usar patrones de filters/regular expresiones para incluir o excluir cierto contenido. De lo contrario, se rastreará todo el contenido estándar.

  9. Continúe eligiendo un modelo de incrustación y un almacén de vectores. Para ver los pasos restantes, regrese a Creación de una base de conocimiento conectándola a un origen de datos de Bases de conocimiento de Amazon Bedrock y continúe desde allí después de conectar el origen de datos.

API

El siguiente es un ejemplo de una configuración para conectarse a SharePoint Internet para su base de conocimientos de Amazon Bedrock. La fuente de datos se configura mediante la API con el SDK AWS CLI o un SDK compatible, como Python. Después de llamar CreateKnowledgeBase, llamas CreateDataSource para crear tu fuente de datos con la información de conexión introducida. dataSourceConfiguration

Para obtener información sobre las personalizaciones que puede aplicar a la ingesta mediante la inclusión del campo vectorIngestionConfiguration opcional, consulte Personalización de la ingesta de un origen de datos.

AWS Command Line Interface

aws bedrock-agent create-data-source \
 --name "SharePoint Online connector" \
 --description "SharePoint Online data source connector for Amazon Bedrock to use content in SharePoint" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://sharepoint-bedrock-connector-configuration.json \
 --data-deletion-policy "DELETE"

Contenido de sharepoint-bedrock-connector-configuration.json

{
    "sharePointConfiguration": {
        "sourceConfiguration": {
            "tenantId": "888d0b57-69f1-4fb8-957f-e1f0bedf64de",
            "hostType": "ONLINE",
            "domain": "yourdomain",
            "siteUrls": [
                "https://yourdomain.sharepoint.com/sites/mysite"
            ],
            "authType": "OAUTH2_SHAREPOINT_APP_ONLY_CLIENT_CREDENTIALS",
            "credentialsSecretArn": "arn:aws::secretsmanager:your-region:secret:AmazonBedrock-SharePoint"
        },
        "crawlerConfiguration": {
            "filterConfiguration": {
                "type": "PATTERN",
                "patternObjectFilter": {
                    "filters": [
                        {
                            "objectType": "File",
                            "inclusionFilters": [
                                ".*\\.pdf"
                            ],
                            "exclusionFilters": [
                                ".*private.*\\.pdf"
                            ]
                        }
                    ]
                }
            }
        }
    },
    "type": "SHAREPOINT"
}
importante

SharePoint App-Only Microsoft retiró la autenticación mediante Azure ACS el 2 de abril de 2026. Utilice la autenticación Entra ID de Microsoft (OAUTH2_CLIENT_CREDENTIALS) tal y como se describe en los requisitos previos anteriores.

Con OAuth 2.0, puede autenticar y autorizar el acceso a SharePoint los recursos de los SharePoint conectores integrados con las bases de conocimiento.

Pre-requisites

En el SharePoint caso de la autenticación OAuth 2.0, asegúrate de:

  • Toma nota de tu sitio SharePoint en línea. URL/URLs Por ejemplo, https://yourdomain.sharepoint.com/sites/mysite. La URL debe empezar por https y contener sharepoint.com. La URL de su sitio debe ser el SharePoint sitio real, no sharepoint.com/ o sites/mysite/home.aspx

  • Toma nota del nombre de dominio de tu instancia SharePoint en línea URL/URLs.

  • Copie su ID de inquilino de Microsoft 365. Puede encontrar su ID de inquilino en las propiedades del portal de Microsoft Entra o en la aplicación OAuth.

    Anote el nombre de usuario y la contraseña de la SharePoint cuenta de administrador y copie el ID del cliente y el valor del secreto del cliente al registrar una aplicación.

    nota

    Para ver un ejemplo de aplicación, consulte Registro de una aplicación cliente en Microsoft Entra ID (anteriormente conocido como Azure Active Directory) en el sitio web de Microsoft Learn.

  • SharePoint Al registrar una aplicación, se requieren ciertos permisos de lectura para conectarse.

    • SharePoint: AllSites.Read (Delegado): lee los elementos de todas las colecciones de sitios

  • Es posible que tenga que desactivar Valores predeterminados de seguridad en el portal de Azure mediante un usuario administrador. Para obtener más información sobre la administración de la configuración predeterminada de seguridad en el portal de Azure, consulte la documentación de Microsoft sobre cómo establecer los valores predeterminados enable/disable de seguridad.

  • Es posible que tenga que desactivar la autenticación multifactor (MFA) en su SharePoint cuenta para no impedir que Amazon Bedrock rastree su contenido. SharePoint

Para cumplir los requisitos previos, asegúrese de haber realizado los pasos que se detallan en Cuenta de AWS.

Credenciales de autenticación secretas

Para configurar la conexión OAuth2.0, puede realizar los mismos pasos para la detección automática de los campos principales del documento, los inclusion/exclusion filtros y la sincronización incremental que se describen en. Configuración de la conexión

Para la autenticación OAuth 2.0, sus credenciales de autenticación secretas AWS Secrets Manager deben incluir estos pares clave-valor.

  • username: SharePoint admin username

  • password: SharePoint admin password

  • clientId: OAuth app client ID

  • clientSecret: OAuth app client secret

Conecta una SharePoint instancia a tu base de conocimientos

Para conectar una SharePoint instancia a tu base de conocimientos cuando utilices OAuth2.0:

  • (consola) En la consola, sigue los mismos pasos que se describen en Conectar una SharePoint instancia a tu base de conocimientos. Cuando quieras proporcionar la información de autenticación para conectarte a tu SharePoint instancia.

    • Proporcione el ID de inquilino. Puede encontrar su ID de inquilino en las propiedades del portal de Azure Active Directory.

    • Ve AWS Secrets Manager a para añadir tus credenciales de autenticación secretas o utiliza un nombre de recurso de Amazon (ARN) existente para el secreto que has creado. Tu secreto debe contener el nombre de usuario y la contraseña del SharePoint administrador, así como el ID de cliente y el secreto de cliente de la aplicación registrada. Para ver un ejemplo de aplicación, consulte Registro de una aplicación cliente en Microsoft Entra ID (anteriormente conocido como Azure Active Directory) en el sitio web de Microsoft Learn.

  • (API) El siguiente es un ejemplo del uso de la CreateDataSource API para crear la fuente de datos con la información de conexión para OAuth2.0.

    aws bedrock-agent create-data-source \
 --name "SharePoint Online connector" \
 --description "SharePoint Online data source connector for Amazon Bedrock to use content in SharePoint" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://sharepoint-bedrock-connector-configuration.json \
 --data-deletion-policy "DELETE"

    Contenido de sharepoint-bedrock-connector-configuration.json

    {
    "sharePointConfiguration": {
        "sourceConfiguration": {
            "tenantId": "888d0b57-69f1-4fb8-957f-e1f0bedf64de",
            "hostType": "ONLINE",
            "domain": "yourdomain",
            "siteUrls": [
                "https://yourdomain.sharepoint.com/sites/mysite"
            ],
            "authType": "OAUTH2_CLIENT_CREDENTIALS",
            "credentialsSecretArn": "arn:aws::secretsmanager:your-region:secret:AmazonBedrock-SharePoint"
        },
        "crawlerConfiguration": {
            "filterConfiguration": {
                "type": "PATTERN",
                "patternObjectFilter": {
                    "filters": [
                        {
                            "objectType": "File",
                            "inclusionFilters": [
                                ".*\\.pdf"
                            ],
                            "exclusionFilters": [
                                ".*private.*\\.pdf"
                            ]
                        }
                    ]
                }
            }
        }
    },
    "type": "SHAREPOINT"
}