SuperAPI AI 工具集

webhook-transforms

通用与其它

查看项目

更新于 10-15 21:50

技能介绍

用途:把外部事件(短信、会议完成、社交提及等)转成可被大脑摄取的结构化信号。

主要能力:定义转换函数,将原始 Webhook 载荷(JSON)映射为大脑页面内容(Markdown)与元数据(slug、类型、引用);注册 Webhook URL;事件到达后解析载荷、执行转换、通过 gbrain put 写入页面、提取实体并富化、为被提及实体添加时间线条目,最后执行 gbrain sync。契约保证:外部事件带正确引用写入页面;保留原始载荷,转换失败进入死信队列;每个事件都运行实体提取;输入净化,原始 HTML/脚本不会进入页面;转换失败记录原始载荷并重试一次。

使用方式:先定义转换函数(需去除 HTML 标签、转义脚本内容),再向外部服务提供 Webhook 端点;处理流程按解析、转换、写入、提取实体、加时间线、同步执行。示例:短信输入 from、body、timestamp,输出发送者页面的时间线条目,检测到行动项时更新任务;会议输入标题、参与者、记录、摘要,委托给 meeting-ingestion 技能;社交提及输入平台、作者、文本、URL,输出 media/ 下页面并做实体提取与反向链接。

限制与错误处理:转换抛错时把原始载荷记录到 _dead-letter/{timestamp}.md,向智能体暴露错误类型并重试一次,不丢事件。写入返回 write_pending(退出码 10)表示事件已接受,应记录请求 id 并轮询,不得用新 id 重放。source_binding_required 或 insufficient_scope 表示该 Webhook 令牌无权写入来源,需告知用户由大脑宿主运营者补充授权。载荷格式错误应拒绝并记录解析错误,不得写入不完整页面。反模式:向页面传原始 HTML/脚本、转换失败静默丢弃事件、处理 Webhook 不做实体提取、写入前不清洗外部输入。其他定价、平台等细节资料未提供。