Exercise 4: 部署你的 Agent

练习目标

将前几周设计的 Agent 工作流实际部署到运行环境中,并设置基本的监控。

步骤

Step 1: 选择部署方式(10 分钟)

根据你的场景选择:

方案推荐场景
n8n Cloud (免费试用)快速验证、<100次/天执行
本地 Docker n8n数据敏感、需要定制
纯代码 + Bun复杂逻辑、需要单元测试

Step 2: 部署工作流(30 分钟)

n8n 方案:

  1. 注册 n8n Cloud 或本地启动 Docker
  2. 导入 workflow JSON(可以从 workflow-templates 项目导出)
  3. 配置所有 credentials
  4. 手动触发一次,验证每个节点

纯代码方案:

  1. 创建 TypeScript 项目
  2. 实现核心逻辑
  3. 添加 HTTP trigger(Hono/Express)
  4. 部署到 Railway/Fly.io/自有服务器

Step 3: 测试(20 分钟)

准备 5 个测试用例:

  1. 正常输入 — 预期行为
  2. 边界输入 — 空值、超长文本、特殊字符
  3. 异常输入 — 格式错误、缺少必填项
  4. 并发输入 — 同时发送多个请求
  5. 故障模拟 — 外部 API 不可用

记录每个测试的结果。

Step 4: 设置监控(15 分钟)

至少设置以下监控:

  • 执行成功/失败通知(Slack/Email)
  • 日执行量统计
  • 错误日志收集
  • API 费用追踪(在 Anthropic Console 中设置用量告警)
  • Step 5: 文档化(10 分钟)

    写一个简短的运维文档:

    • 如何查看日志
    • 出问题时怎么排查
    • 如何临时禁用 Agent
    • 谁负责监控

    评分标准

    • 成功部署并能正常执行: 30%
    • 测试覆盖度(5 个场景都测试了): 25%
    • 监控设置完整性: 25%
    • 运维文档质量: 20%