AgentScope Java 2.0：从入门到进阶

一本开源的 AgentScope Java 中文教程：7 篇 44 章、900+ 页成书体量的完整 Markdown 源稿，由浅入深覆盖从第一个 Agent 到生产级 Agent 平台的全部主题。

本书是对 AgentScope Java 官方中文文档（v2）的系统性重排与整合：按学习曲线重新组织为教程结构，每章配有场景化导读与章首导览图，全书 97 张 mermaid 架构图 / 时序图 / 部署图（GitHub 原生渲染），并对 10 家模型提供商等重复性文档做了合并精编。仅供学习与交流使用，具体声明见 NOTICE.md。

✨ 这本书有什么不同

• 由浅入深的教程结构 —— 不是文档的搬运：序言给出三类读者（Java 应用开发者 / 平台建设者 / 质量与评估）的学习路线，每章有导读与前后衔接
• 97 张 mermaid 图 —— 章首导览图 + 时序图、流程图、部署图，全部可在 GitHub / VS Code / Typora 中直接渲染
• 案例驱动 —— 6 个 Service 实战案例（每个都配时序图）+ 4 个行业级案例（物流 / 金融 / AIDC / Coding Agent）
• 生产视角 —— 多副本部署、分布式存储选型、沙箱隔离、权限与人工介入（HITL）、上生产清单
• 进阶专题 —— JEV 语义判断（高频小决策的类型化处理）与 Agent 轨迹评估

🗺️ 目录

每篇另有篇导读（chapters/part-1-intro.md … part-7-intro.md），概述本篇内容与阅读方式。

🚀 快速开始学习

环境要求：JDK 17+，Maven 3.9+，任一模型提供商的 API Key（推荐从 第 2 章 快速开始 的 DashScope 开始）。

// 10 行代码跑起第一个 Agent（详见第 2 章）
var builder = HarnessAgent.builder()
    .name("notes-assistant")
    .model("dashscope:qwen-plus")
    .workspace(Path.of(".agentscope/workspace"));

try (var agent = builder.build()) {
    agent.call(new UserMessage("你好，介绍一下你自己"), ctx).block();
}

三条学习路线（完整版见序言）：

📖 如何阅读 / 导出 PDF

• GitHub 在线阅读：直接点上方目录，mermaid 图原生渲染
• 本地阅读：git clone 后用 VS Code（装 Markdown Preview Mermaid Support 插件）或 Typora 打开
• 导出 PDF：本仓库只含 Markdown 源稿。可用任意 Markdown 工具链自行导出，例如：

pandoc chapters/*.md -o book.pdf --pdf-engine=xelatex -V CJKmainfont="Microsoft YaHei"

本书的 900+ 页 PDF 版本由一条 Markdown → HTML → Edge 打印的构建管线生成；如你需要该管线，欢迎提 Issue 交流。

🤝 参与贡献

发现错别字、内容过时、链接失效，或希望补充某章内容，欢迎提 Issue / PR：

1. Fork 本仓库 → 新建分支 → 修改对应章节
2. 注意保持章节 frontmatter（chapter / title / source）与图片相对路径规范
3. 提交 PR 并说明修改动机

📣 关于作者 / 交流

• GitHub：github.com/ybak
• 交流群：打开小红书扫码加入「AgentScopeJava 学习群」 👇

如果这本书对你有帮助，欢迎点一个 ⭐ Star，或分享给身边正在做 Agent 开发的同学——这是我持续整理更新的最大动力。

📄 声明

本书基于 AgentScope Java 官方文档（Apache License 2.0）整理而成，包含大量重组与增补，非官方文档，与原项目及其维护者无隶属关系。技术内容以官方文档为准。完整的来源、许可与用途声明见 NOTICE.md。本书仅供学习与技术分享，禁止用于商业用途。