# Notion

> 特定の Notion ページとデータベースへのアクセスをエージェントに与え、読み取り、クエリ、新しいページの作成を行えるようにします。

Notion コネクターを使うと、エージェントはワークスペースを検索し、ページをプレーンテキストとして読み取り、データベースをクエリし、ページを作成したり追記したりできます。

## 使いどころ

Notion は、本来ならエージェントにいちいち伝えなければならないコンテキスト（仕様書、議事録、プロジェクトの管理表）を、チームが蓄積している場所です。Notion を読めるエージェントは背景を尋ねてこなくなり、自分の成果物を、チームがすでに見ている場所に保存できます。

## 接続する

<Steps>

1. [エージェントビルダー](/ja/docs/build/agent-builder/)で**コネクターを開き**、Notion を選びます。

2. **ログインし、共有するものを選びます**。Notion の同意画面で、インテグレーションがアクセスできるページを尋ねられます。これがアクセス制御であり、Notion 側で管理されます。

3. **接続をエージェントに紐付けます**。

</Steps>

<Aside type="caution" title="結果が空なら、たいていはページが共有されていません">
  何も見つからない検索は、スペルの問題よりも共有の問題であることのほうが多いです。認可したときに含めなかったページや、その後に作成したページは、Notion のページメニューからインテグレーションと共有してください。
</Aside>

## エージェントができること

| 操作 | 承認 |
| --- | --- |
| タイトルでページとデータベースを検索 | 不要 |
| ネストされたリストやトグルを含め、ページをプレーンテキストとして読み取り | 不要 |
| 1つのプロパティで絞り込んでデータベースをクエリ | 不要 |
| ページの下またはデータベース内にページを作成 | 不要 |
| 既存のページにコンテンツを追記 | 不要 |

Notion には、既定で承認が必要な操作はありません。これらの操作はいずれも、外部に何かを送信したり、データを削除したりしないためです。作成と追記はワークスペースを変更します。エージェントは事前に場所とタイトルをあなたに確認するよう指示されていますが、[承認](/ja/docs/work/approvals/)ゲートで止まるわけではありません。

## 使い方のコツ

- **まず検索する**。エージェントがページを読んだり追記したりするには、そのページの ID が必要です。そのため、「*ロードマップのページを更新して*」のような曖昧な指示では、検索のステップが1つ増えます。ページのリンクを貼り付けるほうが速く済みます。
- **非常に長いページは切り詰められます**。ページを読み取ると、収まる分だけが返され、途中で切れたことが示されます。大きなドキュメントでは、該当するセクションを指示してください。
- **データベースのクエリは、1つのプロパティで絞り込みます**。条件が複数ある複雑なビューは Notion 側で作成し、その結果をエージェントに読ませるほうが適しています。

## 制限事項

- エージェントに見えるのは、Notion でインテグレーションと共有したものだけです。
- 読み取った結果はプレーンテキストです。ページ内のデータベース、同期ブロック、複雑なレイアウトといった Notion 固有の構造は平坦化され、書式も往復で完全には再現されません。
- 削除の操作はありません。
- エージェントが作成したページは Notion インテグレーションが所有者となり、ページ履歴にもそのように表示されます。

## 関連項目

<CardGrid>
  <LinkCard
    title="コネクターの概要"
    href="/ja/docs/connect/overview/"
    description="接続と紐付けの違い、アクセスの取り消し。"
  />
  <LinkCard
    title="プロジェクト"
    href="/ja/docs/capabilities/projects/"
    description="毎回取りに行く代わりに、コンテキストを endue の中に置く。"
  />
  <LinkCard
    title="利用できるコネクター"
    href="/ja/docs/connect/available-connectors/"
    description="Linear、GitLab など、カタログのその他のコネクター。"
  />
</CardGrid>
