用途:为 Lindy 自定义智能体编写集成时的可复用模式,覆盖入站 Webhook、出站 HTTP、Run Code 有界转换和 Send POST Request to Callback 回调流程。资料明确说明这不是 SDK 指南,Lindy 当前公开文档未提供包、客户端、智能体 CRUD、流式、API Key 或通用 API 主机面。
主要能力与用法:入站在 Webhook Received 触发器中创建命名 webhook,选择 Generate Secret,一次性保存,作为 Authorization bearer 发送,且只使用生成的 public.lindy.ai 网址;应用侧应校验 URL 协议、主机、路径与 schema 后再发送。出站用 HTTP Request,采用允许列表固定 HTTPS 地址,把目标服务自身的凭据放入请求头,按已记录的响应分支失败关闭。Run Code 用于有界转换,输入为字符串变量,输出 result、text、stderr;应解析、校验、限长并仅返回最小数据,避免打印输入。需要双向时配置应用自有 callbackUrl 与回调动作,接收方按不可信内容隔离,回调本身不得授权支付、删除、权限变更或外部通信。
认证与边界:入站由 Lindy 生成的 secret 认证;出站使用目标服务凭据而非 Lindy API key;回调未记录 Lindy 签名,不得臆造签名头。三类凭据须彼此独立,密钥不得进入提示词、正文、查询串、任务标题、日志或 Run Code 文本输出。
测试与限制:用合成数据在 Test Panel 验证有效调用及缺失或错误 bearer、错误主机、超大或多余输入、出站 4xx/5xx、畸形 Run Code 输入和不可信回调等负例;Test Panel 会执行真实操作,副作用需确认。webhook 无幂等键承诺,结果不明确时先查 Tasks 与操作记录再受控重试。资料未提供运行时长、超时、沙箱供应商或库版本等细节。输出应形成集成契约,含所选原语与信任方向、最小 schema 与边界、URL 允许列表与凭据归属、失败重试回调与人工审批行为、数据最小化与日志规则及测试凭据。激活前建议用 lindy-security-basics 复核凭据、连接、审批、数据与监控边界。