功能更新

如何使用 AgentsFlare Webhooks：实时掌握账户动态

Author

Agentsflare Admin

Date Published

执行摘要

本篇核心判断：

  • AgentsFlare Webhooks 是一种主动通知机制，当告警触发或 API 请求完成时，平台会自动把相关信息推送到指定系统，无需持续查询后台。
  • 支持两类主要回调：告警触发回调，以及 API 请求成功回调。前者适合费用、用量和指标预警，后者适合记录模型、项目、Token 用量、费用及请求耗时。
  • 适合成本监控和异常预警，例如项目费用突然上涨、API Key 异常调用或请求量短时间激增时，团队可以第一时间收到通知并处理。
  • 可接入企业微信、钉钉、Slack 及内部系统，帮助不同团队接收对应项目的告警，并减少人工巡检和跨团队沟通成本。
  • 可用于精细化成本核算，将每次 API 调用的模型、用量和费用同步至财务系统、BI 看板或数据仓库，实现按项目、部门或客户统计。
  • 配置流程简单：在 AgentsFlare 后台进入 Webhooks 页面，填写 HTTPS 回调地址，并选择告警触发或 API 请求完成类型；告警回调还可自定义消息模板。
  • 最适合多项目、高调用量或重视成本控制的团队；如果调用量较小、预算稳定，只通过后台查看数据也可以满足基本需求。

什么是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 的运行状态无缝融入到已有的业务系统当中。