## 目标、依据与优先级 现有 ModelRequest context、Hook 和摘要可以补充信息,但缺统一的只读动态材料来源协议。#136 负责信任边界,#137 负责完整请求预算;本单负责来源接入、材料生命周期及请求构建接线。 建议阶段:优先,与完整请求构建协同。AgentScope Java 参考基线 `7976a20d7c59f535737f2df1b16a2bc24051575a`,ARGI Core `76d44429fdaa6a69320e21a1cb77119d0889d792` / Extensions `495414b76a37aca4d7c1022d973a8e5b9a7e92e6`。本单是能力落地建议,来源于源码与文档对照,并非已复现的 BUG 或已完成实现。 参考:https://github.com/agentscope-ai/agentscope-java/blob/7976a20d7c59f535737f2df1b16a2bc24051575a/docs/v2/zh/docs/harness/context.md ## 范围与验收 - [ ] 来源返回具有稳定 ID、版本/内容摘要、用途、信任级别和必要性声明的材料块;不直接返回可变 Graph 状态或认证对象。 - [ ] 在模型请求构建边界加载动态业务资料,明确每轮/每调用刷新、超时、取消及失败策略;回调只读且可重复调用。 - [ ] 省略失败材料必须显式声明;必需材料失败则不 dispatch,不能静默使用上次请求的旧值。 - [ ] 接入 #136 的指令/参考材料边界,检索、记忆、工具和子 Agent 输出不会因来源注册升为 System 指令。 - [ ] 所有材料进入 #137 的最终预算;来源协议不再实现第二个 Token 预算器或摘要器。 - [ ] 覆盖重复 ID、非法块、来源变化、超时取消、并发请求隔离、超预算、失败省略与必需块失败。 - [ ] Java 注册及声明式已有来源配置共享接口;原生业务数据源实现仍允许编码,不承诺任意数据库调用可由 YAML 自动生成。 ## 归属、依赖与约束 关联:#136、#137、#199、#203。本单作为具体交付任务,相关总单继续负责总体契约,不重复实现其存储、预算、授权或版本注册体系。 独立 ReAct / Workflow 消费中立契约,不以 Graph/Loop 为执行后端。Loop 为可选图编排能力。Core 不依赖 Extensions 或 AgentScope SDK;复用现有组件,不因职责分层机械新增 Maven 模块。定义、数据或公共 API 的破坏性变更需比较兼容方案,并说明收益、消费者影响、目标版本、迁移与回滚;保留合理现有实现。不以直接复制 AgentScope 类或引入整套平台作为验收。
Activity