用途
Lindy Deploy Integration 用于部署与 Lindy AI 智能体集成的应用。Lindy 智能体运行在 Lindy 托管的基础设施上，因此部署的重点在于集成层：webhook 接收器、回调处理器，以及 Lindy 智能体通过 HTTP Request 动作和 webhook 触发器进行交互的应用代码。
主要能力
该技能覆盖以下部署环节：
- 准备生产就绪的应用，包含健康检查端点与带鉴权验证的 Lindy webhook 接收器。
- 使用 Docker 构建和运行集成应用。
- 使用 Vercel 部署并配置密钥。
- 部署后更新 Lindy 智能体中的 webhook URL（从开发/预发环境切换到生产环境）。
- 执行部署后验证，包括健康检查、webhook 端点可达性测试以及触发测试智能体运行。
- 制定回滚计划。
- 输出部署回执，包含发布标识、部署的回调 URL、健康检查结果、鉴权与未鉴权 webhook 结果以及已验证的 Lindy 任务 ID。
使用方式
前置条件
- 已配置并测试的 Lindy 智能体
- 带有 webhook 接收器端点的应用
- 部署平台（Vercel、Railway、Docker、AWS、GCP）
- Lindy API 密钥和 webhook 密钥
步骤概览
-
准备应用用于部署：创建生产就绪的 Lindy webhook 接收器，包含健康检查端点和鉴权验证。示例代码使用 Express 和 helmet，接收器在验证
Authorization头后立即返回 200 并异步处理 webhook。 -
Docker 部署：提供 Dockerfile 示例，基于 node:20-alpine，包含健康检查指令，并给出构建和运行命令。
-
Vercel 部署：安装 Vercel CLI，添加密钥，执行生产部署，并提供 vercel.json 配置示例。
-
更新 Lindy 智能体 webhook URL：在 Lindy 仪表板中打开每个带有 webhook 触发器的智能体，导航到 HTTP Request 动作，将 URL 从开发/预发环境更新为生产环境。对于 webhook 触发器，调用方需要使用 Lindy 生成的 URL（保持不变）。使用示例 webhook 进行端到端测试。
-
部署后验证：提供 bash 脚本，依次执行健康检查、webhook 端点可达性测试（期望 200）以及触发测试智能体运行。
-
回滚计划：提供 Vercel 和 Docker 的回滚命令，并说明如有需要将 Lindy 智能体 URL 更新回之前的地址。
输出
生成部署回执，包含发布标识、部署的回调 URL、健康检查结果、鉴权与未鉴权 webhook 结果以及已验证的 Lindy 任务 ID。保留之前的镜像或部署修订版本及相应的回滚命令。
示例
对于 Vercel 发布，记录生产 URL、GET /health 返回 200、未鉴权回调返回 401 以及成功的签名测试事件。如果签名回调返回 502，在更改 Lindy 智能体 URL 或重试测试之前，先执行文档中记录的回滚操作。
部署清单
| 步骤 | 验证 |
|---|---|
| 构建通过 | npm run build 退出码为 0 |
| 测试通过 | npm test 全部通过 |
| 密钥已配置 | API 密钥 + webhook 密钥在平台中 |
| 健康检查响应 | GET /health 返回 200 |
| Webhook 鉴权有效 | 带有效令牌的 POST 返回 200 |
| Webhook 鉴权拒绝 | 不带令牌的 POST 返回 401 |
| Lindy 智能体 URL 已更新 | HTTP Request 动作指向生产环境 |
| 端到端测试 | 触发智能体，接收回调 |
错误处理
| 问题 | 原因 | 解决方案 |
|---|---|---|
| Webhook 502 | 应用崩溃/未运行 | 检查容器日志，重启 |
| Webhook 超时 | 处理缓慢 | 立即返回 200，异步处理 |
| Lindy 中 URL 错误 | 部署后未更新 | 更新 HTTP Request 动作 URL |
| SSL 错误 | 证书问题 | 验证 HTTPS 证书有效 |
| 密钥不匹配 | 生产环境使用了开发密钥 | 验证生产密钥与 Lindy 配置匹配 |
适用场景
适用于需要将应用与 Lindy AI 智能体集成的部署场景，特别是涉及 webhook 接收器、回调处理器以及通过 HTTP Request 动作和 webhook 触发器与 Lindy 智能体交互的应用。
限制
该技能的具体限制暂未提供。