什么是Fieldy AI Webhook
Fieldy AI Webhook 是一个专为 Moltbot 平台设计的 webhook 转换模块，用于将 Fieldy 应用的实时语音转录数据接入 Moltbot 的智能代理系统。该工具通过配置网关级别的 webhooks，使得发送到特定端点的请求能够经过自定义的转换逻辑处理，再触发相应的 AI 代理执行任务。其核心机制是监听 `POST /hooks/fieldy` 路径的请求，利用一个名为 `fieldy-webhook.js` 的转换脚本对原始数据进行解析和预处理，最终将格式化后的消息传递给指定的代理（Agent）运行。
该方案特别适用于需要将外部语音交互应用（如 Fieldy）与内部 AI 能力集成的场景。它允许用户在不修改 Fieldy 应用本身的前提下，将其产生的语音指令无缝对接到更强大的 Moltbot 智能体生态中。整个流程包括部署转换脚本、配置 webhook 映射关系以及重启服务以激活新规则，整个过程清晰且可定制化。
值得注意的是，默认行为下，只有包含唤醒词“Hey, Fieldy”或“Fieldy”的转录文本才会被转发给代理执行；而不含唤醒词的对话内容则仅会被记录为 JSONL 文件保存，便于后续审计或分析使用。这种设计既保证了主交互通道的专注性，又保留了完整的日志追溯能力。
核心功能特点
- 将 Fieldy 应用的 webhook 请求转换为 Moltbot hooks 可识别格式
- 支持通过自定义 JavaScript 脚本（fieldy-webhook.js）进行消息预处理和逻辑判断
- 具备唤醒词检测机制：仅转发包含 ‘Hey, Fieldy’ 或 ‘Fieldy’ 的指令给代理
- 自动记录非唤醒词对话内容为 JSONL 格式日志文件，便于后期分析
- 可通过编辑转换脚本来灵活调整唤醒词、解析规则及日志输出行为
- 支持通过查询参数或 HTTP Header 传递认证 token，兼容多数 webhook 提供商
适用场景
Fieldy AI Webhook 主要面向希望将第三方语音助手或企业内部语音应用与 Moltbot 智能代理深度集成的开发者和团队。例如，当企业已在使用 Fieldy 作为客服语音入口，但需要调用更复杂的业务逻辑或知识库时，此工具可实现平滑过渡——无需重构原有语音前端，即可让 Fieldy 的输出直接驱动 Moltbot 中的专业代理完成订单查询、故障排查等高级任务。
此外，它也适合需要构建混合式语音交互系统的场景。比如，在智能家居控制场景中，用户可通过 Fieldy 发出‘Hey Fieldy 打开客厅灯’这类自然语言指令，经此 webhook 处理后，由 Moltbot 代理解析意图并联动 IoT 设备执行操作。同时，所有未触发代理的闲聊内容仍被安全存储，满足合规性要求。这种架构兼顾了用户体验一致性与后端处理能力的专业化。
对于注重数据留痕和调试能力的开发者而言，该方案提供了良好的平衡点：关键指令走高效代理链路，普通对话保留原始日志供回溯分析。无论是用于客户支持自动化、内部工单系统还是创意型语音交互项目，Fieldy AI Webhook 都能作为可靠的中间层桥梁，打通不同系统间的协议壁垒。