翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Google Drive ナレッジベース統合
Google Drive ナレッジベース統合を使用すると、Google Drive のコンテンツのインデックスを作成できます。その後、Amazon Quick エージェントはこのコンテンツを検索し、そのコンテンツに関する質問に回答できます。
Amazon Quick は、Google Drive に接続するための 2 つの認証方法をサポートしています。
+ **ユーザー管理のセットアップ** – Google Drive に直接サインインして接続を承認します。これは最も簡単な開始方法です。詳細については、「[ユーザー管理のセットアップ](google-drive-kb-user-managed.md)」を参照してください。
+ **管理者管理のセットアップ (サービス認証情報)** – Google WorkSpace 管理者は、接続を承認するドメイン全体の委任を持つサービスアカウントを作成します。管理型セットアップの主な利点は、組み込みのドキュメントレベルのアクセスコントロール (ACL) です。Amazon Quick は、Google Drive のアクセスコントロールリストを自動的に同期します。クエリ時に各ユーザーのアクセス許可を検証するため、アクセスが許可されているドキュメントからの回答のみが表示されます。詳細については、「[管理者管理の Google Drive ナレッジベースのセットアップ](google-drive-kb-admin-managed.md)」を参照してください。
接続後、Amazon Quick は Google Drive ファイルとフォルダをナレッジベースにインデックス化します。その後、Amazon Quick エージェントはこのコンテンツを検索し、Google Drive データに基づく回答を生成できます。
## 前提条件
Google Drive 統合を設定する前に、以下があることを確認してください。
+ Google Drive アクセスを持つ Google アカウント。
+ サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。
管理者管理のセットアップには、追加の前提条件が適用されます。詳細については、「[管理者管理の Google Drive ナレッジベースのセットアップ](google-drive-kb-admin-managed.md)」を参照してください。
## サポートされているコンテンツタイプ
Google Drive コネクタは、Amazon Quick ナレッジベースがサポートするすべての一般的なファイルタイプをサポートしています。これには、PDF、Word、Excel、PowerPoint、テキストファイルが含まれます。コネクタは、次の Google Workspace 固有の形式もサポートしています。
+ Google Docs
+ Google Sheets
+ Google Slides
サポートされているファイルタイプ、サイズ制限、およびコンテンツ処理オプションの詳細については、「」を参照してください[一般的な設定](knowledge-base-integrations.md#common-configuration-settings)。
# ユーザー管理のセットアップ
ユーザー管理のセットアップでは、Google Drive に直接サインインして接続を承認します。Amazon Quick は、マネージド OAuth フローを通じて認証を処理します。Google Cloud プロジェクト、サービスアカウント、またはドメイン全体の委任は必要ありません。
## 前提条件
ユーザー管理の Google Drive ナレッジベースを設定する前に、以下を確認してください。
+ Google Drive にアクセスできる Google アカウントがある。
+ Google Workspace 管理者は、サードパーティーアプリへのアクセスを許可するか、ユーザーに代わって Amazon Quick アプリを許可できます。
+ ブラウザでは、Amazon Quick コンソールドメインからのポップアップが許可されます。
**注記**
組織が Google WorkSpace でサードパーティーアプリへのアクセスを制限している場合、ユーザーがサインインする前に、Google WorkSpace 管理者が Amazon Quick アプリを許可する必要がある場合があります。サインイン中にエラーが発生した場合は、Google Workspace 管理者にお問い合わせください。
**注記**
ユーザー管理の設定では、ドキュメントレベルのアクセスコントロール (ACL) はサポートされていません。ACL は、特定のドキュメントにアクセスできるユーザーを制御するメカニズムです。ドキュメントレベルのアクセスコントロールが必要な場合は、[管理者管理の Google Drive ナレッジベースのセットアップ](google-drive-kb-admin-managed.md)代わりに を使用します。
## 同意中に付与されるアクセス許可
接続を承認すると、Amazon Quick は Google アカウントから次のアクセス許可をリクエストします。
すべての Google Drive ファイルを表示してダウンロードする
+ Amazon Quick に Google Drive ファイルの表示を許可する
+ Amazon Quick にファイルのダウンロードを許可する
+ Amazon Quick がファイルを共有するユーザーの名前と E メールアドレスを表示できるようにします。
Google Drive ファイルに関する情報を表示する
+ Amazon Quick にファイルのタイトルと説明の表示を許可する
+ Amazon Quick がファイルを共有するユーザーの名前と E メールアドレスを表示できるようにします。
+ Amazon Quick にフォルダとファイルの整理方法の表示を許可する
**注記**
このアクセスは、Google アカウントのアクセス許可設定からいつでも確認および削除できます。
## Google Drive ナレッジベースを設定する
ユーザー管理の Google Drive ナレッジベースを作成するには、Amazon Quick コンソールで次の手順を実行します。
1. Amazon Quick コンソールで、**統合**を選択します。
1. **Google Drive** を検索し、**Add** (\$1) アイコンを選択します。
1. **Google Drive ナレッジベースの作成**ダイアログの**認証メソッド**で、**Google Drive にサインイン**を選択し、Google のサインインと同意のフローを完了します。
1. **ナレッジベースの作成** に、ナレッジベースの名前とオプションの説明を入力します。
1. Content ****セクションで、Add **content **を選択し、インデックスを作成する Google Drive ファイルとフォルダを選択します。個人用ドライブ、共有ファイル、組織内の共有ドライブからコンテンツを参照できます。
1. **[作成]** を選択します。
**Create** を選択すると、データ同期が自動的に開始されます。
## アクセス制御
**重要**
Amazon Quick がユーザー管理のセットアップを通じて Google Drive コンテンツをインデックス作成する場合、Google Drive からのアクセスコントロールリスト (ACLs) は同期されません。インデックス付きコンテンツはすべて、Google Drive のアクセス許可に関係なく、Amazon Quick のナレッジベースにアクセスできるすべてのユーザーがアクセスできます。ナレッジベースを作成するときは、含めるコンテンツを慎重に確認してください。
ドキュメントレベルのアクセスコントロールが必要な場合は、[管理者管理の Google Drive ナレッジベースのセットアップ](google-drive-kb-admin-managed.md)代わりに を使用します。
## 統合の管理とトラブルシューティング
統合の編集、共有、または削除の手順については、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。
同期の問題やドキュメントの欠落など、ナレッジベースのトラブルシューティングの詳細については、「」を参照してください[ナレッジベースのトラブルシューティング](troubleshooting-knowledge-bases.md)。
### Google ドライブ固有の問題
+ **管理者によってブロックされたアプリ** – Google Workspace 管理者がサードパーティーのアプリへのアクセスを制限している場合、サインインしようとするとエラーが表示されることがあります。Amazon Quick アプリを許可するには、Google Workspace 管理者にお問い合わせください。
+ **認証ポップアップが失敗**する – ブラウザで Amazon Quick コンソールドメインからのポップアップが許可されていることを確認します。別のブラウザを使用するか、ブラウザキャッシュをクリアしてみてください。
+ アクセス**許可の取り消し** – 以前に Google アカウントのアクセス許可設定から Amazon Quick Access を取り消した場合は、統合を編集して再度サインインして再認証する必要があります。
+ **コンテンツがない** – 認証に使用した Google アカウントが、選択したファイルとフォルダにアクセスできることを確認します。最初の同期後に共有されたコンテンツには、インデックスの再同期が必要です。
+ **Google API レート制限** – Google Drive は、使用期間の長い間、リクエストを制限する場合があります。同期が失敗または不完全な場合は、オフピーク時間に再試行します。
## 既知の制限事項
+ ドキュメントレベルのアクセスコントロール (ACL) は、ユーザー管理のセットアップではサポートされていません。ドキュメントレベルのアクセスコントロールが必要な場合は、 を使用します[管理者管理の Google Drive ナレッジベースのセットアップ](google-drive-kb-admin-managed.md)。
+ ファイルコメントの同期はサポートされていません。
# 管理者管理の Google Drive ナレッジベースのセットアップ
管理者管理の設定では、Google Workspace 管理者がサービスアカウントを作成し、ドメイン全体のアクセスを委任します。個々のユーザーは、サインインを通じて を承認する必要はありません。
管理者管理のセットアップには、ドキュメントレベルのアクセスコントロールリスト (ACL) のサポートが組み込まれています。Amazon Quick は、Google Drive から ACLs を自動的に同期し、クエリ時に各ユーザーのアクセス許可を検証します。
ACL のベストプラクティスの詳細については、「」を参照してください[ナレッジベースで ACLs を管理するためのベストプラクティス](acl-best-practices-kb.md)。
## 前提条件
統合を設定する前に、以下があることを確認してください。
+ 組織の Google Workspace への管理者アクセス。
+ Amazon Quick エンタープライズユーザーアカウント。管理者アクセスは必要ありません。
+ Amazon Quick ID に使用される E メールドメインと一致する E メールドメインを持つ Google Workspace アカウント。
+ サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。
## 設定の概要
セットアップには以下のフェーズが含まれます。
1. **Google Workspace の設定** – 読み取り専用 API アクセスとドメイン全体の委任を使用して Google クラウドサービスアカウントを作成します。次に、サービスアカウントが偽装する専用の管理者ユーザーを作成します。詳細については、「[Google Workspace を設定する](google-drive-kb-google-config.md)」を参照してください。
1. **Amazon Quick でナレッジベース**を作成する – フェーズ 1 のサービスアカウントの認証情報を使用して Google Drive ナレッジベースを作成します。詳細については、「[Amazon Quick でのナレッジベースの作成](google-drive-kb-connection.md)」を参照してください。
ドキュメントレベルのアクセスコントロールは、すべての管理者管理ナレッジベースで自動的に有効になります。アクセスコントロールの仕組みの詳細については、「」を参照してください[ドキュメントレベルのアクセスコントロール](google-drive-kb-acl.md)。
# Google Workspace を設定する
Amazon Quick を Google Drive に接続するには、Google クラウドコンソールと Google Workspace 管理コンソールで次のタスクを実行します。Google Cloud プロジェクトを作成し、必要な APIs を有効にして、サービスアカウントの認証情報を生成し、ドメイン全体の委任を設定します。また、サービスアカウントが偽装する専用の管理者ユーザーを作成します。
**前提条件**
作業を開始する前に、以下の準備が整っていることを確認します。
管理者アクセス権を持つ Google Workspace アカウント
Google Cloud コンソールでプロジェクトを作成するアクセス許可
## Google Cloud プロジェクトの作成
1. Google Cloud コンソールを開きます。
1. ページ上部のプロジェクトセレクターから、**新しいプロジェクト**を選択します。
1. プロジェクト名を入力し、**作成**を選択します。
1. プロジェクトを作成したら、**プロジェクトの選択**を選択して切り替えます。これにはしばらく時間がかかることがあります。
## 必要な APIs を有効にする
Amazon Quick には 3 つの Google APIsが必要です。API ライブラリからそれぞれをオンにします。
1. ナビゲーションメニューで、**APIsとサービス**を選択し、**ライブラリ**を選択します。
1. 次の各 APIsし、**有効化**を選択します。
+ Google Drive API
+ Google Drive アクティビティ API
+ 管理者 SDK API
## サービスアカウントの作成
1. ナビゲーションメニューで、**APIsとサービス**を選択し、**認証情報**を選択します。
1. **認証情報の作成**を選択し、**サービスアカウント**を選択します。
1. サービスアカウントの名前とオプションの説明を入力し、**完了**を選択します。
## プライベートキーの生成
1. **認証情報**ページで、作成したサービスアカウントを選択します。
1. **キー**タブを選択し、**キーの追加**、**新しいキーの作成**を選択します。
1. **JSON** が選択されていることを確認してから、**作成**を選択します。
ブラウザは、プライベートキーを含む JSON ファイルをダウンロードします。このファイルを安全に保存します。後のステップで Amazon Quick にアップロードします。
**注記**
サービスアカウントキーの作成が組織ポリシーによって無効になっていることを示すエラーが表示された場合は、「」を参照してください[組織ポリシーの制限の解決](#google-drive-kb-admin-troubleshooting-org-policy)。
## サービスアカウントの一意の ID の記録
1. サービスアカウントの詳細ページで、**詳細**タブを選択します。
1. Unique **ID **フィールドの値をコピーします。この値は、ドメイン全体の委任を設定するときに必要です。
## ドメイン全体の委任の設定
ドメイン全体の委任により、サービスアカウントは組織内のユーザーに代わって Google Workspace データにアクセスできます。
1. サービスアカウントの詳細ページで、**詳細設定**を展開します。
1. **Google Workspace 管理コンソールの表示**を選択します。管理者コンソールが新しいタブで開きます。
1. 管理者コンソールのナビゲーションペインで、**セキュリティ**、**アクセスとデータ管理**、**API コントロール**を選択します。
1. **Manage Domain Wide Delegation** を選択し、Add **new **を選択します。
1. **クライアント ID** には、前にコピーした一意の ID を入力します。
1. **OAuth スコープの場合は**、次のカンマ区切り値を入力します。
```
https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/drive.metadata.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/forms.body.readonly
```
1. [**承認**] を選択します。
## 委任管理者ユーザーの作成
サービスアカウントは、Google Workspace 管理者ユーザーに代わって動作します。この目的のために専用ユーザーを作成し、最低限必要なロールを割り当てます。
1. Google Workspace 管理コンソールで、**ディレクトリ**を選択し、**ユーザー**を選択します。
1. **新しいユーザーの追加** を選択します。
1. 新しいユーザーの名、姓、プライマリ E メールアドレスを入力し、**新しいユーザーの追加**を選択します。
1. **[Done]** (完了) をクリックします。
1. ユーザーリストから、作成したユーザーを選択します。ユーザーが表示されない場合は、ページを更新します。
1. ユーザーの詳細ページで、**管理者のロールと権限**セクションを展開します。
1. **ロール** で、次のロールを割り当てます。
+ グループリーダー
+ ユーザー管理管理者
+ ストレージ管理者
1. **[保存]** を選択します。
このユーザーの E メールアドレスを記録します。Amazon Quick でナレッジベースを作成するときに必要になります。
## Google Workspace 設定のトラブルシューティング
### 組織ポリシーの制限の解決
サービスアカウントキーの作成時に次のエラーが発生した場合:
```
The organization policy constraint iam.disableServiceAccountKeyCreation
is enforced on your organization.
```
**注記**
2024 年 5 月 3 日以降に作成された Google クラウド組織の場合、この制約はデフォルトで適用されます。
プロジェクトのポリシーを上書きする必要があります。
1. Google Cloud コンソールを開き、正しいプロジェクトが選択されていることを確認します。
1. ナビゲーションメニューで、**IAM & Admin** を選択し、**組織ポリシー**を選択します。
1. Filter ****フィールドに、 と入力します`iam.disableServiceAccountKeyCreation`。次に、ポリシーリストで、**サービスアカウントキーの作成を無効にする**を選択します。
1. **ポリシーの管理**を選択します。
**注記**
**管理ポリシー**が利用できない場合は、組織レベルで組織ポリシー管理者ロール (`roles/orgpolicy.policyAdmin`) が必要です。「[組織ポリシー管理者ロールの付与](#google-drive-kb-admin-troubleshooting-org-admin-role)」を参照してください。
1. **ポリシーソース**セクションで、**親のポリシーを上書き**が選択されていることを確認します。
1. **強制**で、この組織のポリシー制約の強制をオフにします。
1. **ポリシーの設定** を選択します。
変更が反映されるまでに数分かかる場合があります。
### 組織ポリシー管理者ロールの付与
Organization Policy Administrator ロール (`roles/orgpolicy.policyAdmin`) は、プロジェクトレベルではなく、組織レベルで付与する必要があります。プロジェクトにロールを割り当てるときに、ロールリストに表示されません。
このロールを付与するには、Google Cloud コンソールのプロジェクトセレクタから組織 (プロジェクトではない) を選択します。次に、**IAM & Admin**、**IAM** を選択し、アカウントにロールを割り当てます。詳細な手順については、Google Cloud ドキュメントの[「プロジェクト、フォルダ、組織へのアクセスを管理する](https://cloud.google.com/iam/docs/granting-changing-revoking-access)」を参照してください。
ロールの割り当ての伝播には数分かかる場合があります。
# Amazon Quick でのナレッジベースの作成
このフェーズでは、Amazon Quick でナレッジベースを作成し、Google Workspace 設定からサービスアカウントの認証情報を指定します。どのエンタープライズユーザーもこのフェーズを完了できます。Amazon Quick 管理者アクセスは必要ありません。
Google WorkSpace 管理者がユーザーに代わって Google WorkSpace 設定を完了した場合は、続行する前に JSON キーファイルと委任管理者の E メールアドレスが必要です。
## ナレッジベースのセットアップ
1. Amazon Quick コンソールで、**統合**を選択します。
1. **ナレッジベース**で Google **Drive** を見つけ、**追加** (\$1) アイコンを選択します。
1. **Google Drive ナレッジベースの作成**ダイアログで、**管理者認証情報があるを選択します。ドキュメントレベルのアクセスコントロールを設定します。**
1. **接続されたアカウント**ドロップダウンで、**アカウントの追加**を選択します。
1. [**名前**] に、接続の名前を入力します。Google Workspace ドメインなどのわかりやすい名前を使用します。
**重要**
保存後に接続名を変更することはできません。
1. **.JSON キーをアップロード**を選択し、Google Workspace の設定中にダウンロードした JSON ファイルを選択します。
1. **Google ワークスペース管理者 E** メールには、Google Workspace 設定中に作成した委任管理者ユーザーの E メールアドレスを入力します。
1. [**次へ**] を選択します。
## 同期するコンテンツの選択
1. ナレッジベース**の名前**とオプションの**説明**を入力します。
1. 含める Google Drive コンテンツを選択します。
+ **My Drive (すべてのユーザー)** – 組織内のすべてのユーザーの My Drive のファイルが含まれます。
+ **自分と共有 (すべてのユーザー)** – ユーザーと共有されているファイルが含まれます。
+ **共有ドライブ** – すべての共有ドライブはデフォルトで同期されます。特定のドライブを含めるか除外するには、**フィルタータイプの**ドロップダウンと**共有ドライブ IDs の追加**フィールドを使用します。1～100 個の共有ドライブ IDs を入力できます。
1. 詳細設定を行うには、**次へ** を選択します。
## 詳細設定の構成
**詳細設定**ステップでは、ナレッジベースのオプション設定を設定できます。
日付でコンテンツをフィルタリングする
最後に変更された日付に基づいてクロールするドキュメントを制限します。開始日は、デフォルトで今日より 1 年前になります。開始日を変更またはクリアし、オプションで終了日を設定できます。
マルチメディアコンテンツ、ファイルサイズ、ファイルパターン
ナレッジベースに含めるコンテンツタイプを選択します。
+ **ドキュメント内のビジュアルコンテンツ** – サポートされているドキュメント形式からビジュアル要素を抽出してインデックス化します。デフォルトでは、このオプションは有効になっています。
+ **オーディオファイル** – オーディオファイルを書き起こし、インデックスを作成します。
+ **動画ファイル** – 動画ファイルを書き起こし、インデックスを作成します。
**Create** を選択してナレッジベースを作成します。**Create** を選択すると、データ同期が自動的に開始されます。
## の管理とトラブルシューティング
統合を編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。
同期の問題やドキュメントの欠落など、ナレッジベースのトラブルシューティングについては、「」を参照してください[ナレッジベースのトラブルシューティング](troubleshooting-knowledge-bases.md)。
### 管理者管理のセットアップの問題
+ **Google API レート制限** – Google Drive は、使用期間中にリクエストをスロットリングする場合があります。同期が失敗または不完全な場合は、オフピーク時間に再試行します。
+ **SSL 証明書エラー** – ナレッジベースの作成時に SSL 証明書エラーに関するエラーが表示された場合は、ドメイン全体の委任時に設定した OAuth スコープを確認します。
# ドキュメントレベルのアクセスコントロール
管理者管理の Google Drive ナレッジベースには、ドキュメントレベルのアクセス制御が組み込まれています。Amazon Quick は、クロールのたびに Google Drive のアクセスコントロールリスト (ACLs) を同期し、クエリ時に各ユーザーのアクセス許可を検証するため、ユーザーはアクセスが許可されているドキュメントからの回答のみを表示できます。
## 仕組み
ユーザーが管理者管理の Google Drive ナレッジベースを使用する Amazon Quick エージェントにクエリを送信すると、システムは 2 つの段階でアクセスコントロールを適用します。
1. **取得前フィルタリング** – Amazon Quick は、ベクトルインデックスに対してセマンティック検索を実行して、最も関連性の高いドキュメントパッセージを見つけます。システムは、インデックスに既に保存されているアクセスコントロールリストを適用します。これにより、候補ドキュメントの予備セットが生成されます。このステージは、インデックス内のすべてのドキュメントのリアルタイム API コールが大規模に高すぎるために必要です。
1. **リアルタイム検証** – システムは Google Drive APIs。管理者が提供したサービスアカウントの認証情報を使用して、なりすましによってユーザー固有のアクセストークンを生成します。Google Drive は、各ドキュメントに関連付けられているアクセスコントロールリストの信頼できるソースを維持します。システムは、ユーザーがアクセスを許可されていないドキュメントを結果セットから削除します。
システムは、検証済みおよび承認されたドキュメントパッセージのみをコンテキストとしてモデルに渡します。このモデルは、この知識を使用してレスポンスを生成します。この 2 段階のアプローチでは、ドキュメントレベルのアクセスコントロールにより、大規模なパフォーマンスが保証され、維持されます。
## ACL 管理を有効にする
ドキュメントレベルのアクセスコントロールは、すべての管理者管理ナレッジベースで自動的に有効になります。追加の設定は必要ありません。
ACL のベストプラクティスの詳細については、「」を参照してください[ナレッジベースで ACLs を管理するためのベストプラクティス](acl-best-practices-kb.md)。
## 既知の制限事項
+ ファイルコメントの同期はサポートされていません。
一般的な ACL の制限とベストプラクティスの詳細については、「」を参照してください[ナレッジベースで ACLs を管理するためのベストプラクティス](acl-best-practices-kb.md)。