DeepSeek Harness 学习日记:关于Agent接口,工具调用的底层实现

Agent核心接口-Agent是怎么干活的

本文助你理解三个问题:

  • Agent是什么(接口定义)
  • Agent怎么处理一个任务(Turn-step模型)
  • 怎么中途干预Agent(Inbox机制)

什么是Agent

上一节我们知道了:插件通过ctx找到服务

现在进阶:Agent本身就是一个服务,通过ctx.agent管理

类比:

概念 类比
ctx.agents 公司里的"员工花名册"
一个 Agent 实例 一个员工
agent.id 员工工号
agent.status 员工状态(空闲/忙碌/已离职)
agent.session 员工的工作档案(记忆)
agent.inbox 员工的任务收件夹
java 复制代码
// 创建 Agent = 招一个员工
const handle = await ctx.agents.create({
  name: 'my-agent',
  model: 'deepseek-chat',
  // ...
})

const agent = handle.agent  // 拿到 Agent 句柄

// 查看状态
agent.status  // 'idle' | 'running'

// 销毁 Agent = 辞退员工
await handle.dispose()

Turn-Step模型(核心)

Agent运转的基本单元。用餐厅点餐类比:

Turn(轮次)= 从"收到消息"到"没有更多事要做"

Step(步骤)= 一次 LLM 调用 + 它触发的所有工具调用

场景:用户说"帮我查天气,然后根据天气推荐穿搭"

这不是一个简单的问答,而是:

Step 1: LLM 决定调用"查天气"工具 → 工具返回"北京 25°C 晴"

Step 2: LLM 拿到结果,决定调用"推荐穿搭"工具 → 返回"穿T恤+薄外套"

Step 3: LLM 觉得任务完成了,不再调用工具 → Turn 结束

一个 Turn 里有 3 个 Step

Inbox(收件夹)

Agent怎么知道有新任务,通过Inbox

三种往 Inbox 塞消息的方式:

  1. followup();排队,唤醒处理;
  2. steer();排队,立即处理;
  3. inject();排队,不唤醒;

两类事件

dsh中有两类时间,作用不同:

  • 持久化事件:写入日志,永久保存;可以重播、分叉;模型可见 ⟺ 已记录
  • 实时事件:不写入日志,只在内存中;用于实时协调;模型不可见

Session Events = 历史记录(发生了什么)

Agent Events = 实时控制(正在发生什么)

核心变量不变

DSH有一个非常重要的设计原则:模型能看到的东西,必须能从日志重播得到

如果 LLM 看到了某个信息,但没有记录到日志:

→ 系统重启后,LLM 就不记得这个信息了

→ 无法重现之前的对话

→ 无法审计 Agent 为什么做了某个决定

所以:任何到达 LLM 的内容,必须写入 Session Log

学习感悟

我们常说的Agent loop循环,在dsh中就是Step循环

"Agent 的核心公式是 LLM + Tools + Planning + Memory。LLM 是大脑,Tools 是手脚,Planning 是决策循环,Memory 是记忆。

我研究过 DeepSeek Harness 的实现,它把这个公式落地成了一个 Turn-Step 模型:

Turn 是一次完整对话

Step 是 LLM 的一次决策+工具调用

多个 Step 串起来就是一个 Agent Loop,LLM 反复决策直到任务完成

它在八股的基础上还加了几个生产级特性:

Inbox 机制:可以中途给 Agent 塞新任务或紧急指令

Session Log 持久化:所有模型可见内容都记录日志,支持重播和分叉

工具执行管道:工具调用不是直接执行,而是经过多层审批/拦截"

总结

一句话概括

Agent 是有状态的工作单元,通过 Turn-Step 模型驱动 LLM 循环决策,支持中途干预。

核心知识点

  1. Agent 是什么

Agent = 有 ID、状态、收件夹的工作单元

ctx.agents = Agent 注册表(员工花名册)

  1. Turn-Step 模型

Turn(轮次)= 从收到消息到没有更多事要做

Step(步骤)= 一次 LLM 调用 + 它触发的工具调用

一个 Turn 可以包含多个 Step(LLM 反复决策直到完成)

  1. Inbox 三种干预方式
方式 效果 场景
followup() 排队,唤醒处理 普通新任务
steer() 排队,紧急处理 立即打断
inject() 排队,不唤醒 注入上下文
  1. 两类事件

Session Events(持久化):turn/start, step/end, tool/call, tool/result...

→ 写入日志,可重播、可审计

Agent Events(实时):agent/created, agent/pre-step, agent/status...

→ 内存中,用于实时协调

  1. 核心不变量

"Model-visible means logged"

LLM 看到的任何内容,必须能从 Session Log 重播得到

面试怎么答

"dsh 用 Turn-Step 模型驱动 Agent:Turn 是一次完整对话,Step 是一次 LLM 调用+工具调用,多个 Step 串起来就是 Agent Loop。支持三种中途干预------followup 排队、steer 紧急插入、inject 静默注入。设计不变量是'模型可见即日志记录'------LLM 看到的必须写入 Session Log,保证可重播可审计。"

一页速记

Agent:有 ID / status / inbox / session 的工作单元

Turn-Step:Turn = 完整对话,Step = LLM调用 + 工具调用

Inbox:followup(排队) / steer(紧急) / inject(静默)

事件:Session Events(持久) / Agent Events(实时)

不变量:Model-visible ⟺ Logged

相关推荐
学长毕设28 分钟前
基于SpringBoot非遗文化展示与传播平台设计与实现-附源码
java·spring boot·后端
FungLeo1 小时前
FengCMS · PHP+MySQL 升级实录 · 危险默认值之殇:root/123456、认证码 8888 写进配置加载器
android·mysql·php·安全加固·fengcms
yz_aiks1 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
金銀銅鐵2 小时前
用 Swing 重做操作数栈演示
java·jvm·后端
琳少_2 小时前
java程序开发笔记
java·开发语言·数据库·笔记
叼烟扛炮4 小时前
[LangChain] 学习笔记(15):为什么你的重试没用——429、抖动、fallback 与熔断
java·服务器·前端
文丑颜不良啊5 小时前
LeetCode3401~3420题目解析
java·leetcode
Z21-X6 小时前
云原生运维学习笔记:Kubernetes Volume 与 Secret 实验
运维·笔记·学习·云原生·kubernetes
文丑颜不良啊6 小时前
LeetCode3421~3440题目解析
java·leetcode
code2cat7 小时前
【随笔】Java客户端选了HTTP/3,怎样知道请求实际走了哪个版本
java·开发语言·http