【AgentScope】HarnessAgent 学习指南

HarnessAgent 学习指南

面向初级程序员的 AgentScope HarnessAgent 文档详解

HarnessAgent 是什么?

一句话:HarnessAgent 是一个让 AI Agent 能够"长期稳定运行"的工程框架。

想象你有一个 AI 助手。普通的 AI 助手就像"金鱼记忆"------关掉对话就忘了一切。

HarnessAgent 给这个助手装上了"笔记本"(记忆系统)、"身份证"(会话管理)、"工具箱"(工具系统),

让它能像真正的员工一样:记住你是谁、记得之前做了什么、知道怎么用各种工具完成任务。

核心设计思想

HarnessAgent 的设计围绕"身份持续、上下文可控、状态可恢复"三根支柱展开------详见 01-overview.md。

概念依赖关系

复制代码
总览(01) → 架构(02) → 基础子系统(工作区/会话/记忆 03-05)
          → 进阶模块(文件系统/工具/技能/子代理/流式 06-10)
          → 沙箱(11) → 总结(12)

推荐阅读顺序

顺序 文档 一句话导读 预计用时
1 01-overview.md 总览全局:HarnessAgent 解决什么问题、核心能力有哪些 15 min
2 02-architecture.md 架构深潜:为什么是"薄封装"、Hook 怎么驱动一切 25 min
3 03-workspace.md 工作空间:Agent 的"办公桌",目录结构长什么样 15 min
4 04-session.md 会话管理:怎么让 Agent 记住"上次聊到哪了" 15 min
5 05-memory.md 双层记忆:日记本 + 整理笔记,让 Agent 越来越聪明 20 min
6 06-filesystem.md 文件系统:Agent 的文件存在哪------本地、远端还是沙箱 20 min
7 07-tool.md 内置工具:Agent 自带哪些"工具"可以直接用 10 min
8 08-skill.md 技能系统:给 Agent 装"插件",从市场或工作区加载 15 min
9 09-subagent.md 子代理:让 Agent 把任务分给"下属"去做 25 min
10 10-streaming.md 流式处理:实时看到 Agent 和子代理的"思考过程" 15 min
11 11-sandbox.md 沙箱:把 Agent 关在"安全笼子"里执行,隔离风险 30 min
12 12-summary.md 总结回顾:串联所有概念,形成完整知识体系 10 min

总计约 3.5 小时,建议分 2-3 次完成。

关键术语速查

术语 类比 简要说明
HarnessAgent 装了装备的 AI 员工 基于 ReActAgent 的工程化封装
ReActAgent 裸的 AI 助手 只有"推理-行动"循环的基础 Agent
Hook 中间件/插件 在推理循环的关键时机插入的能力
RuntimeContext 当次调用的身份证 包含 sessionId 和 userId
Workspace 办公桌 Agent 的专属工作目录和文件
Memory 日记本+笔记 双层记忆系统(短期+长期)
Sandbox 安全笼子 隔离的执行环境

📖 完整术语目录 :GLOSSARY.md --- 收录 64 个 AI/框架术语,每个链接到首次完整解释的位置

前置知识

阅读本系列文档前,建议你了解:

  • Java 基础:能看懂 Builder 模式、Lambda、Optional
  • Maven 基础:知道怎么引入依赖
  • AI Agent 基本概念:知道什么是 LLM、什么是 Prompt
  • ReAct 模式(可选):了解 Agent 的"推理-行动"循环

不需要了解的内容:Docker、Kubernetes、Reactive Programming(涉及时会解释)

相关推荐
天天代码码天天4 小时前
输入一句话,生成一段声音:我做了个 Windows 本地音效工具
人工智能
tellmewhoisi5 小时前
深度学习0:数学知识:(雅可比矩阵)
人工智能·深度学习·矩阵
美团技术团队5 小时前
《Agent评测白皮书》业务实践篇:商家 AI 助手的评测与优化闭环实践
人工智能
京东云开发者5 小时前
京东11.11大促系列|Super Agent 进群:今年11.11,多了个会主动干活的"数字人队长"
人工智能
用户46043852250865 小时前
关于paimon-rust 数据写入链路
大数据
对你无可奈何6 小时前
把零散的模型用起来:Magpie 接入 Trae,再折腾两个池子
人工智能
七夜zippoe6 小时前
流式输出:让 AI 回答像打字机一样实时返回(SSE 全链路实战)
人工智能·spring·ai·流式输出·ssf
AI导出鸭PC端6 小时前
纳米AI怎么复制表格?对话导出总是格式崩塌,我用“AI 导出鸭”重构了工作流
人工智能·重构·豆包·ai导出鸭
AI导出鸭PC端6 小时前
用 AI 导出鸭高效处理:豆包导 pdf 怎么压缩但清晰
android·人工智能·pdf·豆包·ai导出鸭
装不满的克莱因瓶6 小时前
【AI时代必学】一篇文章教会你从零搭建Serverless架构
java·人工智能·ai·云原生·架构·serverless