使用 n8n Assistant
n8n Assistant 是 n8n 中基于聊天的 agent,可帮助你用自然语言创建、编辑、测试和排查工作流。它还可以构建 agents,并帮助处理实例任务,例如重命名或发布工作流。
描述你想自动化的内容。n8n Assistant 可以规划工作流,在你选定的项目中构建它,测试它,并帮助你修复错误。
生成结果是一个普通的 n8n 工作流。你可以像处理其他工作流一样打开、检查、编辑、测试和发布它。
提示
Feature availability 功能可用性
n8n Assistant 可用于:
- n8n Cloud: Starter、Pro、Enterprise
- Self-hosted: Community、Registered Community、Business、Enterprise
提示
有限的企业就绪程度
n8n Assistant 具有 Limited enterprise readiness(有限的企业就绪程度)。它部分支持以下 Enterprise 能力:
- RBAC and project scoping
- Data residency
- Queue mode and multi-main
- Environments and source control
其他 Enterprise 能力要么不适用于 n8n Assistant,要么它尚不支持。有关完整的 Enterprise 能力列表,请参阅了解功能可用性。
n8n Assistant 可能会出错。在生产环境中使用生成的工作流之前,请务必先检查。
n8n Assistant 可以帮助你做什么
你通过聊天与 n8n Assistant 交互。它可以使用 n8n 内部工具来帮助你创建和调试工作流。
你可以让 n8n Assistant:
- 创建工作流:描述你想要的自动化,n8n Assistant 可以生成工作流。
- 构建 agents:描述你想要的 agent,n8n Assistant 可以建议要添加的 instructions、tools 和 skills。Agents 也可以通过
agentsmodule 在自托管环境中运行。请参阅构建和管理 agents和启用 agents。 - 连接 MCP 服务器:从 MCP 服务器 注册表直接连接服务器,让 n8n Assistant 执行任务,并在为你构建工作流时收集上下文。
- 在浏览器中工作:连接 Browser Use,让 n8n Assistant 可以浏览网站、填写表单并为你设置凭据。
- 编辑工作流:要求它修改工作流、添加节点、更新逻辑或调整配置。
- 测试和排查工作流:要求它运行检查、查看相关错误并建议修复方法。
- 帮助处理凭据:提示你选择已有凭据或创建新凭据,而不需要把密钥粘贴到聊天中。
- 使用 n8n 资源:在需要时创建或更新支持资源,例如 Data Tables。
- 研究已批准的网站:启用网页访问时,n8n Assistant 会在访问域名之前请求你的许可。
- 接续最近的工作:询问你之前构建的工作流或失败的执行,n8n Assistant 无需你说出名称即可找到它。
n8n Assistant 了解你的实例中的哪些信息
提示
Preview status 预览状态
实例上下文处于 Preview 阶段,可能会在未来版本中发生变化。n8n 尚未为所有实例启用实例上下文。请避免在生产工作中依赖实例上下文。
在对话开始时,n8n Assistant 会收到实例上下文:你打开它所在项目的简短摘要。这有助于 n8n Assistant 响应「查找上次失败的执行」之类的提示,而无需你说出工作流名称。
实例上下文来自三个来源:
| 实例上下文报告的内容 | 来源 |
|---|---|
| 项目中有哪些工作流及其发布状态 | 你的工作流 |
| 最近的更改及更改者 | 实例活动日志 |
| 哪些工作流运行过、失败次数以及最近一次失败 | 你的执行历史记录 |
你在对话中发送第一条消息时,n8n Assistant 会获得初始摘要。摘要会限制其中包含的工作流、活动条目和执行记录数量。n8n Assistant 可以在需要时检索更多详情。之后,每条消息仅携带自上次以来发生的变化。对于不相关的工作,请开启新对话,n8n Assistant 会从头重新读取项目。
在 n8n Cloud 上,n8n 控制实例上下文的访问权限。在自托管实例上,实例管理员可以覆盖功能标志以启用实例上下文。请参阅启用实例上下文。
n8n Assistant 可以从实例上下文中查找什么
实例上下文保存的是指针,而不是内容。n8n Assistant 可以借此:
- 回溯更早的最近更改。实例上下文覆盖一个近期时间窗口。n8n Assistant 可以列出更早的条目,筛选工作流或凭据更改,或者打开一个条目来查看单个工作流最近的更改历史记录。
- 打开实时记录。每一行都带有 ID,因此 n8n Assistant 可以获取它所指向的工作流、执行或凭据。
活动条目遵循你的活动日志保留设置。执行遵循你的执行数据保留设置。如果 n8n 已清理某个活动条目,n8n Assistant 会在没有该条目的情况下继续工作。
n8n Assistant 如何了解你使用的节点
节点类型计数是独立于实例上下文的设置,必须由实例管理员启用。请参阅启用节点类型计数。
启用后,n8n Assistant 可以询问项目中有多少工作流使用每种节点类型,无需读取每个工作流来了解你的惯例。它只报告节点类型的数量,从不报告参数值。因此,它可以说明 10 个工作流中的 10 个都使用 Slack 节点,但不会说明你如何配置这些节点。要遵循某项惯例而不只是说出其名称,n8n Assistant 会完整读取一个工作流。
实例上下文不包含什么
活动日志会记录发生了更改,但不会记录更改的具体内容。要回答有关工作流结构或配置的问题,n8n Assistant 会读取工作流本身。
实例上下文不包含:
- 参数值。更改条目会列出你添加或删除的节点类型以及更改的设置,但绝不会记录你设置的值。
- 单个节点。保存条目会列出添加或删除的节点类型,而不是单个节点。添加第二个 Slack 节点会更改节点总数,但不会新增节点类型。
- 大型更改中的每一种节点类型。一次保存超过节点类型限制时,条目会列出其中一部分并报告总数。
- 未打开项目中的工作。请参阅实例上下文仅限一个项目。
n8n Assistant 如何应用你的偏好
提示
功能可用性
偏好从 n8n 2.40.0 起可用。从 n8n Assistant 保存偏好从 n8n 2.42.0 起可用。
提示
预览状态
偏好属于 agentic context management,目前处于 Preview,未来版本可能会变化。请避免在生产工作流中依赖它们。
偏好是简短的指令,例如「节点名称使用英文,并以动词开头」。n8n Assistant 每次为你构建时都会应用它们。你发送的每条消息,n8n Assistant 都会读取这些偏好,因此你保存或编辑的偏好会从下一条消息起生效,即使对话仍在进行中。
在一次对话中,n8n Assistant 会应用 Global 全局偏好、你自己的偏好,以及你打开对话所在项目的偏好。如果某条偏好与你的提示冲突,n8n Assistant 会遵循你的提示。
要查看 n8n Assistant 对最新回复应用了哪些偏好,打开聊天输入框中的 + 菜单,然后选择 Preferences 偏好。
当你在聊天中说出一条长期规则,例如「从现在起,始终添加一个错误工作流」,n8n Assistant 会把它保存为只适用于你、且在每个项目中都生效的偏好。它会显示一张包含已保存文本的卡片。在卡片上选择 Edit 编辑可以修改文本或范围,或删除该偏好。实例 owner 和 admin 可以在 Settings 设置 > Assistant > Permissions 权限中,用 Save preferences from chat 从聊天保存偏好权限阻止 n8n Assistant 保存偏好。
要管理你的全部偏好,请前往 Settings 设置 > Context 上下文 > Preferences 偏好。
开始之前
要使用 n8n Assistant,你需要访问已启用该功能的 n8n 实例。
确保:
- 你可以访问希望 n8n Assistant 操作的项目。
- 你有权限使用任务所需的工作流、凭据和资源。
- 你清楚希望工作流完成什么任务。
n8n Assistant 使用你的 n8n 用户权限。它只能访问你有权使用的工作流、凭据和资源。
编写有效提示词
具体的提示词可帮助 n8n Assistant 用更少的迭代生成更好的结果。
编写提示词时,请包含:
- 什么应该触发工作流;
- 工作流应该使用哪些应用或服务;
- 工作流应该读取、发送或更新哪些数据;
- 工作流成功时应该发生什么;
- 工作流失败时应该发生什么;
- n8n Assistant 是否应在发布工作流前询问你。
示例提示词
创建工作流
Create a workflow that checks Gmail every morning for invoices,
saves PDF attachments to Google Drive, and adds a row to a Data Table.
Ask me before publishing the workflow.
调试失败的执行
Debug the latest failed execution of this workflow.
Explain what failed, then suggest a fix before changing anything.
更新已有工作流
Update this workflow so failed orders are sent to Slack,
then retry the API request after 10 minutes.
检查 AI 生成的更改
n8n Assistant 可以在你的 n8n 实例中执行操作,但控制权仍在你手中。
在生产环境中使用 AI 生成的工作流之前:
- 检查工作流逻辑。
- 检查节点配置和凭据。
- 使用预期输入数据测试工作流。
- 检查执行结果和错误处理。
- 确认工作流不会执行非预期操作。
n8n Assistant 会在发布、删除或进行其他重要更改等高影响操作前请求确认。
凭据处理
你的凭据密钥永远不会发送给 AI,AI 也不会看到这些密钥。
n8n Assistant 从 n8n 2.41.0 起可以读取凭据描述。从 n8n 2.42.0 起,只有实例启用凭据描述后,n8n Assistant 才会读取这些描述。
n8n Assistant 会利用可用的凭据描述,在同一类型的多个凭据之间进行选择。例如,描述可以标明生产账户或测试账户。如果仍无法确定该选择,n8n Assistant 会询问你要使用哪个凭据。
AI 可以接收凭据描述。不要在描述中包含 API key、密码或 token。
当工作流需要凭据时,n8n Assistant 会在聊天中通过凭据卡片提示你。你可以从该卡片:
- 选择你在项目中有权访问的已有凭据。
- 创建新凭据。
你还可以要求 n8n Assistant 使用 Browser Use 在浏览器中为你创建凭据。密钥会直接写入凭据,AI 永远看不到它。
如果你自行创建新凭据,会在标准 n8n 凭据页面中输入密钥,而不是在聊天中输入。不要把 API key、密码或 token 粘贴到对话中。
网页访问
启用网页访问后,n8n Assistant 会在访问外部域名之前请求你的许可。
批准访问前,请检查请求访问的域名。
限制
n8n Assistant 的可用性、支持的操作和行为可能会变化。
请注意:
- n8n Assistant 可能尚不支持某些操作。
- 某些能力可能会逐步推出。
- n8n Assistant 可能比预期更频繁地要求澄清。
- 生成的工作流可能需要人工检查和修正。
- UI、额度用量和支持资源可能发生变化。
数据和隐私
n8n Assistant 会处理帮助构建和排查工作流所需的信息。
根据任务不同,这可能包括:
- 你的提示词和聊天消息;
- 工作流结构和节点配置;
- 用于排查问题的选定执行和错误详情;
- 凭据名称、类型、描述或连接状态;
- 启用网页访问时,已批准的网页或域名;
- 你打开 n8n Assistant 的项目中的工作流名称;
- 该项目中最近的工作流和凭据更改记录;
- 其中哪些工作流运行过,以及哪些执行失败。
n8n Assistant 不要求你把密钥粘贴到聊天中。请通过标准 n8n 凭据页面输入 API key、密码和 token。
警告
除非任务确实需要,否则不要把敏感数据粘贴到聊天中。AI 生成的输出可能不正确,因此在生产环境中使用工作流和配置之前,请先进行检查。
实例上下文仅限一个项目
对话使用你打开 n8n Assistant 所在的项目。自动实例上下文和活动日志搜索只读取该项目。工作流搜索和节点类型计数可以包含你有权读取的其他项目。
n8n Assistant 使用你自己的权限读取实例上下文,而且 n8n 会在每条消息中检查权限,而不是只在开始时检查一次。如果你失去该项目的访问权限,n8n Assistant 就会停止读取它。
查找对话项目之外的活动条目 ID,会得到与查找不存在条目相同的结果。这些请求不会泄露其他项目中是否存在某个条目。
额度用量
在 n8n Cloud 上,n8n Assistant 根据底层 AI 模型处理的 token 使用 Assistant credits。你的计划每月包含一定数量的 Assistant credits,并在每月第一天重置。额度用尽后,实例所有者可以购买额外额度,以便在下次重置前继续使用 n8n Assistant。实例中的所有用户共享同一余额。
Assistant credits 与 Gateway credits 相互独立。Assistant credits 用于支付你与 n8n Assistant 的对话,而不是工作流或 agent 运行时调用的 AI 模型。Gateway credits 用于支付这些模型调用,而不是 n8n Assistant。为其中一种额度充值不会增加另一种额度。
更长的对话、更大的工作流、调试会话和反复迭代会使用更多额度。
要减少不必要的用量:
- 明确工作流目标和约束。
- 为无关任务开启新对话。
- 在要求 n8n Assistant 构建之前先检查它的计划。
- 避免在没有新增指导的情况下要求它反复重新生成同一个工作流。
要查看余额,请打开 n8n Assistant 面板中的 credits 菜单。有关你所在计划的每月额度,请参阅 n8n plans and pricing。
自托管 n8n 不使用 Assistant credits。在自托管实例上,n8n Assistant 使用你自己的 AI 服务提供商账户。请参阅设置 n8n Assistant。