Repository navigation
Description
Current state: 路线图 #316 第 5 项已列出 MindIE-agent 对接,本 issue 补齐独立跟踪入口。当前为方案提案,尚未完成 InferRSI 与 MindIE Agent 的集成验收。
Decision needed: 请路线图负责人 @jiangkuaixue123 确认首期接入方向、宿主与版本、验证任务,以及两侧优化循环和执行生命周期的归属;跨模块接口与 #362 / #371 对齐,完成验收人待确认。
Next action: 先记录首期范围与接口映射,再按确认后的范围实现薄适配、补齐契约测试和一次真实任务的端到端验证。
目标
让 MindIE Agent 与 InferRSI 能在明确的权限和版本边界内协作:交付所需知识与任务,保留实际候选及执行事实,调用独立评测并返回可追溯的结果。接入应复用已有能力,不另建一套 Agent 平台、runner 或判分器。
这里的 MindIE Agent 指为原生编程宿主提供昇腾知识和远端工具的项目,不是 MindIE 推理服务的 HTTP 接口,也不是 #352 的 Ascend ModelAgent。
已知依据与待定范围
- 路线图依据: [Roadmap] InferRSI: Optimization, Evaluation, and Engineering #316 第 5 项的目标是“将 InferRSI 与 MindIE-agent 打通,明确对接方式、交接内容与验证范围”,现有 owner 为 @jiangkuaixue123。
- 架构约束: 沿用 discussion: Knowledge / Harness / Benchmark 三模块目标架构——现状、原语、交接时序与遗留问题 #362 已接受的 A–D 决定:Knowledge / Harness(原 Workbench)/ Benchmark 三个核心互不导入,由 Apps 组合;执行事实与评测结论分开。具体公开接口以 S1 契约为准,task: Apps 应用层详细设计与迁移计划(CLI / Python / Plugin) #371 的 Apps 详细设计仍为 Proposed。
- 调研基线: [Tracking] SearchSpace distillation coverage and knowledge consolidation #91 已记录的 Dong1017/mindie-agent@6a57cc8,其 channel 清单 为 0.1.12。它是本提案的来源快照,不是已选定的集成发布组合;实施前需确认实际宿主、插件、组件和知识版本。
- 建议首期: 选择一个宿主和一个可独立验收的工程任务,先打通最小交接。由 MindIE Agent 调用 InferRSI 公开能力,还是由 InferRSI 调用 MindIE 侧能力,及 CLI / Python / MCP 采用哪种接口,均需先确认,不把候选方案写成现有支持。
对接工作
1. 明确入口和边界
- 列出实际使用的 MindIE 能力、InferRSI 公共入口、版本要求及不支持的组合;适配放在应用/宿主边界,不在三个核心中引入 MindIE 专用依赖。
- 两侧都存在优化循环与状态记录时,明确谁驱动循环、谁保存权威状态、另一侧通过什么接口参与。避免嵌套循环、双重重试、预算重复计算和互相覆盖判定。
- 将宿主会话、任务、generation/evaluation attempt 与实际候选关联;不靠最新文件或相同工作目录推断任务归属。
2. 定义最小交接契约
| 交接 | 需要明确的内容 |
|---|---|
| 任务与知识 | 目标、工作区、允许修改/工具范围、输入与判据、知识固定版本和来源、实际交付内容及读取范围 |
| 候选与执行 | 候选版本/hash、执行命令与资源、调用方身份、时限与预算、运行/attempt 标识、实际完成的完整性检查 |
| 结果与证据 | 固定记录引用、原始产物、执行状态/退出码、正确性与性能结果、指标有效性及缺失原因 |
| 消耗与恢复 | 可获得的耗时/token/调用和设备消耗;预算预留、实际用量与已知账单分别记录;取消、清理失败和结果不确定分别处理 |
契约映射应兼容 #362 的固定 PreparedRef / RecordRef / AssessmentRef 方向,并与 #337 的真实 Agent 候选交接及独立评测通路复用。未知数据保留未知,不填零,不用 Agent 自报结果代替执行证据。
3. 保留权限与执行语义
- 尊重 MindIE 的会话级知识启用 / Admission 边界,不因安装、工具可发现或话题匹配自动开启知识检索、采集或贡献;本地经验沉淀不等于已发布到公共知识库。
- 远端执行、设备租约、超时、取消与清理分别核对。不能把“知识调用通过 Admission”推导成“所有远端命令都受租约强制保护”。
- MindIE 文档区分当前调用与持久远端作业,InferRSI 也有 attempt / deadline / 清理语义;需明确兼容规则,记录取消请求与实际退出,不能把断开连接当作作业已停止。
- 凭据、私有端点和原始会话内容不进入公开产物;不默认开启共享、自动发 PR 或外发诊断。
参考:MindIE 宿主边界与生命周期。
建议验收标准(待范围确认)
- 记录首期接入方向、宿主/组件版本、任务、权限、预算与验收人,给出接口映射和输入/输出样例。
- 交付薄适配与使用文档,通过成功、身份错配、产物缺失、知识未启用、超时/取消、清理失败及结果不确定等适用契约测试。
- 在批准的环境中完成一个真实工程任务:MindIE Agent 实际参与并产生候选,独立检查/测量实际候选,任务、版本、执行、结果与可获取消耗可追溯;mock 或预写候选不能替代该验证。
- 留存支持范围及失败/未知结果。执行成功不等于任务通过;证据不足保持
INCONCLUSIVE,没有可靠加速也可如实完成接入验证。 - 验证未启用本适配时现有入口不受影响;新增依赖、安装和打包仅覆盖首期真正使用的宿主与组件。
CPU fixture 验证接口不代表 NPU 资格。若首期选择 NPU 任务,需另外明确真实设备、候选审核/执行边界和验收条件;profiling 按任务需要使用,不作为固定必经步骤。性能收益声明遵守仓库现有 acceptance 与证据规则。
与已有工作的边界
- discussion: Knowledge / Harness / Benchmark 三模块目标架构——现状、原语、交接时序与遗留问题 #362 / task: Apps 应用层详细设计与迁移计划(CLI / Python / Plugin) #371: 复用架构与 Apps 公共接口,不以本 issue 改写三核心边界或把真实 Agent 接入追加为 S1 首期门槛。
- task: connect engineering tasks to existing Agent execution and evaluation #337: 负责通用真实 Agent 执行与独立评测交接;本 issue 聚焦 MindIE 专用适配与兼容验证,不复制整套端到端框架或接管 task: connect engineering tasks to existing Agent execution and evaluation #337 的完整验收。
- [Tracking] SearchSpace distillation coverage and knowledge consolidation #91: 知识来源与覆盖跟踪。本 issue 不授权批量蒸馏、目录迁移或自动知识晋升。
- [RFC] Agent plugins: a consistent InferRSI workflow in Codex, DSH and openJiuwen #152: 复用适用的插件安装与发布机制;首期不承诺支持所有 MindIE 宿主。
- 不包含本次直接执行模型/NPU实验、付费调用、跨仓发布或合并,也不把上游自报效果当作 InferRSI 的实测收益。
责任与完成确认
- 路线图现有负责人:@jiangkuaixue123(沿用 [Roadmap] InferRSI: Optimization, Evaluation, and Engineering #316,不新增人员分工)。
- 本 issue 按用户要求由 dot 协助建立;此次授权范围为创建跟踪项并回填路线图。
- 状态:Proposed。实现切片、执行授权、验收与关闭负责人在首期范围确认时记录。
- 完成时回填实际代码/文档、测试与运行证据、未支持范围,由确认后的验收人决定是否关闭;建 issue 或合入单个 PR 不等于完成对接。
Activity
amy-why-3459 commentedon Nov 9, 2026
感谢整理,这个跟踪入口把 #316 第 5 项的边界写得很清楚。看完有几点建议,供首期范围确认时参考:
先定方向,再定接口。 建议首期只选一个方向,例如“MindIE Agent 作为宿主侧调用 InferRSI 公开能力(知识交付 + 独立评测)”,反向调用留到第二期。这样优化循环和权威状态天然归 MindIE 宿主一侧,InferRSI 只提供无状态的准备 / 记录 / 评测入口,可以直接避开嵌套循环和双重重试的问题。如果倾向反方向,也建议在 issue 里明确写一句“循环与预算由谁持有”,作为后续 PR review 的判据。
接口形态建议优先 CLI。 CLI 的输入输出最容易做成契约测试的固定样例,也不需要在宿主进程里引入 InferRSI 的 Python 依赖;MCP 可以作为 CLI 之上的薄包装后补。不过这取决于 MindIE 宿主目前对 MCP / 本地命令的支持情况,这一点需要 @jiangkuaixue123 确认。
交接契约建议先给一份最小样例。 第 2 节的表格已经很完整,建议首期验收第一项直接附一份成功路径的输入 / 输出 JSON 样例(含
PreparedRef / RecordRef / AssessmentRef映射),再配身份错配、产物缺失、超时取消三个失败样例。其他场景可以在样例稳定后再补,避免一开始契约面过大。版本固定。 调研基线是
Dong1017/mindie-agent@6a57cc8(channel 0.1.12),建议实施 PR 里把实际验证的宿主 / 插件 / 知识版本写进支持矩阵,CI 中的契约测试也对这组版本固定,避免上游 channel 更新后悄悄失配。Admission 与远端执行分开验收。 同意文中“知识调用通过 Admission 不等于远端命令受租约保护”的判断。建议在验收标准里单独列一条:取消请求发出后,记录实际退出状态;未确认停止时结果标为不确定,而不是成功或失败。
有一个问题想确认:首期的真实工程任务,是打算在 CPU fixture 上先跑通交接链路,还是直接选 NPU 任务?这会影响验收人和环境审批的安排,建议在范围确认时一并写明。
jiaran-king commentedon Nov 10, 2026
👀
jiaran-king commentedon Nov 10, 2026
以下是我设计的初版方案。
一、架构图:MindIE 接在哪里?
建议首期采用同一个 Codex Agent、同一个会话的方案。InferRSI 组织优化任务、管理预算、记录执行并独立评测;Codex Agent 修改代码;MindIE 在候选生成阶段向这个 Agent 提供昇腾知识。下面是待评审的实现方案。
这样设计的原因是,InferRSI 现有 Codex 插件已经把调查和代码修改交给宿主 Agent;MindIE 的知识启用又以会话为单位。两者可以在同一次候选生成中配合。首期建议将 MindIE 的接入范围限定为知识检索和读取,设备执行沿用所选任务的受控路径。InferRSI 宿主说明 · MindIE 会话规则 · InferRSI 架构决定
二、预计改哪些地方?
1. InferRSI 的 Codex 宿主入口:让 Agent 和使用者知道怎么走一轮
plugins/inferrsi/skills/inferrsi/SKILL.md。 在现有调查与诊断流程中说明:当前会话启用 MindIE 后,Agent 如何读取适用条目、保留来源和版本,并把这次读取关联到随后交付的候选。docs/codex-plugin.md。 增加一个面向使用者的 RMSNorm 示例,说明如何在同一会话启用知识、完成代码修改,以及到哪里查看运行结果。宿主 Skill · 插件使用指南2. InferRSI 的宿主 / Apps 适配层:记录实际交付给 Agent 的知识
context.text,将知识来源、固定版本和条目位置映射到context.sources[]中的ref、revision、locator,通过已有的campaign assemble-trace组装记录。3. InferRSI 的候选与评测路径:确保评测跑的是 Agent 交付的那一版
record_candidate(...)。src/inferrsi/harness/campaign_records.py已能将轮次、candidate_id、run_id和optimization_trace_ref关联到候选记录。tests/test_optimization_trace.py增加 MindIE 来源样例,验证读取内容和版本能完整保留。宿主侧覆盖知识未启用、读取结果缺失或轮次错配时的处理。4. MindIE Agent 一侧:先判断现有接口是否够用
在选定的宿主和插件版本上,执行一次真实的
query(搜索)和explain(按引用读取)。用explain的实际返回核对正文、来源、知识版本和条目位置。字段齐全即可复用现有插件;若确实缺少稳定引用,再把具体缺口提交给对应的 MindIE 组件。MindIE 使用示例三、Workflow:拿 RMSNorm 优化走一轮
RMSNorm(均方根归一化)是模型中对一组数值做归一化的算子。选它作为候选验收任务,是因为 #337 已将它列为内置 NPU 任务,有明确的输入、参考输出和性能测量目标。这里建议验证的是:Agent 能否借助 MindIE 的昇腾知识修改算子,再由 InferRSI 检查这份实际修改。 #337 任务范围
INCONCLUSIVE。建议验收标准:从一次真实运行的结果,验收人可以反查本轮读了哪些 MindIE 知识、Agent 交付了哪版代码、评测实际运行了哪版,以及得出了什么结论。CPU 样例可先验证交接接口;若最终选择 RMSNorm 的 NPU 优化,设备端验收需确认可用题包、真实设备、候选审核方式和验收人。结果完整可信时,即使没有测得加速,也可以验收对接流程。
请 reviewer 确认
是否认可分工:InferRSI 管理优化循环,同一个 Codex Agent 通过 MindIE 读取知识并生成候选?