n8n 中文文档

偏好

偏好是你写一次的简短指令,例如「始终连接一个错误工作流」。n8n Assistant 和已连接的 MCP 客户端每次为你构建工作流和 agents 时都会应用这些指令。

提示

功能可用性

偏好可用于:

  • n8n Cloud: Starter、Pro
  • 自托管: Community、Registered Community、Business

偏好暂未在 n8n Cloud Enterprise 或自托管 Enterprise 上提供。

偏好从 n8n 2.40.0 起可用。从 n8n Assistant 保存偏好,以及 n8n MCP 服务器上的偏好工具,从 n8n 2.42.0 起可用。

提示

预览状态

偏好是智能体上下文管理的一部分。该功能处于 Preview 阶段,可能会在未来版本中变化。请避免在生产环境中依赖智能体上下文管理。

偏好用来做什么

如果有一条规则你希望 AI 工具在每个任务中都遵循,而不只是当前这一次,就把它写成偏好。合适的偏好包括:

  • 节点和凭据选择:「告警使用名为 ops-bot 的 Slack 凭据。」
  • 命名:「用英文给节点命名,并以动词开头。」
  • 工作如何组织:「把新工作流放进 Drafts 文件夹。」
  • 要避免的做法:「内置节点能完成工作时,不要使用 Code 节点。」
  • 沟通风格:「用两句话以内解释更改。」

仅针对当前任务的指令留在提示词里。「把这一项改成 POST 请求」属于聊天内容,不属于偏好。

n8n 在哪里应用偏好

有两个 AI 界面会读取偏好:

界面 何时读取偏好
n8n Assistant 在你发送的每条消息上读取。因此你保存或编辑的偏好会从下一条消息起生效,即使当前对话还开着。
连接到 n8n MCP 服务器 的 MCP 客户端 客户端调用 get_user_preferences 工具时读取。n8n MCP 服务器会告诉客户端,在 n8n 中创建或更改任何内容之前先调用该工具。

如果某条偏好与你直接提出的要求冲突,AI 工具会遵循你的要求,并告诉你它搁置了哪条偏好。

偏好范围

偏好的范围决定它适用于谁。创建或编辑偏好时,在 Scope 范围 字段中选择范围。

范围标签 适用于 谁可以创建、编辑或删除
Just you · All projects 仅你 · 所有项目 仅你,在每个项目中 你
Just you · Personal project 仅你 · 个人项目 仅你,并且只在你使用个人项目时 你
团队项目的名称(列表中显示为 Project 项目) 在该项目中工作的所有人 项目管理员和项目编辑者。项目查看者可以看到,但不能更改。
Global 全局 实例上的所有人 实例所有者和实例管理员

n8n 会同时应用范围内的每条偏好。在一次对话中,n8n Assistant 会收到 Global 全局 偏好、你自己的偏好,以及你打开该对话时所在项目的偏好。MCP 客户端会收到 Global 全局 偏好、你自己的偏好,以及你能够读取的每个项目的偏好,并按项目分组。传入 projectId 的客户端只会收到那一个项目的偏好,而不是每个项目的偏好。

把偏好移到另一个范围,需要有权从旧范围删除它,并有权在新范围创建它。

偏好限制

限制 值
单条偏好的长度 2,000 个字符
同一范围内的偏好数量 50
同一范围内的重复文本 不允许。如果文本与同一范围内已保存的某条偏好相同,n8n 会拒绝。

某个范围已满时,先删除一条偏好,再添加新的。

在设置中创建偏好

  1. 选择 Settings 设置 > Context 上下文。
  2. 选择 Preferences 偏好。
  3. 选择 Create preference 创建偏好。
  4. 在 Preference 偏好 中写下指令。像告诉同事那样来写,例如「始终连接一个错误工作流,这样一旦出现失败,就会在 Slack 上通知我」。
  5. 在 Scope 范围 中选择这条偏好适用于谁。各选项见偏好范围。
  6. 选择 Save 保存。

n8n Assistant 会从你的下一条消息起应用这条新偏好。MCP 客户端会在下次调用 get_user_preferences 时应用它。

在设置中编辑或删除偏好

Settings 设置 > Context 上下文 > Preferences 偏好 会列出你能看到的每条偏好。列表显示每条偏好的 Scope 范围、Created by 创建者 和 Last updated 上次更新。Created by 创建者 写的是创建该偏好的人;如果是 AI 工具保存的,后面会用括号注明来源,例如「Jane Doe (MCP)」或「Jane Doe (n8n assistant)」。

  • 要编辑偏好: 打开该偏好的 Options 选项 菜单,选择 Edit 编辑,更改文本或范围,然后选择 Save 保存。
  • 要删除偏好: 打开该偏好的 Options 选项 菜单,然后选择 Delete 删除。
  • 要删除多条偏好: 在列表中选中它们,然后选择 Delete selected 删除所选。

删除无法撤销。n8n Assistant 和 MCP 客户端会立即停止使用已删除的偏好。

如果你没有更改某条偏好的权限,n8n 会把它显示为只读。

从 n8n Assistant 保存偏好

当你告诉 n8n Assistant 一条长期规则时,例如「从现在起,始终添加一个错误工作流」,它会把这条规则保存为范围是 Just you · All projects 仅你 · 所有项目 的偏好。它不会保存仅针对当前任务的一次性指令。

保存偏好后,n8n Assistant 会在聊天中显示一张卡片,上面是已保存的文本。在卡片上:

  • 选择 Edit 编辑,更改文本或范围。
  • 在 Edit preference 编辑偏好 对话框中,选择 Remove preference 移除偏好 来删除它。

