IT咖啡馆 X 老陈聊AIDeepSeek Harness 中文学习手册
切换手册章节
读懂 Agent 如何工作   /   26

一项工具怎样接到模型面前?

设想要把团队的命令执行环境从本机迁到容器。若每换一种环境都要重写整套 Agent,迁移会很贵。DeepSeek Harness 把“别人如何调用”与“机器具体怎样完成”分开,让开发者可以替换一部分实现。

本篇目录 4 节
01

用 Shell 走一遍三层分工

问题对应层次换执行环境时核对什么
命令、目录、超时和结果怎样表示能力接口双方对输入和返回值仍能达成一致
由谁创建进程并读回输出提供实现的插件容器映射、身份、取消和错误能否按约定工作
模型如何知道可以执行什么面向模型的工具工具名、描述、参数和结果是否仍然准确
02

Cordis 如何让各部分找到彼此

每个插件挂载到某个 Context,在这个上下文中注册服务、订阅事件,或声明自己依赖的服务。例如模型适配器负责连接模型服务,工具注册表负责查找工具,运行循环负责决定何时调用。相同的接口可以由不同插件提供。

有些部件需要调用另一个服务,有些只需监听正在发生的事件。以写文件为例,权限判断要赶在产生改动之前,完成通知则在拿到结果之后。把审批放到“写完再通知”的位置,就失去了拦截作用。

03

课堂拆机,不用真改企业配置

  1. 先在练习项目生成 brief.md,展开一次文件工具的详情。找出目标文件、工具参数和结果。
  2. 设想项目改放在受管远程目录,写下三件仍须满足的条件:对路径的解释一致、写权限能判断、失败能返回。
  3. 如果远程系统把“等待审批”当作“写入成功”,讨论哪一层该改。优先修接口和返回值映射,再决定提示词是否需要补。
04

装了插件,工具为什么仍可能看不见

分别检查插件属于哪个运行形态、依赖是否齐备、是否在当前 Agent 的作用域内注册、当前模型这一轮能否看到相应工具定义。一个插件列在“已安装”中,只能回答第一层的问题。切换或升级后还要实际发起一次无副作用的小调用。

来源与延伸阅读

配套资料

知识库与演示素材

知识库附录含录屏分镜。练习包里的 INDEX.md 可按题目查找会议简报、只读目录核对、Cordis 报销回执,以及门店销售和团队练习。

查看图片