在自托管 n8n 上开启 Agents：模块开关、运行模式限制与 Community 许可证红线实操

# Docker Compose 的 environment 段加：
N8N_ENABLED_MODULES=agents

# 重启实例
docker compose up -d --force-recreate

# 验证：打开编辑器，左侧导航出现 Agents 标签

最低设置就这一个变量。版本底线要记牢：官方文档记录的自托管门槛是 2.32.3（预发布版本）——7 月 24 日的 2.32.5 是达到门槛的稳定版本起点；当前 stable 是 2.41.5（10 月 1 日），beta 通道是 2.42.2。Agent Builder 的界面打磨多数落在 2.42.x beta，但 npm 的 latest 标签指向 2.41.5，生产实例跟 stable 走，测试机想尝鲜再上 beta。

# Agents 标签 → New agent，用自然语言描述任务：
# 「把 RSS 源里的新文章做摘要，每天早上九点发到 Slack」

# Builder 会引导你挂上：
#   1) 一个聊天模型节点
#   2) 需要的工具（内置集成，或把既有工作流作为工具）
# 保存后在会话里让它执行一轮，观察它怎么拆步骤、调工具

和画布构建的本质区别在控制权归属：画布里你画好每条连线，Agent 里你给目标和资源、它自己排步骤。合适的选择标准也在这里——步骤能画成固定流程的别用 Agent；「拿到结果就行、路径不止一条」的任务才交给它。观察运行轨迹是评估的关键环节：它选的工具、调用的顺序、失败的兜底，都直接告诉你这套东西在你的场景里靠不靠谱。

# 参考文档列出的通道：Slack / Telegram / Linear
# 配置对应凭据后，Agent 可在通道里被 @ 或私聊触发

# 注意：changelog 与发布博客还提到 Discord，
# 以你安装版本的参考文档实际列出项为准

通道的意义是把 Agent 从「编辑器里的实验品」变成「同事能在 IM 里直接使唤的助手」：Slack 里 @ 它做会议纪要、Telegram 里丢给它一个待办、Linear 里让它跟踪工单状态。通道配置走 n8n 既有凭据体系，和你接 Slack 通知节点是同一套凭证管理。

# 检查自己是不是 queue mode（多数生产自托管是）：
docker compose config | grep -i "EXECUTIONS_MODE"
# 结果为 EXECUTIONS_MODE=queue 时：
#   Agents 当前不支持 —— 留在测试实例（regular mode）上试

三个明确的等待项。其一，queue mode 不支持 Agents——而跑在队列模式上的恰恰多数是重视可用性的生产实例，这意味着「生产直接开」这条路暂时不存在，先在测试实例验证价值。其二，自托管 Enterprise 尚未可用（changelog 的 Preview 表述大概率指 Cloud Enterprise，找 n8n 确认而非假设）。其三，模型调用经过 OpenAI 兼容网关的用户注意：Agent Builder 与网关的兼容 issue 还没关闭，网关路由下行为可能异常，跟进官方 issue 关闭状态再上。

# Community（Sustainable Use License）相关条款要点：
# 禁止：允许「外部终端用户」通过你的产品构建或配置工作流
#       —— 无论经由自定义 UI、API、MCP，
#          还是代表用户行事的 AI Agent
# 允许：为外部用户触发你预先构建好的工作流

翻译成判断题：给客户做一个「让 AI 帮他们搭自动化」的功能，超出了 Community 许可范围——因为外部用户在你的产品里配置工作流的动作被条款明确禁止；而「我们替客户搭好流程，他们只管触发」完全合规。内部同事当用户的内部部署不在此列。Agents 恰好把「用 AI 生成自动化」变成产品卖点，做 SaaS 的团队这条红线要贴在墙上。

# n8n 官方对 Agents 的忠告（changelog 原话）：
# "Test before you publish, and require approval on
#  tools that write to your systems."
# 落地两件事：写操作工具加审批；发布前测试环境跑通

# npm 安装大限：n8n 3.0（10 月）起 npm 安装方式停止工作
# Docker 迁移（数据卷承接旧数据）：
docker volume create n8n_data
docker run -d --name n8n -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  -e N8N_ENABLED_MODULES=agents \
  docker.n8n.io/n8nio/n8n

既有工作流完全不受影响——Agents 是并列的新构建方式，不是对 AI Agent 节点的替换；你之前照着站内教程搭的聊天机器人、pgvector RAG 升级那套继续照常跑。真正的迁移压力来自部署方式本身：npm 安装在 3.0 后停用，还在用 npm 跑的实例这轮升级就是死线，顺手把 N8N_ENABLED_MODULES 写进容器环境变量，一次迁移两件事。