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

Google Tasksコネクターを使うと、EMQXエージェントがタスクリストやタスクを作成・管理できます。これにより、デバイスのイベント、分析結果、チャットの意思決定を追跡可能な作業に変換できます。

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

- 異常なデバイス状態を検知した後にメンテナンスタスクを作成する。
- 日次運用サマリーを作成する前に期限切れのタスクを一覧表示する。
- チェックリストを整理するためにタスクを別のタスクの下に移動する。
- インシデントの変更に応じてタスクの詳細を更新する。

チャットプロンプトの例：

```text
operations-tasksコネクターを使って、デバイス「chiller-17」のDevice Maintenanceリストにタスクを作成してください。タイトルは「Inspect high temperature alert」に設定してください。
```

## 前提条件

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

- Google TasksにアクセスできるGoogleアカウント
- ComposioにGoogle Tasksのデータを作成、変更、整理、削除する権限を付与すること
- ワークフローで必要なタスクリストへのアクセス権

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

1. 左側のナビゲーションメニューで**Connectors**をクリックします。
2. **Available**タブで**Google Tasks**を見つけて**Add**をクリックします。
3. 説明的なコネクター名を入力します。
4. **Confirm**をクリックすると、Google認証フローがダイアログで開きます。
5. 接続するGoogleアカウントを選択するか、**Use another account**をクリックします。
6. 要求されている権限を確認します。Composioは認証されたアカウントが利用可能なすべてのタスクを作成、変更、整理、削除できます。
7. **Continue**をクリックしてアクセスを許可します。
8. Composioが接続成功メッセージを表示し、EMQXエージェントに戻るまで待ちます。
9. **Added**タブでコネクターの状態が**Authorized**になっていることを確認します。

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

## 対応ツール

### タスクの作成と更新

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLETASKS_CREATE_TASK_LIST` | 書き込み | タスクリストを作成します。 |
| `GOOGLETASKS_INSERT_TASK` | 書き込み | タスクリストにタスクを作成します。 |
| `GOOGLETASKS_MOVE_TASK` | 書き込み | タスクを移動するか、親子関係を変更します。 |
| `GOOGLETASKS_PATCH_TASK` | 書き込み | タスクの一部を更新します。 |
| `GOOGLETASKS_PATCH_TASK_LIST` | 書き込み | タスクリストの一部を更新します。 |
| `GOOGLETASKS_UPDATE_TASK_FULL` | 書き込み | タスクのサポートされている情報をすべて置き換えます。 |

### タスクの削除

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLETASKS_DELETE_TASK` | 破壊的 | タスクを削除します。 |
| `GOOGLETASKS_DELETE_TASK_LIST` | 破壊的 | タスクリストを削除します。 |

### タスクの読み取り

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLETASKS_GET_TASK` | 読み取り | タスクの詳細を取得します。 |
| `GOOGLETASKS_GET_TASK_LIST` | 読み取り | タスクリストの詳細を取得します。 |
| `GOOGLETASKS_LIST_ALL_TASKS` | 読み取り | すべてのタスクリストのタスクを一覧表示します。 |
| `GOOGLETASKS_LIST_TASK_LISTS` | 読み取り | タスクリストを一覧表示します。 |
| `GOOGLETASKS_LIST_TASKS` | 読み取り | タスクリスト内のタスクを一覧表示します。 |

::: warning 重要なお知らせ
タスクやタスクリストを削除すると、認証されたアカウントから作業項目が削除されます。削除前にタスクリストおよびタスクのIDを必ず確認してください。
:::

## チャットでのコネクターの使用方法

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

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

コネクターは認証されたGoogleアカウントを使用し、そのアカウントで利用可能なタスクリストにアクセスします。ただしGoogle Workspaceのポリシーに従います。

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

## 制限事項

- Google Tasks APIのクォータが適用されます。
- タスクのフィールドや階層の動作はGoogle Tasksにより定義されています。
- タスクリストを削除すると、そのリスト内のすべてのタスクが削除される可能性があります。

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

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

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

## 関連リンク

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