# EMQXエージェントをGoogle Driveに接続する

Google Driveコネクターを使用すると、EMQXエージェントはファイル、フォルダー、権限、コメント、返信、共有ドライブを管理できます。これを利用してエージェントの出力を保存したり、ファイルを整理したり、コラボレーションを管理したり、ワークフローのためにドキュメントを取得したりできます。

## よくあるユースケース

- 生成されたレポートをアップロードしてチームと共有する。
- Driveフォルダー内で最新のデバイス仕様を検索する。
- 分析完了後にファイルにコメントを追加する。
- 処理済みファイルをアーカイブフォルダーに移動する。

チャットの例文：

```text
operations-driveコネクターを使って最新の週次デバイスレポートを見つけ、未解決の問題を要約したコメントを追加し、ファイルの権限は変更しないでください。
```

## 前提条件

コネクターを追加する前に、以下を準備してください：

- Google DriveにアクセスできるGoogleアカウント。
- ComposioにGoogle Driveファイルの閲覧、作成、編集、削除を許可する認可権限。
- ワークフローで必要なファイル、フォルダー、共有ドライブへのアクセス権。

## Google Driveコネクターの追加手順

1. 左側のナビゲーションメニューで **Connectors** をクリックします。
2. **Available** タブで **Google Drive** を探し、**Add** をクリックします。
3. 分かりやすいコネクター名を入力します。
4. **Confirm** をクリックすると、Google認証フローがダイアログで開きます。
5. 接続するGoogleアカウントを選択するか、**Use another account** をクリックします。
6. GoogleがComposioへの再サインインを求めた場合は、情報を確認して **Continue** をクリックします。
7. Composioが要求するアクセス権限を確認します。認可には以下が含まれます：
   - 認可されたアカウントがアクセス可能なすべてのGoogle Driveファイルの閲覧、作成、編集、削除。
   - プライマリGoogleアカウントのメールアドレスの閲覧およびGoogle上の個人情報との関連付け。
8. アクセス権を付与するために **Continue** をクリックします。
9. Composioが接続成功メッセージを表示し、EMQXエージェントに戻るまで待ちます。
10. **Added** タブでコネクターのステータスが **Authorized** になっていることを確認します。

Googleは以前に付与された権限を表示する場合があります。続行前に要求されたアクセス権を必ず確認してください。管理されたGoogle Workspaceアカウントでは、組織のポリシーによりサードパーティアプリの認可が制限されることがあります。

## 対応ツール

### ファイルとフォルダー

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLEDRIVE_COPY_FILE_ADVANCED` | 書き込み | 名前や親フォルダーなどのオプション付きでファイルをコピーします。 |
| `GOOGLEDRIVE_CREATE_FILE` | 書き込み | ファイルメタデータからファイルまたはフォルダーを作成します。 |
| `GOOGLEDRIVE_CREATE_FILE_FROM_TEXT` | 書き込み | テキストコンテンツからDriveファイルを作成します。 |
| `GOOGLEDRIVE_CREATE_FOLDER` | 書き込み | フォルダーを作成します。 |
| `GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION` | 破壊的 | ファイルまたはフォルダーを完全に削除します。 |
| `GOOGLEDRIVE_MOVE_FILE` | 書き込み | ファイルをフォルダー間で移動します。 |
| `GOOGLEDRIVE_RESUMABLE_UPLOAD` | 書き込み | 再開可能なアップロードを使用して大きなファイルをアップロードします。 |
| `GOOGLEDRIVE_TRASH_FILE` | 破壊的 | ファイルをゴミ箱に移動します。 |
| `GOOGLEDRIVE_UNTRASH_FILE` | 書き込み | ゴミ箱からファイルを復元します。 |
| `GOOGLEDRIVE_UPDATE_FILE_PUT` | 書き込み | 名前、説明、親フォルダーなどのファイルメタデータを更新します。 |
| `GOOGLEDRIVE_UPLOAD_FILE` | 書き込み | ファイルをGoogle Driveにアップロードします。 |
| `GOOGLEDRIVE_UPLOAD_UPDATE_FILE` | 書き込み | 新しいコンテンツをアップロードしてDriveファイルを更新します。 |

### 読み取りと検索

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLEDRIVE_DOWNLOAD_FILE` | 読み取り | ファイルIDでファイルをダウンロードします。 |
| `GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION` | 読み取り | Driveのダウンロード操作を通じてファイルをダウンロードします。 |
| `GOOGLEDRIVE_EXPORT_GOOGLE_WORKSPACE_FILE` | 読み取り | Google Workspaceファイルを選択した形式でエクスポートします。 |
| `GOOGLEDRIVE_FIND_FILE` | 読み取り | 名前、内容、その他の条件でファイルやフォルダーを検索します。 |
| `GOOGLEDRIVE_FIND_FOLDER` | 読み取り | 名前、更新日時、その他の条件でフォルダーを検索します。 |
| `GOOGLEDRIVE_GET_ABOUT` | 読み取り | 現在のユーザー、ストレージ容量、対応するインポート・エクスポート形式情報を取得します。 |
| `GOOGLEDRIVE_GET_FILE_METADATA` | 読み取り | ファイルメタデータを取得します。 |
| `GOOGLEDRIVE_LIST_CHILDREN_V2` | 読み取り | フォルダー内の子ファイルやフォルダーを一覧表示します。 |

