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

想定されるワークフロー

コネクタのアクション

• query_database (読み取り)

  フィルターと並べ替えでデータベースを照会する。

• search (読み取り)

  タイトルで共有ページまたはデータベースを検索する。

• get_page (読み取り)

  ページとそのプロパティを取得する。

• get_database (読み取り)

  データベースのスキーマを取得する。

• list_block_children (読み取り)

  ページの詳細な内容を読み取る。

• create_page (書き込み)

  データベース内、または親ページの下にページを作成する。

• update_page (書き込み)

  ページのプロパティを更新する。

• append_paragraph (書き込み)

  ページにテキスト段落を追加する。

• append_to_do (書き込み)

  ページにチェックボックスを追加する。

• create_comment (書き込み)

  コメントを追加、または既存のスレッドに返信する。

• archive_page (書き込み)

  ページをゴミ箱にアーカイブする。復元可能。

前提条件

• notion.so/my-integrationsで、1つのワークスペースに紐づく内部インテグレーションを作成する。
• Read content、Update content、Insert contentのcapabilityと、コメント機能を有効にする。
• インテグレーションのシークレット(prefixがntn_またはsecret_)をコピーする。表示は一度だけ。
• •••に続いてConnectionsから、各ページまたはデータベースをインテグレーションと共有する。
• Atako側で、エージェントにgrantを付与するためのインテグレーション管理権限。

接続方法

1. 1

   Notionインテグレーションを作成する

   notion.so/my-integrationsで、インテグレーションを作成し、ワークスペースを選び、capabilityを有効にして、シークレットをコピーする。

2. 2

   ページをインテグレーションと共有する

   エージェントに渡す各ページまたはデータベースを開き、•••、続いてConnectionsをクリックしてインテグレーションを選択する。このステップなしでは、トークンだけでは何にもアクセスできない。

3. 3

   AtakoでNotionを接続する

   設定、続いて連携で、手順1でコピーしたシークレットを貼り付ける。

4. 4

   エージェントにgrantを付与する

   エージェントのページ(このエージェントの連携)または接続画面(アクセス権を管理)から、許可する具体的なアクションとその範囲(読み取り専用または読み書き)を選択する。