切换手册章节
一项工具怎样接到模型面前?
设想要把团队的命令执行环境从本机迁到容器。若每换一种环境都要重写整套 Agent,迁移会很贵。DeepSeek Harness 把“别人如何调用”与“机器具体怎样完成”分开,让开发者可以替换一部分实现。
本篇目录 4 节
01
用 Shell 走一遍三层分工
| 问题 | 对应层次 | 换执行环境时核对什么 |
|---|---|---|
| 命令、目录、超时和结果怎样表示 | 能力接口 | 双方对输入和返回值仍能达成一致 |
| 由谁创建进程并读回输出 | 提供实现的插件 | 容器映射、身份、取消和错误能否按约定工作 |
| 模型如何知道可以执行什么 | 面向模型的工具 | 工具名、描述、参数和结果是否仍然准确 |
02
Cordis 如何让各部分找到彼此
每个插件挂载到某个 Context,在这个上下文中注册服务、订阅事件,或声明自己依赖的服务。例如模型适配器负责连接模型服务,工具注册表负责查找工具,运行循环负责决定何时调用。相同的接口可以由不同插件提供。
有些部件需要调用另一个服务,有些只需监听正在发生的事件。以写文件为例,权限判断要赶在产生改动之前,完成通知则在拿到结果之后。把审批放到“写完再通知”的位置,就失去了拦截作用。
03
课堂拆机,不用真改企业配置
- 先在练习项目生成 brief.md,展开一次文件工具的详情。找出目标文件、工具参数和结果。
- 设想项目改放在受管远程目录,写下三件仍须满足的条件:对路径的解释一致、写权限能判断、失败能返回。
- 如果远程系统把“等待审批”当作“写入成功”,讨论哪一层该改。优先修接口和返回值映射,再决定提示词是否需要补。
04
装了插件,工具为什么仍可能看不见
分别检查插件属于哪个运行形态、依赖是否齐备、是否在当前 Agent 的作用域内注册、当前模型这一轮能否看到相应工具定义。一个插件列在“已安装”中,只能回答第一层的问题。切换或升级后还要实际发起一次无副作用的小调用。
来源与延伸阅读
配套资料
知识库与演示素材
知识库附录含录屏分镜。练习包里的 INDEX.md 可按题目查找会议简报、只读目录核对、Cordis 报销回执,以及门店销售和团队练习。