View a markdown version of this page

Conectar una fuente de datos de Confluence Data Center - 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 Data Center

Tras configurar la conectividad de la VPC y almacenar tus credenciales de forma AWS Secrets Manager secreta, crea la fuente de datos del centro 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 VPC y la configuración de la autenticación. Consulte Configurar la conectividad de VPC para una fuente de datos y Configurar la autenticación básica o PAT para Confluence Data Center. Necesitas el ID de configuración de la VPC y el ARN secreto.

Crea la fuente de datos

Console
Para conectar Confluence Data Center a tu base de conocimientos gestionada

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

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

  3. En Configuración de VPC, selecciona una configuración de VPC que llegue a tu instancia de Confluence Data Center o elige Agregar configuración de VPC para crear una. Para obtener más información, consulte Configurar la conectividad de VPC para una fuente de datos.

  4. (Opcional) En la ruta del contexto de la aplicación, introduce la ruta de contenido en la que se ofrece la API REST del centro de datos de Confluence (por ejemplo,). /wiki Déjala vacía si la API REST se publica en la raíz web.

  5. (Opcional, solo HTTPS) En el certificado TLS, proporciona el URI de Amazon S3 del certificado TLS de tu instancia de centro de datos de Confluence.

  6. En Autenticación, selecciona Autenticación básica o Token de acceso personal y, a continuación, selecciona el AWS Secrets Manager secreto que contiene las credenciales coincidentes.

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

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

  9. (Opcional) Amplía los tipos MIME para incluir o excluir tipos MIME específicos.

API

Para crear una fuente de datos para el centro de datos de Confluence, envía una CreateDataSource solicitud a un punto final en tiempo de construcció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 un token de acceso personal en su lugar, authType cámbielo aPERSONAL_TOKEN. 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-DataCenter-connector" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://confluence-onprem-connector.json

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

{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "CONFLUENCEONPREM",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "authType": "BASIC",
                "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-onprem-creds",
                "contextPath": "/wiki",
                "vpcConfiguration": {
                    "vpcConfigurationId": "your-vpc-configuration-id"
                },
                "certificateS3Path": {
                    "s3BucketName": "my-cert-bucket",
                    "s3KeyName": "confluence-dc-cert.pem"
                }
            },
            "dataEntityConfiguration": {
                "crawlPage": true,
                "crawlBlog": true,
                "crawlPageAttachment": true,
                "crawlBlogAttachment": true
            },
            "filterConfiguration": {
                "inclusionSpaceUrls": ["https://confluence.example.com/spaces/ENG/"]
            }
        }
    }
}

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 conectarte al centro de datos de Confluence, CONFLUENCEONPREM especifícalo como tipo de conector. connectorParameters Para ver los campos que se connectorParameters agrupan (como deletionProtectionConfiguration ymediaExtractionConfiguration), consulteConexión de un origen de datos.

connectionConfiguration
Campo Obligatorio Descripción
authType Sí El tipo de autenticación. Establézcalo en BASIC oPERSONAL_TOKEN. Consulte Métodos de autenticación.
secretArn Sí El ARN del AWS Secrets Manager secreto que contiene tus credenciales de Confluence Data Center.
vpcConfiguration Sí La ruta de red privada a tu instancia de centro de datos de Confluence. Contiene un vpcConfigurationId campo establecido con el ID de una configuración de VPC en tu base de conocimientos. Consulte Configurar la conectividad de VPC para una fuente de datos.
contextPath No La ruta del contexto de la aplicación en la que se ofrece la API REST del centro de datos de Confluence (por ejemplo,/wiki). Ovítela si la API REST se ofrece en la raíz web.
certificateS3Path No La ubicación del certificado TLS de tu instancia de centro de datos de Confluence, que se usa cuando te conectas a través de HTTPS. Contiene s3BucketName y. s3KeyName
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
crawlPersonalSpace No Ya sea para rastrear espacios personales.
nota

A diferencia de Confluence Cloud, Confluence Data Center no permite rastrear espacios archivados ni páginas archivadas.

Configuración del filtro (opcional)
Campo Obligatorio Description (Descripción)
inclusionSpaceUrls No Espacie las URL para incluirlas.
inclusionPageUrls No URL de página que se van a 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,). "50"

Cambie el método de autenticación

Puede cambiar el método de autenticación de una fuente de datos (por ejemplo, pasar de un token de acceso básico a uno personal) 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.

Siguientes pasos

Tras crear la fuente de datos, sincronícela para incorporar contenido a la base de conocimientos. Para obtener información, consulte Sincronización de un origen de datos.