Lindy Install & Auth 是一个用于 Lindy 平台接入与认证配置的技能。Lindy AI 是一个无代码/低代码 AI 智能体平台，智能体（称为 Lindies）在其网页仪表盘中构建。本技能使用 Lindy 文档化的 webhook 触发器：由 Lindy 提供触发器 URL，调用方使用 bearer 密钥进行认证。
用途 本技能用于在 Lindy 上完成账户接入，并为 webhook 触发器配置 bearer 认证，同时验证认证是否生效。
前置条件
- 拥有可创建或编辑智能体权限的 Lindy 账户
- 用于存放触发器凭据的密钥管理器
- curl 或其他 HTTP 客户端，用于进行合成连通性检查
- 不含客户数据的非生产测试载荷
主要能力与使用方式 第一步：创建 Webhook 触发器。在 Lindy 仪表盘中打开目标智能体，添加 webhook 触发器并复制其生成的 URL。由于 URL 的唯一路径可标识该触发器，需将完整 URL 作为密钥保存，配置回执中只记录主机名和脱敏后的路径。
第二步：配置 Bearer 认证。在 webhook 触发器的认证控件中点击 Generate Secret，将 Lindy 生成的值复制到密钥管理器，并与 HTTP Request 动作调用应用所用的凭据分开存放。示例环境变量：
Load the copied Lindy URL and generated secret from a secret manager.
export LINDY_TRIGGER_URL="https://public.lindy.ai/api/v1/webhooks/YOUR_WEBHOOK_ID" export LINDY_TRIGGER_SECRET="replace-with-the-lindy-generated-secret" 调用方必须在每次请求中以 bearer 认证方式携带该生成值。
第三步：验证授权连通性。使用 curl 发送带 Authorization 头的请求：
curl --fail-with-body -X POST "$LINDY_TRIGGER_URL"
-H "Authorization: Bearer $LINDY_TRIGGER_SECRET"
-H "Content-Type: application/json"
-d '{"event":"setup.verify","fixture":"synthetic"}'
确认恰好创建一个任务并保留其任务 ID。
第四步：验证未认证时被拒绝。发送不带认证的请求并检查 HTTP 状态码：
status="$(curl -sS -o /dev/null -w '%{http_code}'
-X POST "$LINDY_TRIGGER_URL"
-H "Content-Type: application/json"
-d '{"event":"setup.reject","fixture":"synthetic"}')"
case "$status" in
2??)
echo "unauthenticated request unexpectedly succeeded with HTTP $status" >&2
exit 1
;;
*) echo "unauthenticated request rejected with HTTP $status" ;;
esac
任何非 2xx 响应只能证明传输层被拒绝，还需检查任务历史；如果未认证请求创建了任务，则不应继续。
输出 交付一份脱敏的配置回执，包含目标工作区和环境名称、触发器和回调凭据所用的密钥管理器引用、脱敏唯一路径后的 webhook 主机，以及一次授权和一次未授权连通性检查的结果。回执中绝不能出现凭据值或完整的私有 webhook URL。
适用场景 适用于 Lindy 入门、为 webhook 触发器配置 bearer 认证，或连接相关服务。示例：将 webhook 凭据存放在仅开发用的密钥引用下，发送最小测试载荷，记录任务 ID 和 HTTP 状态；然后重复请求但不带认证，确认被拒绝。若两次请求都被接受、在开发中使用生产凭据，或需要将密钥复制进源代码，则说明配置不完整。
错误处理
- 授权请求返回 401：触发器密钥与调用方密钥不一致，需从正确的密钥引用替换调用方值。
- 未认证请求创建了任务：认证缺失或配置错误，应停止测试并要求触发器启用 bearer 认证。
- 未创建任务：URL 错误、智能体未激活或触发器过滤器问题，需重新复制触发器 URL 并检查智能体的任务历史。
- 请求超时：网络或 Lindy 服务问题，应停止使用真实数据重试并检查 Lindy 状态页。
安全清单
- 完整触发器 URL 和 bearer 密钥已存入密钥管理器
- 触发器凭据与回调凭据相互独立
- .env 文件已被忽略且仅限开发用测试数据
- 触发器和回调流量均使用 HTTPS
- 授权请求创建一个任务；未认证请求不创建任何任务
限制 资料未提供 Lindy 的收费、价格、平台支持范围或具体效果等信息。