要查看 n8n Assistant 对最新一条回复应用了哪些偏好,打开聊天输入框中的 + 菜单,然后选择 Preferences 偏好。

实例所有者和实例管理员可以控制 n8n Assistant 能否保存偏好。在 Settings 设置 > Assistant > Permissions 权限 中,将 Save preferences from chat 从聊天中保存偏好 设为 Allow 允许(默认)或 Block 阻止。设为 Block 阻止 后,n8n Assistant 仍会应用已保存的偏好,但不能保存新的偏好。

从 MCP 客户端保存偏好

连接到 n8n MCP 服务器的 MCP 客户端可以通过四个工具读取和保存偏好:

工具 作用
get_user_preferences 读取适用于你的偏好
save_user_preference 保存一条范围为 Just you · All projects 仅你 · 所有项目 的新偏好
update_user_preference 更改偏好的文本、范围,或两者都改
undo_user_preference 移除 MCP 客户端为你保存的偏好

undo_user_preference 无法移除你在设置中编写的偏好,也无法移除为某个项目或整个实例保存的偏好。请在 Settings 设置 > Context 上下文 > Preferences 偏好 中移除这些偏好。

如果你的 MCP 客户端支持 MCP 征询(elicitation),save_user_preference 保存偏好后,n8n 会向你显示一张审核表单。在表单中,你可以:

  • 按所示内容接受文本,或先编辑再接受。
  • 如果你是实例所有者或实例管理员,把范围改为 Everyone on this n8n instance 此 n8n 实例上的所有人。
  • 拒绝该表单,以移除这条偏好。

不回答就关闭表单,会保留这条已保存的偏好。

偏好的 MCP 客户端权限

使用 OAuth 连接 MCP 客户端时,n8n 会要求你批准两项与偏好相关的权限:

同意屏幕上的权限 OAuth 范围 工具
Read AI preferences 读取 AI 偏好 aiPreference:read get_user_preferences
Save, update and undo AI preferences 保存、更新和撤销 AI 偏好 aiPreference:write save_user_preference、update_user_preference、undo_user_preference

只有实例已开启偏好时,n8n 才会提供这些权限。如果你在开启偏好之前就连接了客户端,请重新连接以授予这些权限。请参阅查看和撤销客户端访问权限。

关于每个工具的参数和输出,请参阅 MCP 服务器工具参考中的用户偏好。

编写有效的偏好

AI 工具会把一条偏好应用到其范围内的每个任务,因此要写得在每个任务里都站得住。

  • 每条偏好只写一条规则。 一条规则以后比一整段里的好几条规则更容易编辑或删除。
  • 写明要做什么;如果有帮助,也写明原因。 「客户邮件使用名为 support-inbox 的 Gmail 凭据」比「使用正确的凭据」更明确。
  • 写明具体的节点、凭据、文件夹和项目。 AI 工具会按名称精确匹配。
  • 避免只适用于一个工作流的规则。 把那些规则写进提示词。
与其这样写 改成
「把 webhook 路径设为 /orders。」 留在提示词里。它只适用于一个工作流。
「小心处理错误。」 「把每个新工作流都连接到 Error alerts 错误工作流。」
「用好名称,把东西放进文件夹,并且避免 Code 节点。」 写成三条偏好:一条管命名,一条管文件夹,一条管 Code 节点。

在自托管实例上开启偏好

偏好默认开启。如果实例关闭了遥测(N8N_DIAGNOSTICS_ENABLED=false),或者无法访问 n8n 的功能标志服务,偏好会保持关闭。

要开启偏好,请设置 N8N_FEATURE_FLAG_OVERRIDES。例如,把下面的值加入 .env 文件。保留 JSON 对象中的其他条目。

N8N_FEATURE_FLAG_OVERRIDES='{"111_context_preferences":"variant"}'

重启 n8n 以应用这项更改。

该值必须是字符串 "variant"。布尔值(例如 true)不会开启偏好。

偏好关闭时,n8n 会在 Settings 设置 > Context 上下文 中隐藏 Preferences 偏好,n8n Assistant 不会读取或保存偏好,n8n MCP 服务器也不会提供偏好工具。n8n 会保留此前保存的偏好,并在你重新开启偏好后再次应用它们。

排查偏好问题

设置中不显示偏好

确认实例运行的是 n8n 2.40.0 或更高版本,并且不在 Enterprise 计划上。在关闭了遥测的自托管实例上,请参阅在自托管实例上开启偏好。

MCP 客户端没有列出偏好工具

确认实例已开启偏好,然后确认该客户端拥有 Read AI preferences 读取 AI 偏好 和 Save, update and undo AI preferences 保存、更新和撤销 AI 偏好 权限。如果你在开启偏好之前就连接了该客户端,请撤销其访问权限,然后重新连接。

n8n Assistant 提示无法保存偏好

实例所有者或实例管理员已在 Settings 设置 > Assistant > Permissions 权限 中把 Save preferences from chat 从聊天中保存偏好 设为 Block 阻止,或者实例已连接到受保护的源代码管理分支。如果你有权限,请改为在 Settings 设置 > Context 上下文 > Preferences 偏好 中创建这条偏好。

AI 工具忽略了某条偏好

确认这条偏好的范围覆盖你正在使用的项目。在 n8n Assistant 中,团队项目的偏好只适用于在该项目中打开的对话。如果偏好与你的提示词冲突,AI 工具会遵循你的提示词。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。