---
title: Notion
description: 管理 Notion 页面
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="notion"
  color="#181C1E"
/>

{/* MANUAL-CONTENT-START:intro */}
[Notion](https://www.notion.so) 是一个集笔记、文档、维基和项目管理工具于一体的工作空间平台。它提供了一个灵活且可定制的环境，用户可以在各种格式中创建、组织和协作处理内容。

使用 Notion，您可以：

- **创建多功能内容**：构建文档、维基、数据库、看板、日历等
- **组织信息**：通过嵌套页面和强大的数据库以层次结构组织内容
- **无缝协作**：与团队成员共享工作空间和页面，实现实时协作
- **自定义工作空间**：使用灵活的模板和构建模块设计理想的工作流程
- **连接信息**：在页面和数据库之间建立链接，创建知识网络
- **随时随地访问**：通过网络、桌面和移动平台使用 Notion，并实现自动同步

在 Sim 中，Notion 集成使您的代理能够以编程方式直接与 Notion 工作空间交互。这支持强大的自动化场景，例如知识管理、内容创建和信息检索。您的代理可以：

- **读取 Notion 页面**：提取任何 Notion 页面中的内容和元数据。
- **读取 Notion 数据库**：检索数据库结构和信息。
- **写入页面**：向现有 Notion 页面追加新内容。
- **创建新页面**：在父页面下生成具有自定义标题和内容的新 Notion 页面。
- **查询数据库**：使用高级筛选和排序条件搜索和筛选数据库条目。
- **搜索工作空间**：在整个 Notion 工作空间中搜索符合特定查询的页面或数据库。
- **创建新数据库**：以编程方式创建具有自定义属性和结构的新数据库。

此集成弥合了您的 AI 工作流与知识库之间的差距，实现了无缝的文档和信息管理。通过将 Sim 与 Notion 连接，您可以自动化文档流程、维护最新的信息库、生成报告并智能地组织信息——这一切都通过您的智能代理完成。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Notion 集成到工作流程中。可以读取页面、读取数据库、创建页面、创建数据库、追加内容、查询数据库以及搜索工作区。需要 OAuth 授权。

## 工具

### `notion_read`

从 Notion 页面读取内容

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `pageId` | string | 是 | 要读取的 Notion 页面 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 以 markdown 格式显示的页面内容，包括标题、段落、列表和待办事项 |
| `metadata` | object | 包括标题、URL 和时间戳在内的页面元数据 |

### `notion_read_database`

读取 Notion 数据库的信息和结构

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `databaseId` | string | 是 | 要读取的 Notion 数据库 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 数据库信息，包括标题、属性架构和元数据 |
| `metadata` | object | 数据库元数据，包括标题、ID、URL、时间戳和属性架构 |

### `notion_write`

向 Notion 页面追加内容

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `pageId` | string | 是 | 要追加内容的 Notion 页面 ID |
| `content` | string | 是 | 要追加到页面的内容 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 确认内容已附加到页面的成功消息 |

### `notion_create_page`

在 Notion 中创建新页面

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `parentId` | string | 是 | 父页面的 ID |
| `title` | string | 否 | 新页面的标题 |
| `content` | string | 否 | 创建页面时可选的附加内容 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 确认页面创建的成功消息 |
| `metadata` | object | 页面元数据，包括标题、页面 ID、URL 和时间戳 |

### `notion_query_database`

使用高级过滤查询和筛选 Notion 数据库条目

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `databaseId` | string | 是 | 要查询的数据库 ID |
| `filter` | string | 否 | 作为 JSON 的过滤条件（可选） |
| `sorts` | string | 否 | 作为 JSON 数组的排序条件（可选） |
| `pageSize` | number | 否 | 返回结果的数量（默认：100，最大：100） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 格式化的数据库条目列表及其属性 |
| `metadata` | object | 查询元数据，包括总结果数、分页信息和原始结果数组 |

### `notion_search`

在 Notion 工作区中搜索所有页面和数据库

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `query` | string | 否 | 搜索词（留空以获取所有页面） |
| `filterType` | string | 否 | 按对象类型筛选：页面、数据库，或留空以获取所有 |
| `pageSize` | number | 否 | 返回结果数量（默认：100，最大：100） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 格式化的搜索结果列表，包括页面和数据库 |
| `metadata` | object | 搜索元数据，包括总结果数、分页信息和原始结果数组 |

### `notion_create_database`

在 Notion 中创建具有自定义属性的新数据库

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `parentId` | string | 是 | 创建数据库的父页面 ID |
| `title` | string | 是 | 新数据库的标题 |
| `properties` | string | 否 | 数据库属性，格式为 JSON 对象（可选，若为空将创建默认的“名称”属性） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `content` | string | 包含数据库详细信息和属性列表的成功消息 |
| `metadata` | object | 数据库元数据，包括 ID、标题、URL、创建时间和属性模式 |

## 注意事项

- 类别：`tools`
- 类型：`notion`

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `id` | string | 数据库 UUID |
| `url` | string | Notion 数据库 URL |
| `created_time` | string | ISO 8601 创建时间戳 |
| `properties` | object | 数据库属性结构 |
| `title` | string | 数据库标题 |

### `notion_add_database_row`

向 Notion 数据库添加一行并指定属性

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `databaseId` | string | 是 | 要添加行的数据库 ID |
| `properties` | json | 是 | 行属性，需为与数据库结构匹配的 JSON 对象（例如：`{"Name": {"title": [{"text": {"content": "Task 1"}}]}, "Status": {"select": {"name": "Done"}}}`） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `id` | string | 页面 UUID |
| `url` | string | Notion 页面 URL |
| `created_time` | string | ISO 8601 创建时间戳 |
| `last_edited_time` | string | ISO 8601 最后编辑时间戳 |
| `title` | string | 行标题 |
