# agent-dev

**Repository Path**: gooree/agent-dev

## Basic Information

- **Project Name**: agent-dev
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Dev

Agent Dev 是一个企业级 AI Agent 开发框架，专为构建智能对话助手和自动化任务执行系统而设计。

## 项目简介

本框架提供了一套完整的 AI Agent 开发解决方案，支持多种架构模式（包括 ReAct、Plan-and-Execute、Supervisor 等），集成了工具系统、记忆系统、技能系统、RAG 知识库等核心功能模块。通过模块化设计，开发者可以灵活选择所需组件，快速构建适用于不同场景的智能 Agent 应用。

## 技术栈

- **核心框架**：LangChain4j
- **通信协议**：gRPC、HTTP SSE
- **数据存储**：向量数据库、关系数据库
- **后端框架**：Spring Boot
- **主要语言**：Java

## 核心特性

### 多种推理模式

- **ReAct 模式**：Reasoning + Action 循环推理
- **Plan-and-Execute 模式**：规划执行分离
- **Supervisor 模式**：多智能体协作调度

### 工具系统

- MCP 工具集成
- Skill 技能系统
- RAG 知识检索
- 自定义工具扩展

### 记忆系统

- 短期记忆（滑动窗口）
- 长期记忆持久化
- 梦境机制自动整理
- 上下文窗口压缩

### 通信架构

- gRPC 双通道通信
- SSE 流式响应
- OpenAPI 兼容接口

## 模块说明

| 模块 | 说明 |
|------|------|
| langchat | Agent 核心架构与基础能力 |
| mateclaw | Agent 生命周期与状态管理 |
| ruoyi | Agent 接口定义与开发 |
| snail | 客户端通信与服务端 |

## 快速开始

### Maven 依赖

```xml
<dependency>
    <groupId>com.example</groupId>
    <artifactId>agent-dev</artifactId>
    <version>1.0.0</version>
</dependency>
```

### 基本配置

```yaml
agent:
  enable: true
  default-model: gpt-4
```

### 创建第一个 Agent

```java
@Agent(name = "my-agent")
public class MyAgent {
    
    @SystemMessage("你是一个有用的助手...")
    public String chat(String input) {
        return input;
    }
}
```

## 文档索引

- [langchat 模块](./langchat/README-agent.md) - Agent 核心功能参考
- [mateclaw 模块](./mateclaw/README.md) - MateClaw Agent 开发参考
- [ruoyi 模块](./ruoyi/01-agent-architecture-overview.md) - Agent 架构概述
- [snail 模块](./snail/README.md) - Snail AI Agent 开发参考

## 许可证

MIT License