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

Tras configurar la autenticación y almacenar las credenciales en AWS Secrets Manager secreto, cree la fuente de datos de Confluence en su 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, seguido de una referencia sobre los parámetros del conector que puedes configurar.

nota

Complete primero la configuración de autenticación. Consulte Configurar la autenticación básica para Confluence o Configurar la autenticación OAuth 2.0 para Confluence. 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 Autenticación básica o Autenticación OAuth 2.0.

  5. Selecciona o crea un AWS Secrets Manager secreto para almacenar tus 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 seleccione 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 desea 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 el URL-based filtrado y 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 CreateDataSourcesolicitud con un punto final de 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 utilizar OAuth 2.0 en su lugar, cambie authType a. OAUTH2 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 siguiente referencia de parámetros del conector.

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 gestionadas, CreateDataSource es asíncrono: 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 utiliza los siguientes parámetros de conector. Para conectarse a Confluence, especifique CONFLUENCE el tipo de conector. connectorParameters Para ver los campos que lo connectorParameters rodean (como deletionProtectionConfiguration ymediaExtractionConfiguration), consulteConexión de un origen de datos.

Establezca una ACL habilitada de forma explícita

Si lo 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 una vez creada la fuente de datos, configúrela de aclEnabled forma explícita para que la fuente de datos tenga el comportamiento de control de acceso deseado. 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 despliegue de Confluence. Configurado en SAAS. No se admiten el servidor y el centro de datos de Confluence.
authType Sí El tipo de autenticación. Establézcalo en 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 del blog. crawlBlogSe arrastraba solo cuando también lo era. true
crawlArchivedSpace No Si se debe rastrear o no 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 de espacio para incluir.
inclusionSpaceUrls No Espacie las direcciones URL que desee incluir.
inclusionMimeTypes No Tipos de MIME que se van a incluir.
exclusionMimeTypes No Tipos de MIME que se van a excluir.
maxFileSizeInMegaBytes No Tamaño máximo, en megabytes, de cualquier archivo individual que ingiera el conector. Introdúzcalo 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á habilitado. trueConfigúrelo para habilitar o false deshabilitar. Si omite este campo, el valor predeterminado depende deauthType: el BASIC valor predeterminado estrue; el valor OAUTH2 predeterminado es. false ACL on BASIC requiere un secreto que incluya las credenciales de administrador de la organización de Atlassian. No puede 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 con la nueva authType y un secreto que contenga las credenciales coincidentes, mediante la UpdateDataSourceoperación o la. Consola de administración de AWS La configuración de control de acceso a nivel de documento se fija al crear una fuente de datos, por lo que para añadir o eliminar las ACL hay que crear una nueva fuente de datos.

Siguientes pasos

Tras crear la fuente de datos, sincronícela para incorporar el contenido a su 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.