SuperAPI AI 工具集

langfuse-webhooks-events

智能体与模型

查看项目

更新于 10-15 23:27

技能介绍

用途:配置 Langfuse Webhook,在提示词(prompt)生命周期事件发生时接收通知,实现事件驱动的工作流,例如触发 CI/CD 流水线、将提示词同步到外部系统或通过 Slack 通知团队。

主要能力:支持 prompt.created(新增提示词版本)、prompt.updated(标签或 tag 变更)、prompt.deleted(删除提示词版本)三类事件。Webhook 请求使用 HMAC SHA-256 签名,通过 x-langfuse-signature 请求头校验真实性。

使用方式:先准备 HTTPS 接收端点与 Webhook 密钥;在 Langfuse 中进入 Prompts > Create Automation > Webhook,填写端点 URL、选择监听事件、可选按提示词过滤,生成并保存密钥后点击 Test 验证连通性。接收端需先校验签名再解析负载,并按事件类型分发处理。可结合 Slack Webhook 发送通知,或通过 GitHub repository_dispatch 触发 Actions 工作流。生产环境建议用队列(如 BullMQ)先入队并快速返回 200,异步处理事件,并设置重试与幂等键(由事件标识、时间戳、提示词名派生)避免重复处理。

适用场景:提示词变更通知、生产标签提升检测、回归测试触发、误删告警、外部系统同步。

限制:需要 Langfuse Cloud 或自托管实例、HTTPS 端点与 Webhook 密钥;签名错误返回 401;处理慢会导致超时,需异步化;重试可能造成重复处理,需自行实现幂等。具体收费、价格与平台细节暂未提供。