# agentscope-java-guide

**Repository Path**: fyjwxj/agentscope-java-guide

## Basic Information

- **Project Name**: agentscope-java-guide
- **Description**: 这是一个专门为学习 Agentscope Java 框架而设计的实践项目，帮助你从零开始掌握智能体开发。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-08
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agentscope Java 学习指南

这是一个专门为学习 Agentscope Java 框架而设计的实践项目，帮助你从零开始掌握智能体开发。

## 🎯 项目目标

通过循序渐进的示例和实践，让你：
- 理解 Agentscope Java 的核心概念
- 掌握智能体的基本开发模式
- 学会工具调用和多智能体协作
- 实现复杂的 AI 应用场景

## 📚 完整学习路线

**👉 从这里开始：[docs/INDEX.md](docs/INDEX.md)** - 完整的学习路线索引

### 阶段概览

| 阶段 | 主题 | 预计时间 | 文档 |
|------|------|----------|------|
| 0 | 环境准备 | 0.5天 | [00-项目概览](docs/00-项目概览/) |
| 1 | 核心概念 | 1-2天 | [01-核心概念](docs/01-核心概念/) |
| 2 | 基础实践 | 2-3天 | [02-基础实践](docs/02-基础实践/) |
| 3 | 进阶特性 | 3-4天 | [03-进阶特性](docs/03-进阶特性/) |
| 4 | Web演示 | 2-3天 | [04-Web演示](docs/04-Web演示/) |

## 🚀 快速开始

### 1. 环境要求
- Java 17+
- Maven 3.6+
- Node.js 18+ (用于 Web 演示)

### 2. 启动 Web 演示平台

```bash
# 方式一：启动所有服务 (Studio + 后端 + 前端)
cd web-demo
start-all.bat

# 方式二：分别启动
stop-all.bat          # 停止所有服务
start-studio.bat      # 启动 Studio
# 在另一个窗口:
cd web-demo/backend
restart.bat           # 启动后端
# 在另一个窗口:
cd web-demo
start-frontend.bat    # 启动前端
```

### 3. 访问应用
- 前端界面：http://localhost:3000
- Studio 界面：http://localhost:5173

## 🏗️ 项目结构

```
agentscope-java-guide/
├── pom.xml                     # Maven 父项目配置
├── settings.xml                # Maven 镜像配置（阿里云）
├── docs/                       # 学习文档
│   ├── INDEX.md               # 学习路线索引 (从这里开始!)
│   ├── 00-项目概览/           # 快速开始、环境搭建
│   ├── 01-核心概念/           # Agent、Message、Memory、Model
│   ├── 02-基础实践/           # HelloWorld、工具调用、ReAct
│   ├── 03-进阶特性/           # 多智能体、流式输出 (待补充)
│   ├── 04-Web演示/            # Studio 集成和部署
│   └── 05-参考资料/           # 更新日志、版本说明
├── web-demo/                   # Web 演示平台
│   ├── backend/               # Spring Boot 后端 (Maven 子模块)
│   │   ├── pom.xml            # 后端 Maven 配置
│   │   ├── restart.bat        # 重启后端脚本
│   │   └── _archive/          # 归档的旧脚本
│   ├── frontend/              # React 前端 (Node.js 模块)
│   │   ├── package.json       # 前端依赖配置
│   │   └── vite.config.ts     # Vite 构建配置
│   ├── start-all.bat          # 启动所有服务
│   ├── stop-all.bat           # 停止所有服务
│   ├── start-studio.bat       # 启动 Studio
│   ├── FRONTEND_MODULE_SETUP.md  # Frontend IDE 配置指南
│   └── README.md              # Web Demo 详细说明
├── agentscope-java-source/    # AgentScope 框架源码 (学习参考)
└── README.md                  # 本文件
```

### 💡 IntelliJ IDEA 模块配置

本项目采用混合架构（Java + Node.js），在 IDE 中的配置方式：

- **Backend**: Maven 子模块，自动被 IDE 识别
- **Frontend**: Node.js 模块，需手动添加到 IDE
  - 详见 [web-demo/FRONTEND_MODULE_SETUP.md](web-demo/Frontend_MODULE_SETUP.md)
  - 或通过 `File → Project Structure → Modules → Import Module` 添加

## 📖 学习资源

- [官方文档](https://java.agentscope.io/)
- [GitHub 仓库](https://github.com/agentscope-ai/agentscope-java)
- [API 参考](https://java.agentscope.io/api/)

## 📝 脚本说明

| 脚本 | 功能 |
|------|------|
| `stop-all.bat` | 停止所有服务（含 H2 数据库锁清理） |
| `start-all.bat` | 启动所有服务（Studio + 后端 + 前端） |
| `start-studio.bat` | 仅启动 AgentScope Studio |
| `backend/restart.bat` | 编译并重启后端 |
| `start-frontend.bat` | 仅启动前端开发服务器 |

旧脚本已归档到 `web-demo/_archive/` 和 `web-demo/backend/_archive/`。

## 🤝 贡献指南

欢迎提交 Issues 和 Pull Requests 来完善这个学习项目！

## 📝 许可证

MIT License