View a markdown version of this page

Conecte uma fonte de dados do Confluence Data Center - Amazon Bedrock
Crie a fonte de dadosParâmetros do conectorAlterar o método de autenticaçãoPróximas etapas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conecte uma fonte de dados do Confluence Data Center

Depois de configurar a conectividade VPC e armazenar suas credenciais em AWS Secrets Manager segredo, crie a fonte de dados do Confluence Data Center em sua base de conhecimento. Esta página descreve como criar a fonte de dados com a Console de gerenciamento da AWS ou a API, seguida por uma referência para os parâmetros do conector que você pode configurar.

nota

Conclua primeiro a configuração da VPC e a configuração da autenticação. Consulte Configurar a conectividade VPC para uma fonte de dados e Configurar a autenticação básica ou PAT para o Confluence Data Center. Você precisa do ID de configuração da VPC e do ARN secreto.

Crie a fonte de dados

Console
Para conectar o Confluence Data Center à sua base de conhecimento gerenciada

  1. Em Fonte de dados, forneça um nome para sua fonte de dados.

  2. Selecione Confluence Data Center no menu suspenso da fonte de dados.

  3. Em Configuração de VPC, selecione uma configuração de VPC que alcance sua instância do Confluence Data Center ou escolha Adicionar configuração de VPC para criar uma. Para obter detalhes, consulte Configurar a conectividade VPC para uma fonte de dados.

  4. (Opcional) Em Caminho de contexto do aplicativo, insira o caminho do conteúdo sob o qual a API REST do Confluence Data Center é fornecida (por exemplo,/wiki). Deixe-o vazio se a API REST for veiculada na raiz da web.

  5. (Opcional, somente HTTPS) No certificado TLS, forneça o URI Amazon S3 do certificado TLS para sua instância do Confluence Data Center.

  6. Em Autenticação, selecione Autenticação básica ou Token de acesso pessoal e, em seguida, selecione o AWS Secrets Manager segredo que contém as credenciais correspondentes.

  7. (Opcional) Expanda o escopo de sincronização para escolher quais tipos de entidade rastrear (páginas, anexos de páginas, blogs, anexos de blog, espaços pessoais).

  8. (Opcional) Expanda os URLs das entidades para usar a URL-based filtragem para sincronizar espaços, páginas e blogs específicos do Confluence.

  9. (Opcional) Expanda os tipos MIME para incluir ou excluir tipos MIME específicos.

API

Para criar uma fonte de dados do Confluence Data Center, envie uma CreateDataSource solicitação com um endpoint de tempo de construção Agents for Amazon Bedrock. O AWS Command Line Interface exemplo a seguir cria uma fonte de dados que usa a autenticação básica. Em vez disso, para usar um token de acesso pessoal, authType mude paraPERSONAL_TOKEN. Para obter uma descrição de cada campo, consulte a referência de parâmetros do conector a seguir.

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

O confluence-onprem-connector.json arquivo contém o seguinte:

{
    "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/"]
            }
        }
    }
}

Para bases de conhecimento gerenciadas, CreateDataSource é assíncrono: o status da fonte de dados muda de CREATING para AVAILABLE quando a operação é concluída.

Parâmetros do conector

A configuração da fonte de dados usa os seguintes parâmetros do conector. Para se conectar ao Confluence Data Center, especifique CONFLUENCEONPREM como o conector digitado. connectorParameters Para os campos que envolvem connectorParameters (como deletionProtectionConfiguration emediaExtractionConfiguration), consulteConectar uma fonte de dados.

connectionConfiguration
Campo Obrigatório Descrição
authType Sim O tipo de autenticação. Definido como BASIC ouPERSONAL_TOKEN. Consulte Métodos de autenticação.
secretArn Sim O ARN do AWS Secrets Manager segredo contendo suas credenciais do Confluence Data Center.
vpcConfiguration Sim O caminho da rede privada para sua instância do Confluence Data Center. Contém um vpcConfigurationId campo definido com o ID de uma configuração de VPC em sua base de conhecimento. Consulte Configurar a conectividade VPC para uma fonte de dados.
contextPath Não O caminho de contexto do aplicativo no qual a API REST do Confluence Data Center é fornecida (por exemplo,/wiki). Omita-o se a API REST for veiculada na raiz da web.
certificateS3Path Não A localização do certificado TLS para sua instância do Confluence Data Center, usada quando você se conecta por HTTPS. Contém s3BucketName s3KeyName e.
dados EntityConfiguration (opcional)
Campo Obrigatório Description
crawlPage Não Se você deve rastrear páginas.
crawlBlog Não Se você deve rastrear as postagens do blog.
crawlPageAttachment Não Se deve rastrear os anexos da página. Rastejou somente quando também crawlPage está. true
crawlBlogAttachment Não Se você deve rastrear anexos de postagens do blog. Rastejou somente quando também crawlBlog está. true
crawlPersonalSpace Não Seja para vasculhar espaços pessoais.
nota

Ao contrário do Confluence Cloud, o Confluence Data Center não suporta o rastreamento de espaços arquivados ou páginas arquivadas.

Configuração do filtro (opcional)
Campo Obrigatório Description
inclusionSpaceUrls Não URLs de espaço a serem incluídos.
inclusionPageUrls Não URLs de página a serem incluídos.
inclusionMimeTypes Não Tipos de MIME a serem incluídos.
exclusionMimeTypes Não Tipos de MIME a serem excluídos.
maxFileSizeInMegaBytes Não Tamanho máximo, em megabytes, de qualquer arquivo individual que o conector ingere. Forneça como uma string numérica (por exemplo,"50").

Alterar o método de autenticação

Você pode alterar o método de autenticação de uma fonte de dados (por exemplo, do token de acesso básico para o pessoal) atualizando a fonte de dados com o novo authType e um segredo que contém as credenciais correspondentes, usando a UpdateDataSource operação ou o. Console de gerenciamento da AWS

Próximas etapas

Depois de criar a fonte de dados, sincronize-a para ingerir conteúdo em sua base de conhecimento. Para obter mais detalhes, consulte Sincronizar uma fonte de dados.