### 権限

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLEDRIVE_CREATE_PERMISSION` | 書き込み | ファイルまたは共有ドライブの権限を作成します。 |
| `GOOGLEDRIVE_DELETE_PERMISSION` | 破壊的 | ファイルまたは共有ドライブの権限を削除します。 |
| `GOOGLEDRIVE_GET_PERMISSION_ID_FOR_EMAIL` | 読み取り | メールアドレスに対応するDrive権限IDを取得します。 |
| `GOOGLEDRIVE_LIST_ACCESS_PROPOSALS` | 読み取り | ファイルのアクセス提案を一覧表示します。 |
| `GOOGLEDRIVE_LIST_PERMISSIONS` | 読み取り | ファイルまたは共有ドライブの権限を一覧表示します。 |

### コメントと返信

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLEDRIVE_CREATE_COMMENT` | 書き込み | ファイルにコメントを作成します。 |
| `GOOGLEDRIVE_CREATE_REPLY` | 書き込み | ファイルコメントに返信します。 |
| `GOOGLEDRIVE_DELETE_COMMENT` | 破壊的 | コメントを削除します。 |
| `GOOGLEDRIVE_DELETE_REPLY` | 破壊的 | コメント返信を削除します。 |
| `GOOGLEDRIVE_GET_COMMENT` | 読み取り | ファイルコメントを取得します。 |
| `GOOGLEDRIVE_GET_REPLY` | 読み取り | コメント返信を取得します。 |
| `GOOGLEDRIVE_LIST_COMMENTS` | 読み取り | ファイルのコメントを一覧表示します。 |
| `GOOGLEDRIVE_LIST_REPLIES` | 読み取り | コメントへの返信を一覧表示します。 |
| `GOOGLEDRIVE_UPDATE_COMMENT` | 書き込み | コメントを更新します。 |
| `GOOGLEDRIVE_UPDATE_REPLY` | 書き込み | コメント返信を更新します。 |

### 共有ドライブ

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLEDRIVE_CREATE_DRIVE` | 書き込み | 共有ドライブを作成します。 |
| `GOOGLEDRIVE_DELETE_DRIVE` | 破壊的 | 共有ドライブを削除します。 |
| `GOOGLEDRIVE_GET_DRIVE` | 読み取り | 共有ドライブの詳細を取得します。 |
| `GOOGLEDRIVE_LIST_SHARED_DRIVES` | 読み取り | 認可ユーザーが利用可能な共有ドライブを一覧表示します。 |
| `GOOGLEDRIVE_UPDATE_DRIVE` | 書き込み | 共有ドライブの名前、外観、制限を更新します。 |

::: warning 重要なお知らせ
完全削除ツールはGoogle Driveのゴミ箱から復元できません。権限変更はファイルへのアクセスを公開または削除する可能性があります。これらの操作を行う前に、ファイル、フォルダー、共有ドライブ、および主体を必ず確認してください。
:::

## チャットでコネクターを使う

1. チャット入力欄でコネクターアイコンをクリックします。
2. 認可済みの **Google Drive** コネクターを選択します。
3. プロンプトに、エージェントが使用すべき外部リソースと操作を指定します。
4. 生成されたエージェント定義を確認し、必要なツールのみが含まれていることを確認します。

## 権限とデータアクセス

コネクターは認可されたGoogleアカウントを使用します。ファイル所有権、共有設定、共有ドライブのメンバーシップ、Google Workspaceポリシーによりアクセス可能なリソースと操作が決まります。

チャットプロンプトやエージェント指示に外部サービスの認証情報やアクセストークンを含めないでください。

## 制限事項

- Google Drive APIのクォータおよびストレージ制限が適用されます。
- エクスポート形式はGoogle Workspaceファイルの種類によって異なります。
- 共有ドライブの操作にはオーガナイザーまたは管理者権限が必要な場合があります。
- 大容量アップロードには再開可能なアップロード操作が必要になることがあります。

<!-- TODO: サービス固有の結果サイズ制限、ファイル制限、APIレート制限、プラン制限、非対応リソースタイプを確認する。 -->

## トラブルシューティング

| 症状 | 解決策 |
|---|---|
| コネクターが **Unauthorized** のままになる。 | 認可を再試行し、意図したGoogleアカウントを選択して、要求されたアクセス権を付与するために **Continue** をクリックしてください。管理されたGoogle Workspaceアカウントの場合は、管理者がComposioを許可しているか確認してください。 |
| ツールが権限エラーを返す。 | 認可されたアカウントが対象のファイル、フォルダー、共有ドライブにアクセスできるか、必要なGoogle権限が付与されているかを確認してください。必要に応じてコネクターを再認可してください。 |
| 必要なツールが利用できない。 | ツールがこのコネクターでサポートおよび承認されているかを確認し、チャットで再度コネクターを選択してください。 |
| リクエストが断続的に拒否される。 | 外部サービスのステータス、APIクォータ、レート制限、アカウントプランを確認してください。 |

## 関連リンク

- [Connectors](../connectors.md)
- [Start a Chat](../chats.md)
- [Manage Agents](../agents.md)