如何使用 AgentsFlare Webhooks：实时掌握账户动态
了解如何配置 AgentsFlare Webhooks，将费用告警、API 请求、Token 用量和成本数据实时推送至协作工具或内部业务系统。
什么是Webhooks？
可以将 Webhooks理解为一种“主动通知”机制。传统模式下，应用程序需要不断向服务端查询事件是否发生，这类似于不断打电话询问餐厅“餐做好了吗”。而使用 Webhook 时，应用只需预先提供一个接收地址，当事件发生后，服务端会主动将结果推送过来，就像餐厅在餐品准备完成后主动通知顾客一样。这种事件驱动（Event-Driven）的通信方式避免了频繁轮询，提高了系统的实时性和运行效率。
在使用 AI 模型服务的过程中，及时了解账户状态和请求情况非常重要。AgentsFlare 提供的 Webhooks 功能,可以让系统在特定事件发生时,自动将信息推送到您指定的地址,免去人工查看后台的麻烦。
（Webhooks主界面）
Webhooks 能做什么
AgentsFlare 的 Webhooks 支持两类主要场景:
第一类是告警触发回调。 当您设置的监控告警(比如费用超过某个阈值,或某项指标达到预警线)被触发时,系统会按照您预先配置的消息模板,自动推送一条通知到指定地址。这类回调的好处是可以灵活定制消息内容,系统会将触发源、指标名称、当前数值、告警阈值、触发时间等信息自动填入模板中,方便您接入企业微信、钉钉、Slack 等常用的协作工具。
第二类是 API 请求成功回调。 每当一次 API 调用完成后,系统都可以自动推送一条包含请求详情的通知,内容包括调用的模型、所属项目、Token 用量、费用、请求耗时等信息。这类回调采用统一的标准数据格式,不支持自定义消息模板,但结构清晰,非常适合对接到您自己的数据统计或财务系统中,实现用量与成本的自动化跟踪。
需要注意的是,不论哪种类型的回调,目标地址都必须使用 HTTPS 协议,以保证数据传输的安全性。
什么场景下需要用到 Webhooks
Webhooks 并不是每个客户都必须配置的功能,但在以下几类场景中,它能带来明显的效率提升:
费用与用量的实时预警
如果您的业务对成本比较敏感,担心某个项目或某个 API Key 因为异常调用(比如代码 bug 导致的死循环请求,或者某个业务突然放量)导致费用飙升,可以通过告警触发回调,在指标超过阈值的第一时间收到通知,及时介入处理,而不是等到月底账单出来才发现问题。
多团队、多项目的运维协同
如果公司内部有多个团队共用一套 AgentsFlare 账号,各自管理不同的项目,告警回调可以直接推送到对应团队的协作群里(企业微信、钉钉、Slack 等),让相关负责人第一时间知晓,不需要所有人都去后台盯着看。
精细化的成本核算与内部结算
如果您需要按项目、按部门、按客户对 AI 调用成本进行拆分核算,API 请求成功回调可以把每一次调用的模型、用量、费用等数据实时同步到您自己的财务或数据系统,免去定期导出账单再手工核对的麻烦,数据也更加实时准确。
用量数据的二次加工与分析
如果您希望把调用数据接入自建的 BI 看板或数据仓库,用来做用量趋势分析、模型使用分布分析等,API 请求成功回调可以作为数据源,持续、自动地把每一笔调用记录同步过去。
无人值守的自动化运维
对于希望减少人工巡检的团队,可以把告警回调和一些自动化脚本结合起来,比如费用超阈值时自动暂停某个 API Key,或者自动发送工单给相关负责人,实现基本的自动化响应机制。
如果您的使用场景比较简单,调用量不大,预算也比较稳定,不配置 Webhooks 也完全可以正常使用平台,通过后台页面查看即可满足需求。
如何设置
设置 Webhook 的操作并不复杂。在 AgentsFlare 后台的 Webhooks 管理页面,可以看到已创建的所有 Webhook 列表,点击创建按钮后,只需填写目标回调地址,并根据需要选择告警触发或 API 请求完成这两种类型即可完成配置。如果选择的是告警触发类型,还可以进一步编辑推送的消息内容,按需插入触发源、指标值、阈值等变量。
（创建 Webhook 界面）
投递记录：让每一次推送都有据可查
考虑到网络环境的复杂性,推送并不总能一次成功。AgentsFlare 为此提供了完整的投递记录功能,您可以随时查看每一次 Webhook 推送的具体情况,包括推送时间、目标地址、返回的 HTTP 状态码、响应内容摘要,以及重试次数和最终投递状态。一旦某次推送失败,系统会自动进行重试,并将结果如实记录,方便排查问题,而不用担心消息"石沉大海"却无从查证。
适合谁用
如果您的团队需要:
在费用或用量出现异常时第一时间收到通知,而不是等到账单出来才发现问题;
将每一次 API 调用的成本和用量数据自动同步到内部系统,实现精细化的成本管控;
把告警信息接入现有的协作工具或运维流程,减少人工巡检的工作量;
那么 Webhooks 会是一个非常实用的功能,能够帮助您将 AgentsFlare 的运行状态无缝融入到已有的业务系统当中。