View a markdown version of this page

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

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

連接 SharePoint 資料來源

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

注意

請先完成身分驗證設定。請參閱 設定 SharePoint 的 Microsoft Entra ID 僅限應用程式身分驗證（建議） 或 設定 SharePoint 的 OAuth 2.0 身分驗證。您需要憑證的秘密 ARN、租戶 ID 和 （僅限 Microsoft Entra ID 應用程式身分驗證） Amazon S3 位置。

建立資料來源

Console
將 SharePoint 連線至受管知識庫

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

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

  3. 在來源下，輸入您的網站 URLs。每個 URL 必須以 開頭https://，並指向網站、團隊網站或個人網站 （例如 https://contoso.sharepoint.com/sites/engineering)。最多可以新增 100 個 URL。

  4. 在身分驗證下，選取 Microsoft Entra ID 僅限應用程式或 OAuth 2.0 身分驗證。

  5. 選取或建立 AWS Secrets Manager 秘密以存放您的登入資料。

  6. 輸入您的租用戶 ID。

  7. 如果您選取 Microsoft Entra ID 僅限應用程式身分驗證，請提供憑證路徑：.p12憑證檔案的 Amazon S3 路徑。

  8. （選用） 若要啟用文件層級存取控制，請選取使用 ACLs 控制文件存取。此選項僅適用於 Microsoft Entra ID 僅限應用程式身分驗證，建立後無法變更。如需詳細資訊，請參閱文件層級存取控制。

  9. （選用） 展開同步範圍以設定要抓取的內容 （檔案、頁面）。

  10. （選用） 展開日期型實體同步以指定日期篩選條件。

  11. （選用） 展開項目路徑模式，以新增特定路徑來篩選要爬取的項目。

API

若要建立 SharePoint 資料來源，請使用 Amazon Bedrock 的 Agents 建置時間端點傳送 CreateDataSource 請求。下列 AWS Command Line Interface 範例會建立使用 Microsoft Entra ID 僅應用程式身分驗證的資料來源。若要啟用文件層級存取控制，請將 aclEnabled設定為 true。如需每個欄位的說明，請參閱以下連接器參數參考。

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

sharepoint-managed-connector.json 檔案包含下列項目：

{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "SHAREPOINT",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-sharepoint-creds",
                "tenantId": "12345678-1234-1234-1234-123456789012",
                "authType": "ENTRA_ID_APP_ONLY",
                "certificateS3Path": {
                    "s3BucketName": "your-certificate-bucket",
                    "s3KeyName": "certs/certificate.p12"
                }
            },
            "dataEntityConfiguration": {
                "crawlFiles": true,
                "crawlPages": true,
                "siteUrls": [
                    "https://contoso.sharepoint.com/sites/engineering"
                ]
            }
        }
    }
}

對於OAUTH2_APP資料來源，將 authType 設定為 OAUTH2_APP並省略 certificateS3Path。

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

連接器參數

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

connectionConfiguration
欄位 必要 描述
secretArn 是 包含 SharePoint 登入資料的 AWS Secrets Manager 秘密 ARN。
tenantId 是 Microsoft Entra (Azure AD) 租用戶 ID。
authType 是 身分驗證類型： ENTRA_ID_APP_ONLY（建議） 或 OAUTH2_APP。請參閱 身分驗證方法。
certificateS3Path 有條件 即使停用 ACLs，身分ENTRA_ID_APP_ONLY驗證仍為必要。包含 s3KeyName Amazon S3 中憑證檔案的 s3BucketName和 。未與 搭配使用OAUTH2_APP。
dataEntityConfiguration
欄位 必要 描述
siteUrls 是 要爬取的 SharePoint 網站 URLs 清單。每個 URL 都是爬蟲進入點，必須以 開頭https://並指向網站、團隊網站或個人網站，路徑必須以 /sites/、 開頭/teams/，或以網站名稱 （例如 ) /personal/ 開頭https://contoso.sharepoint.com/sites/engineering。同時支援標準*.sharepoint.com網域和自訂 （虛設） 網域。在每個網站中，連接器會編目檔案和頁面 （請參閱 crawlFiles 和 crawlPages)；若要以特定項目為目標，請使用 inclusionItemPaths。
crawlFiles 否 是否要編目檔案。預設為 true。
crawlPages 否 是否要編目頁面。預設為 true。
filterConfiguration （選用）
欄位 必要 說明
modifiedDateBefore 否 僅包含在此日期之前修改的內容 (ISO 8601)。
modifiedDateAfter 否 僅包含在此日期之後修改的內容 (ISO 8601)。
inclusionItemPaths 否 要包含的特定項目路徑。當您提供 時inclusionItemPaths，連接器會編目這些項目，而不會驗證 siteUrls。
aclEnabled （選用）
欄位 必要 說明
aclEnabled 否 設定為 true以啟用文件層級存取控制。需要ENTRA_ID_APP_ONLY身分驗證。您無法在建立資料來源後變更此設定。如需詳細資訊，請參閱文件層級存取控制。

變更身分驗證方法

您可以使用 UpdateDataSource 操作或 ，透過使用新的 authType和 登入資料更新資料來源，來變更資料來源的身分驗證方法 （例如，從 OAuth 2.0 變更為僅限 Microsoft Entra ID 應用程式） AWS 管理主控台。文件層級存取控制設定會在您建立資料來源時修正，因此若要新增或移除 ACLs，您必須建立新的資料來源。

後續步驟

建立資料來源之後，請同步資料來源，以將內容擷取到您的知識庫。如需詳細資訊，請參閱同步資料來源。若要依使用者許可篩選查詢結果，請參閱 文件層級存取控制。