View a markdown version of this page

Conectar una fuente de datos de Confluence - Amazon Bedrock
Crea la fuente de datosParámetros de conectorCambie el método de autenticaciónSiguientes pasos

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.

Conectar una fuente de datos de Confluence

Después de configurar la autenticación y almacenar tus credenciales en AWS Secrets Manager secreto, crea la fuente de datos de Confluence en tu base de conocimientos. En esta página, se describe cómo crear la fuente de datos con la API Consola de administración de AWS o la API, y se incluye una referencia para los parámetros del conector que puedes configurar.

nota

Complete primero la configuración de la autenticación. Consulte User-managed configuración (3LO) (la más simple)Configurar la autenticación básica para Confluence, oConfigurar la autenticación OAuth 2.0 para Confluence. En el caso de la configuración gestionada por el usuario (3LO), debes iniciar sesión a través de la consola y Amazon Bedrock crea el secreto automáticamente (con un ARN generado por el sistema); tú proporcionas la URL del host de Confluence, pero no un secreto. Para los demás métodos, necesitas el ARN secreto y la URL del host de Confluence.

Crea la fuente de datos

Console
Para conectar Confluence a tu base de conocimientos gestionada

  1. En Fuente de datos, proporciona un nombre para tu fuente de datos.

  2. Selecciona Confluence en el menú desplegable de fuentes de datos.

  3. En Fuente, introduce tu URL de Confluence (por ejemplo,). https://example.atlassian.net

  4. En Autenticación, selecciona User-managed Configuración (3LO), Autenticación básica o Autenticación OAuth 2.0. Para la configuración gestionada por el usuario (3LO), si lo desea, introduzca un prefijo de nombre secreto y, a continuación, seleccione Iniciar sesión para iniciar sesión en Confluence Cloud. No proporcionas ningún secreto. Amazon Bedrock crea un secreto con un ARN generado por el sistema para almacenar el token. Para obtener más información, consulte User-managed configuración (3LO).

  5. Seleccione o cree un AWS Secrets Manager secreto para almacenar sus credenciales.

  6. (Opcional, solo autenticación básica) Para habilitar el control de acceso a nivel de documento, seleccione Controlar el acceso a los documentos con ACL. El secreto que selecciones debe incluiradminApiKey, y. organizationId directoryId Esta opción no se puede cambiar después de la creación. Para obtener más información, consulte Document-level controles de acceso.

  7. (Opcional) Amplíe el alcance de la sincronización para elegir qué tipos de entidades rastrear (páginas, blogs, archivos adjuntos de páginas, archivos adjuntos de blogs, espacios archivados, páginas archivadas, espacios personales).

  8. (Opcional) Amplía las URL de las entidades para usar los URL-based filtros para sincronizar espacios, páginas y blogs específicos de Confluence.

  9. (Opcional) Amplía el patrón de expresiones regulares de los tipos MIME para incluir o excluir tipos MIME específicos.

API

Para crear una fuente de datos de Confluence, envía una CreateDataSource solicitud a un punto final en tiempo de compilación de Agents for Amazon Bedrock. En el siguiente AWS Command Line Interface ejemplo, se crea una fuente de datos que utiliza la autenticación básica. Para usar OAuth 2.0 en su lugar, cambie authType a. OAUTH2 Para la configuración gestionada por el usuario (3LO), configúrela en. authType MANAGED_OAUTH2 No puedes crear un secreto de 3LO a través de la API: primero inicia sesión en la consola para crear el secreto y, a continuación, establece secretArn el ARN de ese secreto (consulta). User-managed configuración (3LO) Para habilitar el control de acceso a nivel de documento, configúrelo en. aclEnabled true Para obtener una descripción de cada campo, consulte la referencia a los parámetros del conector que aparece a continuación.

aws bedrock-agent create-data-source \
 --name "Confluence-connector" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://confluence-managed-connector.json

El confluence-managed-connector.json archivo contiene lo siguiente:

{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "CONFLUENCE",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-basic-creds",
                "type": "SAAS",
                "authType": "BASIC",
                "hostUrl": "https://example.atlassian.net"
            },
            "dataEntityConfiguration": {
                "crawlPage": true,
                "crawlBlog": true,
                "crawlPageAttachment": true,
                "crawlBlogAttachment": true
            },
            "filterConfiguration": {
                "inclusionSpaceKeys": ["ENG", "DOCS"]
            }
        }
    }
}

