核心用法
Drip Billing 是面向 AI Agent 生态的计量计费 SDK,帮助开发者精准追踪 LLM 调用、工具执行及完整 Agent 运行链路的用量与成本。
主要功能
- 用量追踪:按 meter 名称记录数值型用量(如 token 数、API 调用次数)
- 运行记录:通过
recordRun完整记录多步骤 Agent 执行过程 - 实时流式:
startRun/emitEvent/endRun模式支持实时追踪长时任务 - 框架集成:内置 LangChain 回调处理器
DripCallbackHandler,实现零侵入自动追踪
数据安全设计
| 维度 | 策略 |
|------|------|
| 密钥分级 | `pk_` 公钥仅用于追踪/计费,`sk_` 私钥限 admin 操作,遵循最小权限原则 |
| 传输内容 | 仅发送计量数据、客户ID、运行状态、脱敏元数据;**绝不传输原始 prompt/输出/密钥** |
| 元数据安全 | 要求严格白名单+脱敏策略,推荐用哈希ID替代原始文本 |
显著优点
- 权限分离清晰,公钥泄露风险可控
- 隐私保护设计严谨,明确声明不传输敏感内容
- LangChain 原生集成,接入成本低
- 支持实时流式和批量两种追踪模式
潜在局限
- 需 Node.js 18+ 环境,monorepo 开发需 Node 24.x
- 依赖第三方 Drip 服务,存在 vendor lock-in 风险
- 元数据脱敏责任在调用方,误用仍可能泄露信息
- 密钥前缀命名(
pk_/sk_)与 Stripe 类似,易混淆但权限范围不同
适合人群
- 构建多租户 AI SaaS 的开发者
- 需向客户透明展示 AI 成本的产品团队
- 使用 LangChain/自主 Agent 框架的工程团队
常规风险
- 密钥管理:虽推荐公钥,若误用私钥且泄露,攻击者可管理 webhook 和轮换密钥
- 元数据污染:开发者可能不慎将 PII/密钥写入 metadata,需严格代码审查
- 供应链安全:需验证 npm 包来源,避免安装恶意 fork