创建你的第一个 Agent

本篇带你从零开始创建一个 Notion Custom Agent，了解四大核心配置项，让你的第一个 Agent 快速跑起来。

前提条件

使用 Custom Agent 功能需要订阅 Notion 商业版（Business）会员。如果你当前使用的是免费版或个人版（Plus），需要先升级到商业版才能看到 Agent 创建入口。

创建步骤

进入 Notion 后，点击左上角的「新建代理」按钮，即可打开 Agent 设置界面。

点击后会弹出一个设置面板，里面包含了 Agent 的四大核心配置项。

四大配置项

触发器（Trigger）

触发器决定 Agent 什么时候启动工作，相当于它的「上班时间」。

你可以设置 Agent 在特定条件下自动运行，比如当数据库中新增了一条记录、某个属性发生变化，或者按照固定的时间间隔定时执行。

如果不设置触发器，Agent 只能手动运行。

指令（Instruction）

指令是 Agent 的「工作内容手册」，定义了它要做什么、怎么做。

一份好的指令应该包含：你希望 Agent 完成什么任务、处理数据的规则和标准、输出的格式要求等。指令写得越清晰具体，Agent 的表现就越稳定可靠。

模型（Model）

模型是 Agent 的「脑子」，决定了它的理解能力和推理水平。

Notion 提供了多种模型可选。一般来说，越强大的模型处理复杂任务的效果越好，但每次运行消耗的 Token 也更多，意味着成本更高。对于简单的分类、整理任务，用基础模型就够了；涉及复杂判断和内容生成的任务，建议选择更强的模型。

工具与权限（Tools & Access）

工具与权限相当于给 Agent 配备的「电脑和门禁卡」，决定了它能操作哪些资源、使用哪些能力。

你可以授权 Agent 读写特定的数据库和页面，也可以为它开启网页搜索、发送邮件等内置工具。权限设置遵循最小权限原则：只给 Agent 完成任务所必需的权限，避免过度授权带来的风险。

活动范围

Custom Agent 的能力不限于 Notion 内部。通过 MCP 协议和 Worker，Agent 可以连接外部服务、调用第三方 API，实现跨平台的自动化工作流。

比如，你可以让 Agent 自动将 Notion 数据库中的内容同步到其他平台，或者从外部数据源拉取信息并写入 Notion。

Quick Tips

第一版指令别追求完美。先用简单的指令让 Agent 跑起来，观察它的实际表现，然后根据结果逐步调整和优化。迭代比一步到位更高效，也更容易发现问题。