# EMQXエージェントをGoogleドキュメントに接続する

Googleドキュメントコネクターを使用すると、EMQXエージェントがGoogleドキュメントの作成、コピー、検索、読み取り、エクスポート、および編集を行えます。これにより、レポートの生成、運用ドキュメントの更新、エージェントの結果を共有可能なドキュメントに変換することが可能です。

## 主なユースケース

- EMQX Tablesのクエリ結果からレポートを作成する。
- 最新のインシデント調査結果でランブックを更新する。
- ドキュメントを検索し、その内容をコンテキストとして利用する。
- 生成したドキュメントをPDFとしてエクスポートする。

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

```text
operations-docsコネクターを使って、「Daily Device Health Report」という名前のGoogleドキュメントを作成し、注意が必要なデバイスのMarkdown要約を書いてください。
```

## 前提条件

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

- GoogleドキュメントにアクセスできるGoogleアカウント。
- ComposioにGoogleドキュメントおよびGoogleドライブのファイルの閲覧、作成、編集、削除を許可する認可権限。
- ワークフローで必要なドキュメントおよびドライブの場所へのアクセス権。

## Googleドキュメントコネクターの追加手順

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

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

## 対応ツール

### ドキュメント作成

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLEDOCS_COPY_DOCUMENT` | 書き込み | Googleドキュメントをコピーします。 |
| `GOOGLEDOCS_CREATE_DOCUMENT` | 書き込み | Googleドキュメントを作成し、初期テキストを追加できます。 |
| `GOOGLEDOCS_CREATE_DOCUMENT_MARKDOWN` | 書き込み | MarkdownコンテンツからGoogleドキュメントを作成します。 |

### ドキュメントの読み取りとエクスポート

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF` | 読み取り | GoogleドキュメントをPDFとしてエクスポートします。 |
| `GOOGLEDOCS_GET_DOCUMENT_BY_ID` | 読み取り | ドキュメントIDでGoogleドキュメントとその構造を取得します。 |
| `GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT` | 読み取り | Googleドキュメントのプレーンテキストコンテンツを取得します。 |
| `GOOGLEDOCS_SEARCH_DOCUMENTS` | 読み取り | 名前、内容、更新日時などの条件でGoogleドキュメントを検索します。 |

### ドキュメント編集

| ツール | アクセス | 説明 |
|---|---|---|
| `GOOGLEDOCS_INSERT_INLINE_IMAGE` | 書き込み | ドキュメントの指定位置にインライン画像を挿入します。 |
| `GOOGLEDOCS_INSERT_PAGE_BREAK` | 書き込み | 改ページを挿入します。 |
| `GOOGLEDOCS_INSERT_TABLE_ACTION` | 書き込み | 指定した行数と列数の表を挿入します。 |
| `GOOGLEDOCS_INSERT_TEXT_ACTION` | 書き込み | ドキュメントの指定位置にテキストを挿入または追加します。 |
| `GOOGLEDOCS_REPLACE_ALL_TEXT` | 書き込み | ドキュメント内の一致するすべてのテキストを置換します。 |
| `GOOGLEDOCS_REPLACE_IMAGE` | 書き込み | ドキュメント内の画像を置換します。 |
| `GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN` | 書き込み | Markdownコンテンツを使ってドキュメントを置換・更新します。 |
| `GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT` | 書き込み | 挿入、削除、書式設定操作でドキュメントを更新します。 |

::: warning 重要なお知らせ
更新および置換ツールはドキュメントの内容を上書きする可能性があります。全文Markdown更新や全置換操作を行う前に、対象のドキュメントを必ず確認してください。
:::

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

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

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

コネクターは認可されたGoogleアカウントを使用し、そのアカウントがアクセス可能なドキュメントにアクセスします。ただし、Google Workspaceのポリシーやドキュメント共有設定に従います。

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

## 制限事項

- GoogleドキュメントおよびドライブAPIのクォータ制限が適用されます。
- 画像挿入やドキュメントエクスポートはファイルサイズや外部リソースのアクセス状況に依存する場合があります。
- プレーンテキストやMarkdown操作では、一部の書式設定や埋め込みコンテンツが保持されないことがあります。

<!-- TODO: サービス固有の結果サイズ制限、ファイル制限、APIレート制限、プラン制限、非対応リソースタイプを確認する。 -->
<!-- TODO: コネクター経由で作成されたドキュメントのGoogleドライブのデフォルト保存場所を確認する。 -->

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

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

## 関連リンク

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