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

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

主なユースケース

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

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

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	書き込み	挿入、削除、書式設定操作でドキュメントを更新します。

重要なお知らせ

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

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

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

権限とデータアクセス

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

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

制限事項

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

トラブルシューティング

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

関連リンク

• Connectors
• Start a Chat
• Manage Agents