文章目录概述一、项目概览1.1 PlanNotebook 是什么？1.2 核心技术栈1.3 系统架构二、环境准备2.1 安装 JDK 172.2 安装 Maven 3.6+2.3 获取 DashScope API Key2.4 配置环境变量2.5 准备 AgentScope Java SDK三、项目骨架搭建3.1 完整目录结构3.2 创建目录四、pom.xml：Maven依赖配置五、配置文件5.1 application.yml5.2 logback.xml六、Spring Boot 启动类七、DTO层：数据传输对象7.1 ChatRequest.java7.2 SubTaskRequest.java7.3 SubTaskResponse.java7.4 PlanResponse.java八、Service层：核心业务逻辑8.1 FileToolMock.java：自定义工具8.2 PlanService.java：计划管理服务8.3 AgentService.java：核心Agent服务（精华解析）8.3.1 初始化流程8.3.2 SSE事件映射8.3.3 人在回路（HITL）实现九、Controller层：REST API9.1 ChatController.java9.2 PlanController.java十、前端Web界面十一、构建与运行11.1 构建11.2 运行十二、测试验证指南12.1 功能测试用例用例1：简单对话用例2：多步骤任务用例3：人在回路暂停用例4：健康检查用例5：重置12.2 REST API 测试脚本12.3 日志验证十三、常见问题排查Q1：启动报错 "DASHSCOPE_API_KEY environment variable is required"Q2：编译报错 "package io.agentscope.core does not exist"Q3：端口8080被占用Q4：Agent响应异常或无输出Q5：SSE流中断或前端无响应Q6：模型不显示"思考"过程附录A：完整API参考Chat APIPlan APISSE事件协议总结概述2026年，AI Agent正在从概念走向落地。与传统的"一问一答"式对话机器人不同，AI Agent能够自主规划、调用工具、分步执行复杂任务，并在执行过程中接受人类干预——这正是"人在回路"（Human-in-the-Loop, HITL）的核心思想。今天，我们将基于AgentScope Java SDK和Spring Boot WebFlux，从零构建一个名为PlanNotebook的AI智能计划助手Web应用。它不仅能通过对话式交互帮你拆解复杂任务，还能实时可视化展示执行计划，并支持你在Agent执行中途随时暂停、审查甚至修改计划后再继续。本文覆盖从环境搭建到API调用的全流程，所有代码均可直接运行。一、项目概览1.1 PlanNotebook 是什么？PlanNotebook是一个基于ReAct（Reasoning + Acting）范式的AI Agent Web应用，具备以下核心能力：能力实现方式对话式任务拆解Agent通过自然对话理解用户意图，自动创建结构化执行计划SSE实时流式输出
AgentScope实战训练营：构建计划可视化管理和HITL的AI智能计划助手
发布时间：2026/6/9 22:53:22
文章目录概述一、项目概览1.1 PlanNotebook 是什么？1.2 核心技术栈1.3 系统架构二、环境准备2.1 安装 JDK 172.2 安装 Maven 3.6+2.3 获取 DashScope API Key2.4 配置环境变量2.5 准备 AgentScope Java SDK三、项目骨架搭建3.1 完整目录结构3.2 创建目录四、pom.xml：Maven依赖配置五、配置文件5.1 application.yml5.2 logback.xml六、Spring Boot 启动类七、DTO层：数据传输对象7.1 ChatRequest.java7.2 SubTaskRequest.java7.3 SubTaskResponse.java7.4 PlanResponse.java八、Service层：核心业务逻辑8.1 FileToolMock.java：自定义工具8.2 PlanService.java：计划管理服务8.3 AgentService.java：核心Agent服务（精华解析）8.3.1 初始化流程8.3.2 SSE事件映射8.3.3 人在回路（HITL）实现九、Controller层：REST API9.1 ChatController.java9.2 PlanController.java十、前端Web界面十一、构建与运行11.1 构建11.2 运行十二、测试验证指南12.1 功能测试用例用例1：简单对话用例2：多步骤任务用例3：人在回路暂停用例4：健康检查用例5：重置12.2 REST API 测试脚本12.3 日志验证十三、常见问题排查Q1：启动报错 "DASHSCOPE_API_KEY environment variable is required"Q2：编译报错 "package io.agentscope.core does not exist"Q3：端口8080被占用Q4：Agent响应异常或无输出Q5：SSE流中断或前端无响应Q6：模型不显示"思考"过程附录A：完整API参考Chat APIPlan APISSE事件协议总结概述2026年，AI Agent正在从概念走向落地。与传统的"一问一答"式对话机器人不同，AI Agent能够自主规划、调用工具、分步执行复杂任务，并在执行过程中接受人类干预——这正是"人在回路"（Human-in-the-Loop, HITL）的核心思想。今天，我们将基于AgentScope Java SDK和Spring Boot WebFlux，从零构建一个名为PlanNotebook的AI智能计划助手Web应用。它不仅能通过对话式交互帮你拆解复杂任务，还能实时可视化展示执行计划，并支持你在Agent执行中途随时暂停、审查甚至修改计划后再继续。本文覆盖从环境搭建到API调用的全流程，所有代码均可直接运行。一、项目概览1.1 PlanNotebook 是什么？PlanNotebook是一个基于ReAct（Reasoning + Acting）范式的AI Agent Web应用，具备以下核心能力：能力实现方式对话式任务拆解Agent通过自然对话理解用户意图，自动创建结构化执行计划SSE实时流式输出
