Skip to content

[Feature] 为模型用量增加可选分类明细与无重复归集语义 #249

Open

Description

@Aias00

目标与基线

现有 Usage 为 input/output/total 三字段;#207 修复额外修复调用漏统计。本单补缓存命中、缓存写入、推理等供应商可提供明细及其包含关系,不重建预算系统。

ARGI Core 76d44429fdaa6a69320e21a1cb77119d0889d792 / Extensions 495414b76a37aca4d7c1022d973a8e5b9a7e92e6;AgentScope Java 参考 7976a20d7c59f535737f2df1b16a2bc24051575a。本单来自源码/文档对照,是能力建设建议,不是已复现的生产 BUG 或已完成的功能。

参考:https://github.com/agentscope-ai/agentscope-java/blob/7976a20d7c59f535737f2df1b16a2bc24051575a/agentscope-core/src/main/java/io/agentscope/core/model/ChatUsage.java

建议阶段:后续增强。

范围与验收

  • 评估可选细分维度和来源标识,保留旧三字段语义及 unknown,不能把缺失明细当精确零或强迫供应商都提供。
  • 明确哪些维度是 input/output 的子集、哪些是独立消耗,归集不能再次加到总数;区分累计快照与增量事件。
  • 主调用、修复、重试、fallback、子 Agent、服务端工具的记录按稳定调用身份去重并区分范围,已计入子结果的 usage 不重复累加。
  • 缓存命中不等同免费,不在框架写死价格或从文本猜测收费;[P1C][T17] 增加持久化重试、deadline 与恢复预算记账 #127 与配额适配消费该事实但仍拥有预算/限额逻辑。
  • 覆盖部分未知字段、互相矛盾的供应商统计、流式重复快照、多次调用和序列化兼容;提供适配器映射及可查询诊断。

关联与实现边界

#127、#137、#207、#236;agentic-ai-java/argi-extensions#18。价格结算与供应商账单核对不在本单范围。

复用已有定义、运行身份、日志、预算、授权及存储契约,不新建竞争的数据权威来源。独立 Agent/Workflow 不依赖 Graph/Loop;第三方协议、客户端 SDK 与外部后端留可选适配侧,Core 不导入 AgentScope SDK 或 Extensions。逻辑职责不自动对应新增 Maven 模块。先以模型无关/参考后端验证,再按范围给出真实服务或跨实例证据。破坏性变更需比较兼容方案,说明收益、消费者影响、目标版本与迁移/回滚;不因参考项目采用某设计而机械照搬。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions