連接 Google Drive 資料來源

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

注意

請先完成身分驗證設定。請參閱設定 Google Drive 的服務帳戶身分驗證（建議）或設定 Google Drive 的 OAuth 2.0 身分驗證。您需要秘密 ARN。

建立資料來源

Console

將 Google Drive 連線至您的受管知識庫

在資料來源下，提供資料來源的名稱。
從資料來源下拉式清單中選取 Google Drive。
在身分驗證下，選取 Google 服務帳戶或 OAuth 2.0 身分驗證。
選取或建立 AWS Secrets Manager 秘密以存放您的登入資料。
（選用，僅限服務帳戶）若要啟用文件層級存取控制，請選取使用 ACLs 控制文件存取。此選項無法在建立後變更。如需詳細資訊，請參閱文件層級存取控制。
（選用）展開同步範圍以選擇要爬取的磁碟機（我的磁碟機、與我共用、共用磁碟機）。
（選用）展開共用磁碟機以新增要包含或排除IDs。
（選用，僅限 OAuth 2.0) 展開特定資料夾和檔案以新增要包含的資料夾或檔案 IDs。
（選用）展開 Mime 類型 regex 模式，以包含或排除特定 MIME 類型。
（選用）展開日期型實體同步以指定日期篩選條件。

API

若要建立 Google Drive 資料來源，請使用 Amazon Bedrock 建置時間端點的代理程式傳送 CreateDataSource 請求。下列 AWS Command Line Interface 範例會建立使用服務帳戶身分驗證的資料來源。若要使用 OAuth 2.0，請將 authType變更為 OAUTH2。若要啟用文件層級存取控制，請將 aclEnabled設定為 true。如需每個欄位的說明，請參閱以下連接器參數參考。


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

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


{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "GOOGLEDRIVE",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-google-drive-sa-creds",
                "authType": "SERVICE_ACCOUNT"
            },
            "dataEntityConfiguration": {
                "crawlMyDrive": true,
                "crawlSharedWithMe": true,
                "crawlSharedDrives": false
            },
            "filterConfiguration": {
                "inclusionMimeTypes": ["application/pdf"]
            }
        }
    }
}

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

連接器參數

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

aclEnabled 明確設定

如果您省略 aclEnabled，預設值取決於 authType：SERVICE_ACCOUNT預設值為 true，OAUTH2預設值為 false。由於 ACL 組態在資料來源建立後是永久的，因此aclEnabled請明確設定，讓資料來源具有您想要的存取控制行為。如需詳細資訊，請參閱文件層級存取控制。

connectionConfiguration
欄位	必要	描述
`secretArn`	是	包含 Google Drive 登入資料的 AWS Secrets Manager 秘密 ARN。
`authType`	是	身分驗證類型： `SERVICE_ACCOUNT`（建議）或 `OAUTH2`。請參閱身分驗證方法。

dataEntityConfiguration （選用）
欄位	必要	說明
`crawlMyDrive`	否	是否編目已驗證使用者的個人磁碟機。
`crawlSharedWithMe`	否	是否編目與已驗證使用者共用的檔案。
`crawlSharedDrives`	否	是否要爬取共用磁碟機。

filterConfiguration （選用）
欄位	必要	說明
`inclusionSharedDriveIds`	否	要包含IDs。
`exclusionSharedDriveIds`	否	要排除IDs。
`inclusionMimeTypes`	否	要包含的 MIME 類型。
`exclusionMimeTypes`	否	要排除的 MIME 類型。
`inclusionFolderIds`	否	要包含IDs。僅適用於身分`OAUTH2`驗證。
`inclusionFileIds`	否	要包含的檔案 IDs。僅適用於身分`OAUTH2`驗證。
`inclusionSharedFolderIds`	否	要包含IDs。僅適用於身分`OAUTH2`驗證。
`inclusionSharedFileIds`	否	要包含IDs。僅適用於身分`OAUTH2`驗證。
`modifiedDateBefore`	否	僅包含在此日期之前修改的內容 (ISO 8601)。
`modifiedDateAfter`	否	僅包含在此日期之後修改的內容 (ISO 8601)。如果 `modifiedDateBefore` 早於 `modifiedDateAfter`，則沒有任何內容符合視窗。
`maxFileSizeInMegaBytes`	否	連接器擷取之任何單一檔案的大小上限，以 MB 為單位。提供做為數值字串（例如，`"500"`)。預設為 `"500"`。

aclEnabled （選用）
欄位	必要	說明
`aclEnabled`	否	文件層級存取控制是否已啟用。設定為 `true` 以啟用，或`false`設定為停用。如果您省略此欄位，預設值取決於 `authType`：`SERVICE_ACCOUNT`預設值為 `true`；`OAUTH2`預設值為 `false`。ACL 需要`SERVICE_ACCOUNT`身分驗證。您無法在建立資料來源後變更此設定。如需詳細資訊，請參閱文件層級存取控制。

變更身分驗證方法

您可以使用 UpdateDataSource 操作或，將資料來源的身分驗證方法（例如，從 OAuth 2.0 更新為服務帳戶）更新為包含相符憑證的新 authType和秘密 AWS 管理主控台。文件層級存取控制設定會在您建立資料來源時修正，因此若要新增或移除 ACLs，您必須建立新的資料來源。

後續步驟

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

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

設定 OAuth 2.0 身分驗證

文件層級存取控制