EMQXエージェントをNotionに接続する

Notionコネクターを使用すると、EMQXエージェントがNotionのページ、データベース、データソース、ブロック、コメント、およびファイルアップロードの作成、検索、読み取り、更新を行えます。このコネクターを活用して、仕様書、ナレッジベース、プロジェクトデータ、Notionに保存された構造化レコードを中心としたワークフローを構築できます。

よくあるユースケース

• エージェントを生成または更新する前に仕様書を読み取る。
• MQTTイベントやチャットの判断からデータベースの行を作成する。
• 自動化ワークフロー完了後にステータスプロパティを更新する。
• 運用ページに分析結果を追記する。

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

product-notionコネクターを使ってDevice Operationsデータベースを検索し、繰り返し発生した切断アラートの行を作成してください。デバイスID、重大度、現在の日付を含めてください。

前提条件

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

• 必要なワークスペースにアクセス可能なNotionアカウント
• Composioに必要なNotionページへのアクセス権を付与する権限
• ワークフローで必要なページおよびデータベースへのアクセス

Notionコネクターの追加方法

1. 左側のナビゲーションメニューで Connectors をクリックします。
2. Available タブで Notion を探し、Add をクリックします。
3. 説明的なコネクター名を入力します。
4. Confirm をクリックすると、Notionの認証フローがダイアログで開きます。
5. 複数のNotionワークスペースにアクセスできる場合は、接続するワークスペースを選択します。
6. Composioが要求するアクセス権を確認します。選択したページの閲覧・編集、ページ内でのコンテンツおよびコメントの作成、コメントの閲覧、ワークスペースユーザーとそのメールアドレスの閲覧が含まれます。
7. Select pages をクリックします。
8. Composioがアクセス可能なページを選択します。必要に応じて検索ボックスでページを検索し、ワークフローに必要なページのみを選択してください。
9. Allow access をクリックします。
10. 認証ダイアログが閉じてEMQXエージェントに戻るまで待ちます。
11. Added タブでコネクターのステータスが Authorized になっていることを確認します。

対応ツール

コンテンツの書き込み

ツール	アクセス	説明
NOTION_APPEND_TEXT_BLOCKS	書き込み	ページまたはブロックに段落、見出し、リストなどのテキストブロックを追記します。
NOTION_CREATE_COMMENT	書き込み	ページまたはディスカッションにコメントを作成します。
NOTION_CREATE_DATABASE	書き込み	Notionデータベースを作成します。
NOTION_CREATE_NOTION_PAGE	書き込み	Notionページを作成します。
NOTION_DELETE_BLOCK	破壊的操作	Notionブロックを削除します。
NOTION_DUPLICATE_PAGE	書き込み	Notionページを複製します。
NOTION_INSERT_ROW_DATABASE	書き込み	Notionデータベースに行を挿入します。
NOTION_UPDATE_BLOCK	書き込み	ブロックの内容を更新します。
NOTION_UPDATE_PAGE	書き込み	ページのプロパティを更新します。
NOTION_UPDATE_ROW_DATABASE	書き込み	データベースの行を更新します。
NOTION_UPDATE_SCHEMA_DATABASE	書き込み	データベースのスキーマを更新します。

コンテンツの読み取りおよびクエリ

ツール	アクセス	説明
NOTION_FETCH_ALL_BLOCK_CONTENTS	読み取り	ブロック配下のすべてのコンテンツを再帰的に取得します。
NOTION_FETCH_BLOCK_CONTENTS	読み取り	ブロックの直下の子ブロックを取得します。
NOTION_FETCH_COMMENTS	読み取り	ページまたはブロックのコメントを取得します。
NOTION_FETCH_DATABASE	読み取り	データベース情報を取得します。
NOTION_FETCH_ROW	読み取り	データベースの行を取得します。
NOTION_GET_ABOUT_USER	読み取り	Notionユーザーの情報を取得します。
NOTION_GET_PAGE_MARKDOWN	読み取り	ページの内容をMarkdown形式で取得します。
NOTION_GET_PAGE_PROPERTY_ACTION	読み取り	ページのプロパティ値を取得します。
NOTION_LIST_USERS	読み取り	Notionワークスペースのユーザー一覧を取得します。
NOTION_QUERY_DATA_SOURCE	読み取り	Notionのデータソースをクエリします。
NOTION_QUERY_DATABASE	読み取り	データベースの行をクエリします。
NOTION_QUERY_DATABASE_WITH_FILTER	読み取り	フィルター条件付きでデータベースをクエリします。
NOTION_RETRIEVE_COMMENT	読み取り	Notionコメントを取得します。
NOTION_RETRIEVE_DATABASE_PROPERTY	読み取り	データベースのプロパティ情報を取得します。
NOTION_RETRIEVE_PAGE	読み取り	ページのプロパティおよびメタデータを取得します。
NOTION_SEARCH_NOTION_PAGE	読み取り	Notionのページおよびデータベースを検索します。

ファイルアップロード

ツール	アクセス	説明
NOTION_CREATE_FILE_UPLOAD	書き込み	Notionのファイルアップロードタスクを作成します。
NOTION_LIST_FILE_UPLOADS	読み取り	ファイルアップロードの記録一覧を取得します。
NOTION_RETRIEVE_FILE_UPLOAD	読み取り	ファイルアップロードの状態および情報を取得します。
NOTION_SEND_FILE_UPLOAD	書き込み	ファイルアップロードタスクにファイル内容を送信します。

重要なお知らせ

ページ、データベース、スキーマ、行、ブロックの更新ツールはNotionのコンテンツを変更します。ブロック削除ツールはコンテンツを削除します。書き込み操作を行う前に対象のページ、データベース、ブロックを必ず確認してください。

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

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

権限とデータアクセス

コネクターは認証済みのNotionアカウントおよび統合の権限を使用します。選択されたページ、ワークスペースのメンバーシップ、リソース共有設定により、コネクターがアクセスできるページ、データベース、データソースが決まります。追加のページにアクセス権を付与するには、コネクターの再認証が必要です。

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

制限事項

• Notion APIのレート制限およびワークスペースのポリシーが適用されます。
• ブロックタイプやプロパティスキーマはページやデータベースによって異なります。
• ファイルアップロードの利用可否やサイズ制限はNotion APIに依存します。

トラブルシューティング

症状	解決策
コネクターが Unauthorized のままになる。	認証を再試行し、意図したワークスペースを選択し、必要なページを少なくとも1つ選択してから Allow access をクリックしてください。
ツールが権限エラーを返す。	認証済みアカウントが対象リソースにアクセス可能か、認証時にそのリソースを含むページが選択されているかを確認してください。追加ページへのアクセス権付与が必要な場合はコネクターを再認証してください。
必要なツールが利用できない。	ツールがこのコネクターでサポートされているか承認されているかを確認し、チャットで再度コネクターを選択してください。
リクエストが断続的に拒否される。	外部サービスのステータス、APIクォータ、レート制限、アカウントプランを確認してください。

関連リンク

• Connectors
• Start a Chat
• Manage Agents