用途:把外部事件(短信、会议结束、社交提及等)统一转换为可被 brain 接收并落库的信号,并为相关实体补充时间线与引用。
主要能力:定义 transform 函数,将原始 webhook JSON 载荷映射为 brain 页面内容(markdown)加元数据(slug、type、citations);注册 webhook URL 交给外部服务;事件到达后解析载荷、执行转换、通过 gbrain put 写入 brain 页面、抽取实体并做增强、给被提及实体添加时间线条目,最后用 gbrain sync 同步。转换契约要求:每个转换事件都运行实体抽取;外部输入做净化,不把原始 HTML/脚本写入 brain 页面;原始载荷被保留。示例转换包括:短信(发件人、正文、时间戳)转换为发件人 brain 页面时间线条目,并在检测到行动项时更新任务;会议完成(标题、参会者、转录、摘要)委托给 meeting-ingestion 技能;社交提及(平台、作者、文本、URL)在 media/ 下生成 brain 页面并做实体抽取与反向链接。
使用方式:先定义转换并净化输入,再注册 webhook 端点;事件到达后按解析、转换、写入、抽取、同步顺序处理。错误处理:转换抛错时把原始载荷记录到 _dead-letter/{timestamp}.md,向 agent 暴露错误类型并重试一次,避免丢失事件。输出报告格式为“Webhook: {event_type} from {source} → {brain_page_path}”。
限制与反模式:不得把原始 HTML/脚本传给 brain 页面(XSS 风险);不得在转换失败时静默丢弃事件;不应跳过实体抽取;写入前必须对外部输入做净化。资料未提供收费、价格与平台支持范围等信息。