# agent

**Repository Path**: Y-aong/agent

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-21
- **Last Updated**: 2026-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Agent

一个基于多Agent架构的AI智能助手系统，支持任务路由、规划执行、质量验证、知识检索等核心功能。

## 项目简介

Agent 是一个模块化的多Agent AI系统，采用LangGraph构建工作流，支持：

- **任务路由**：智能识别用户意图，将任务分发到合适的处理Agent
- **任务规划**：复杂任务自动拆分步骤，生成执行计划
- **质量验证**：基于规则的任务结果验证与质量检查
- **反思机制**：执行结果自检，失败自动重试
- **上下文管理**：会话压缩、话题切换、敏感信息保护
- **RAG知识库**：支持文档解析、向量化存储、知识图谱构建
- **工具生态**：Web搜索、网页提取、文件操作、终端命令等

## 核心架构

```
src/
├── agents/                    # Agent核心模块
│   ├── multi_agent/          # 多Agent编排
│   ├── agent_tools/          # 工具定义
│   ├── context_manager/     # 上下文管理
│   ├── prompt/              # 提示词构建
│   ├── agent_skills/        # Agent技能
│   └── tools/               # 工具实现
│       ├── web_tools/       # Web工具
│       ├── file_tools/      # 文件工具
│       └── terminal_tools/ # 终端工具
├── rag/                      # RAG知识库
│   ├── chunk/               # 文档分块
│   ├── parser/              # 文档解析
│   ├── kg/                  # 知识图谱
│   ├── vectordb/            # 向量数据库
│   └── retrieval/           # 检索引擎
├── apis/                     # FastAPI接口
└── web_extract_app.py        # 网页提取服务
```

## 功能特性

### Agent类型

| Agent | 功能 |
|-------|------|
| RouterAgent | 任务路由分发 |
| PlanAgent | 任务规划拆解 |
| ExecutionAgent | 步骤执行 |
| ValidationAgent | 质量规则生成 |
| ReflectionAgent | 执行结果反思 |
| CompressAgent | 对话压缩 |
| PersistAgent | 知识持久化 |
| ChatAgent | 简单对话 |

### 工具能力

- **Web搜索**：支持Tavily、DuckDuckGo搜索
- **网页提取**：支持HTML解析、Markdown转换
- **文件操作**：读取、写入、补丁修改
- **终端命令**：安全沙箱执行
- **进程管理**：后台进程启停

### RAG能力

- **文档解析**：PDF、Markdown、Text
- **语义分块**：基于嵌入的智能分块
- **知识图谱**：Neo4j/NetworkX存储
- **混合检索**：向量+关键词混合搜索

## 快速开始

### 环境要求

- Python 3.10+
- Node.js 18+ (前端)

### 安装依赖

```bash
# Python依赖
pip install -r requirements.txt

# 前端依赖
cd fronted/agent
npm install
```

### 配置

编辑 `src/config.yml` 配置API密钥、数据库连接等：

```yaml
llm:
  api_key: your-api-key
  base_url: https://api.deepseek.com

vectorstore:
  type: chroma
  persist_directory: ./agent_data/chroma

knowledge_graph:
  type: networkx
  persist_path: ./agent_data/graph.gpickle
```

### 运行

```bash
# 启动API服务
python -m uvicorn src.app:create_app --reload

# 启动网页提取服务
python src.web_extract_app

# 前端开发
cd fronted/agent
npm run dev
```

## 工具使用

### Web搜索

```python
from src.agents.tools.web_tools.web_search import web_search_tool

result = web_search_tool(query="Python异步编程", limit=5)
```

### 文件读取

```python
from src.agents.tools.file_tools.read_file import read_file

content = read_file(path="/path/to/file.py", offset=1, limit=100)
```

### 终端命令

```python
from src.agents.tools.terminal_tools.terminal import terminal

result = terminal(command="ls -la", cwd="/home", timeout=30)
```

## API接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/agent/chat` | POST | Agent对话 |
| `/agent/session` | GET | 获取会话历史 |
| `/rag/ingest` | POST | 文档入库 |
| `/rag/query` | POST | 知识检索 |
| `/browser/start` | POST | 启动浏览器 |

## 测试

```bash
# 运行所有测试
pytest

# 运行特定测试
pytest test/agent/agent_test/test_router_agent.py -v
```

## 技术栈

- **Agent框架**：LangGraph、LangChain
- **LLM调用**：DeepSeek API
- **向量存储**：Chroma、Milvus
- **知识图谱**：Neo4j、NetworkX
- **文档解析**：Marker
- **前端**：Vue 3 + TypeScript + Vite
- **后端**：FastAPI
- **数据库**：SQLite

## 许可证

MIT License