En el caso de las bases de conocimiento administradas, CreateDataSource es asincrónico: el estado de la fuente de datos pasa de CREATING a AVAILABLE cuando se completa la operación.

Parámetros de conector

La configuración de la fuente de datos usa los siguientes parámetros de conector. Para conectarse a Confluence, especifique CONFLUENCE el tipo de conector. connectorParameters Para ver los campos que se connectorParameters agrupan (como deletionProtectionConfiguration ymediaExtractionConfiguration), consultaConexión de un origen de datos.

Establezca AclEnabled explícitamente

Si se omiteaclEnabled, el valor predeterminado depende deauthType: el valor predeterminado es y el BASIC valor predeterminado es. true OAUTH2 false Como la configuración de la ACL es permanente después de crear la fuente de datos, configúrela aclEnabled explícitamente para que la fuente de datos tenga el comportamiento de control de acceso que desea. Para obtener más información, consulte Document-level controles de acceso.

connectionConfiguration
Campo Obligatorio Descripción
secretArn Sí El ARN del AWS Secrets Manager secreto que contiene tus credenciales de Confluence.
type Sí El tipo de implementación de Confluence. Configurado en SAAS. El servidor y el centro de datos de Confluence no son compatibles.
authType Sí El tipo de autenticación. MANAGED_OAUTH2Establézcalo en (configuración gestionada por el usuario, 3LO), BASIC o. OAUTH2 Consulte Métodos de autenticación.
hostUrl Sí La URL base de tu instancia de Confluence Cloud (por ejemplo,). https://example.atlassian.net
datos EntityConfiguration (opcional)
Campo Obligatorio Description (Descripción)
crawlPage No Si se deben rastrear las páginas.
crawlBlog No Si se deben rastrear las publicaciones del blog.
crawlPageAttachment No Si se deben rastrear los archivos adjuntos de la página. Se rastrea solo cuando también lo crawlPage es. true
crawlBlogAttachment No Si se deben rastrear los archivos adjuntos de las publicaciones de blog. Se rastrea solo cuando también lo crawlBlog es. true
crawlArchivedSpace No Si se deben rastrear los espacios archivados.
crawlArchivedPage No Si se deben rastrear las páginas archivadas.
crawlPersonalSpace No Si se deben rastrear los espacios personales.
Configuración del filtro (opcional)
Campo Obligatorio Description (Descripción)
inclusionSpaceKeys No Teclas espaciadoras para incluir.
inclusionSpaceUrls No Espacie las URL que desea incluir.
inclusionMimeTypes No Tipos MIME que se van a incluir.
exclusionMimeTypes No Tipos MIME que se van a excluir.
maxFileSizeInMegaBytes No Tamaño máximo, en megabytes, de cualquier archivo individual que ingiera el conector. Proporciónelo como cadena numérica (por ejemplo,). "500" El valor predeterminado es "500".
AclEnabled (opcional)
Campo Obligatorio Description (Descripción)
aclEnabled No Si el control de acceso a nivel de documento está activado. trueConfigúrelo para habilitarlo o false para deshabilitarlo. Si omite este campo, el valor predeterminado depende deauthType: el BASIC valor predeterminado estrue; el valor OAUTH2 predeterminado es. false La ACL activada BASIC requiere un secreto que incluya las credenciales de administrador de la organización de Atlassian. No puedes cambiar esta configuración después de crear la fuente de datos. Para obtener más información, consulte Document-level controles de acceso.

Cambie el método de autenticación

Puede cambiar el método de autenticación de una fuente de datos (por ejemplo, de OAuth 2.0 a Basic) actualizando la fuente de datos por la nueva authType y por una secreta que contenga las credenciales coincidentes, mediante la UpdateDataSource operación o la. Consola de administración de AWS La configuración de control de acceso a nivel de documento es fija al crear una fuente de datos, por lo que para agregar o eliminar las ACL, debe crear una nueva fuente de datos.

Siguientes pasos

Después de crear la fuente de datos, sincronícela para incorporar contenido a la base de conocimientos. Para obtener más información, consulte Sincronización de un origen de datos. Para filtrar los resultados de las consultas por permisos de usuario, consulteDocument-level controles de acceso.