Skip to content

[Feature] 提供带来源和信任属性的动态上下文材料接入 #234

Open

Description

@Aias00

目标、依据与优先级

现有 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,不能静默使用上次请求的旧值。
  • 接入 [P0][T33] 保留上下文来源与信任级别,防止检索或工具内容提升为指令 #136 的指令/参考材料边界,检索、记忆、工具和子 Agent 输出不会因来源注册升为 System 指令。
  • 所有材料进入 [P1][T34] 统一完整模型请求的上下文窗口预算与压缩策略 #137 的最终预算;来源协议不再实现第二个 Token 预算器或摘要器。
  • 覆盖重复 ID、非法块、来源变化、超时取消、并发请求隔离、超预算、失败省略与必需块失败。
  • Java 注册及声明式已有来源配置共享接口;原生业务数据源实现仍允许编码,不承诺任意数据库调用可由 YAML 自动生成。

归属、依赖与约束

关联:#136、#137、#199、#203。本单作为具体交付任务,相关总单继续负责总体契约,不重复实现其存储、预算、授权或版本注册体系。

独立 ReAct / Workflow 消费中立契约,不以 Graph/Loop 为执行后端。Loop 为可选图编排能力。Core 不依赖 Extensions 或 AgentScope SDK;复用现有组件,不因职责分层机械新增 Maven 模块。定义、数据或公共 API 的破坏性变更需比较兼容方案,并说明收益、消费者影响、目标版本、迁移与回滚;保留合理现有实现。不以直接复制 AgentScope 类或引入整套平台作为验收。

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