View a markdown version of this page

連接 Confluence 資料中心資料來源 - Amazon Bedrock
建立資料來源連接器參數變更身分驗證方法後續步驟

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

連接 Confluence 資料中心資料來源

設定 VPC 連線並將登入資料存放在 AWS Secrets Manager 秘密之後，請在知識庫中建立 Confluence 資料中心資料來源。此頁面說明如何使用 AWS 管理主控台 或 API 建立資料來源，後面接著您可以設定的連接器參數參考。

注意

首先完成 VPC 組態和身分驗證設定。請參閱 設定資料來源的 VPC 連線 和 設定 Confluence Data Center 的基本或 PAT 身分驗證。您需要 VPC 組態 ID 和秘密 ARN。

建立資料來源

Console
將 Confluence 資料中心連線至您的受管知識庫

  1. 在資料來源下，提供資料來源的名稱。

  2. 從資料來源下拉式清單中選取 Confluence 資料中心。

  3. 在 VPC 組態下，選取到達 Confluence 資料中心執行個體的 VPC 組態，或選擇新增 VPC 組態以建立組態。如需詳細資訊，請參閱設定資料來源的 VPC 連線。

  4. （選用） 在應用程式內容路徑下，輸入提供 Confluence 資料中心 REST API 的內容路徑 （例如，/wiki)。如果在 Web 根目錄提供 REST API，請將其保留空白。

  5. （選用，僅限 HTTPS) 在 TLS 憑證下，為您的 Confluence Data Center 執行個體提供 TLS 憑證的 Amazon S3 URI。

  6. 在身分驗證下，選取基本身分驗證或個人存取字符，然後選取存放相符憑證的 AWS Secrets Manager 秘密。

  7. （選用） 展開同步範圍以選擇要爬取的實體類型 （頁面、頁面附件、部落格、部落格附件、個人空間）。

  8. （選用） 展開實體 URLs以使用 URL 型篩選來同步特定的 Confluence 空間、頁面和部落格。

  9. （選用） 展開 Mime 類型以包含或排除特定 MIME 類型。

API

若要建立 Confluence Data Center 資料來源，請使用 Amazon Bedrock 建置時間端點的代理程式傳送 CreateDataSource 請求。下列 AWS Command Line Interface 範例會建立使用基本身分驗證的資料來源。若要改為使用個人存取字符，請將 authType變更為 PERSONAL_TOKEN。如需每個欄位的說明，請參閱以下連接器參數參考。

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

confluence-onprem-connector.json 檔案包含下列項目：

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

對於受管知識庫， CreateDataSource是非同步的：當操作完成CREATINGAVAILABLE時，資料來源狀態會從 轉換為 。

連接器參數

資料來源組態使用下列連接器參數。若要連線至 Confluence 資料中心，請在 中指定 CONFLUENCEONPREM做為連接器類型connectorParameters。如需包裝的欄位 connectorParameters（例如 deletionProtectionConfiguration和 mediaExtractionConfiguration)，請參閱 連接資料來源。

connectionConfiguration
欄位 必要 描述
authType 是 驗證類型。將 設定為 BASIC或 PERSONAL_TOKEN。請參閱 身分驗證方法。
secretArn 是 包含 Confluence 資料中心登入資料的 AWS Secrets Manager 秘密 ARN。
vpcConfiguration 是 Confluence 資料中心執行個體的私有網路路徑。包含設定為知識庫上 VPC 組態 ID vpcConfigurationId的欄位集。請參閱 設定資料來源的 VPC 連線。
contextPath 否 提供 Confluence 資料中心 REST API 的應用程式內容路徑 （例如，/wiki)。如果在 Web 根目錄提供 REST API，請將其省略。
certificateS3Path 否 透過 HTTPS 連線時所使用的 Confluence Data Center 執行個體的 TLS 憑證位置。包含 s3BucketName和 s3KeyName。
dataEntityConfiguration （選用）
欄位 必要 說明
crawlPage 否 是否要編目頁面。
crawlBlog 否 是否要編目部落格文章。
crawlPageAttachment 否 是否要編目頁面附件。只有在 crawlPage也是 時才會爬取true。
crawlBlogAttachment 否 是否要編目部落格文章附件。只有在 crawlBlog也是 時才會爬取true。
crawlPersonalSpace 否 是否要編目個人空間。
注意

與 Confluence Cloud 不同，Confluence 資料中心不支援編目封存空間或封存頁面。

filterConfiguration （選用）
欄位 必要 說明
inclusionSpaceUrls 否 要包含的空間 URLs。
inclusionPageUrls 否 要包含URLs。
inclusionMimeTypes 否 要包含的 MIME 類型。
exclusionMimeTypes 否 要排除的 MIME 類型。
maxFileSizeInMegaBytes 否 連接器擷取之任何單一檔案的大小上限，以 MB 為單位。提供 做為數值字串 （例如，"50")。

變更身分驗證方法

您可以使用 UpdateDataSource 操作或 ，使用新的 authType和包含相符登入資料的秘密來更新資料來源，以變更資料來源的身分驗證方法 （例如，從基本到個人存取字符） AWS 管理主控台。

後續步驟

建立資料來源之後，請同步資料來源，以將內容擷取到您的知識庫。如需詳細資訊，請參閱同步資料來源。