核心用法
Let's Clarify 是一个面向 AI Agent 工作流的人工介入（Human-in-the-Loop）基础设施服务。核心流程为：使用 JSON Schema 定义表单字段 → 生成唯一 URL 分发给人类 → 通过轮询或 webhook 收集结构化反馈 → 驱动工作流继续执行。
主要功能模块：
- 表单创建：支持 7 种字段类型（text/textarea/radio/select/checkbox/checkbox_group/file），可配置验证规则、文件上传限制、预填充值
- 分发机制：生成唯一 URL（
https://letsclarify.ai/f/{token}/{uuid}）或通过嵌入组件（embed.js）集成到自有页面 - 结果收集：提供摘要端点（
get_summary）快速查看进度，结果端点（get_results）支持游标分页、增量同步（updated_since）、文件内容获取 - 实时通知：可选 webhook，在每次提交时 POST 推送数据
- MCP 原生支持：提供远程 MCP 端点，Claude Code/Cursor 等可直接以工具形式调用
集成方式：
- REST API：标准 HTTP 调用，需
Authorization: Bearer lc_... - MCP Server：
https://letsclarify.ai/mcp，工具包括create_form、get_results、delete_form等
显著优点
1. 专为 AI 工作流设计：API 优先，返回值结构化（JSON），天然适配自动化场景
2. 灵活的分发渠道：URL 可投放到邮件/Slack/WhatsApp/短信等任意渠道；嵌入组件支持自有品牌页面
3. 高效的轮询机制：支持 updated_since 增量查询，避免重复拉取；游标分页处理大规模数据
4. 企业级扩展：单表单最多 10,000 收件人，支持批量添加、UUID 预分配、字段预填充
5. 数据生命周期管理：可配置 1-365 天保留期，支持主动删除，符合数据最小化原则
6. MIT 开源许可：代码透明，可自托管
潜在缺点与局限性
1. 依赖外部服务可用性：作为 SaaS，关键路径受制于 letsclarify.ai 的稳定性
2. webhook 非阻塞设计：提交成功不保证 webhook 送达，需配合轮询作为兜底
3. 文件处理限制：单文件最大 10MB，单次最多 10 个文件，不适合大规模媒体传输
4. 人工响应不确定性：无内置提醒/催办机制，需外部系统驱动人类及时响应
5. Rate Limit 较严格：注册 3 次/小时，表单创建 10 次/分钟，高频场景需缓存或队列
6. 安全凭证管理：API Key 仅显示一次，丢失需重新注册；无细粒度权限控制（RBAC）
适合人群
- AI Agent 开发者：需要在工作流中插入人工审批节点的自动化系统
- 流程自动化工程师：构建需要「机器发起-人类决策-机器执行」闭环的业务流程
- SaaS 产品经理：为现有产品快速添加「客户确认」「内容审核」等人工环节
- 低代码/无代码平台集成者：通过 MCP 或 REST API 将人工输入能力嵌入自有平台
常规风险
- 数据隐私风险：表单内容、上传文件流经第三方服务器，敏感数据需评估合规性（GDPR/HIPAA 等场景建议自托管）
- API Key 泄露风险：Bearer Token 一旦泄露，攻击者可访问全部表单数据；需安全存储、避免硬编码
- 轮询成本风险：高频轮询易触发 Rate Limit（60 次/分钟），建议采用 webhook + 合理间隔轮询的混合策略
- 表单过期风险：超 retention_days 后数据永久删除，需及时导出或处理结果
- Webhook 可靠性风险：10 秒超时、仅重试 3 次，网络抖动可能导致通知丢失，必须有轮询兜底机制