核心用法
Let's Clarify 是一项 Human-in-the-Loop 基础设施服务,允许 AI 代理在需要人工输入时暂停工作流并收集结构化数据。使用流程为:1)注册获取 API Key;2)通过 JSON Schema 创建表单,定义字段类型(文本、单选、多选、文件上传等);3)为每个接收者生成唯一 URL;4)通过轮询或 Webhook 获取结果。
显著优点
- 原生 MCP 支持:提供远程 MCP 端点,Claude Code、Cursor 等工具可直接作为原生工具调用
- 灵活的字段系统:支持 7 种字段类型,包括文件上传(可限制 MIME 类型和大小)
- 双交付模式:既可通过独立 URL 分发,也可通过 embed.js 嵌入现有网页
- 完善的轮询机制:支持游标分页、增量同步(
updated_since)、状态过滤,适合大规模数据收集 - 预填充与草稿:支持 UUID 预分配和字段预填充,用户端有 sessionStorage 草稿保护
潜在局限
- 人工延迟不可控:必须实现异步轮询或 Webhook,无法同步等待
- 单表单上限:最多 10,000 接收者,超大规模场景需分表单处理
- Webhook 可靠性:仅 3 次重试(多项式退避),且不阻塞提交,可能丢通知
- 地域与合规:服务托管于 letsclarify.ai,未明确说明数据驻留区域
适合人群
- 需要人工审批节点的自动化工作流(如预算审批、内容审核)
- 需要从外部用户收集结构化数据的 AI 代理(如调研、注册、反馈)
- 已使用 MCP 客户端(Claude Code、Cursor)的开发者
常规风险
- API Key 泄露:
lc_...密钥一旦泄露,攻击者可读取所有表单数据;需安全存储 - 表单劫持:
form_token和recipient_uuid若被截获,未经验证的用户可能提交数据(虽有 UUID 唯一性,但无额外身份验证层) - 数据残留:默认 30 天自动删除,但需主动调用 delete 端点确保敏感数据立即清除
- 速率限制:创建表单限流 10/分钟,大规模部署需考虑批量策略