# Agent

**Repository Path**: elfbobo_admin_admin/agent

## Basic Information

- **Project Name**: Agent
- **Description**: 14 套可运行自我进化的 AI Agent 开源矩阵：LangGraph 多智能体编排 + RAG 知识库 + NL2SQL 问数 + 代码助手 + 爬虫/GUI 自动化 + 办公 Copilot + 短视频/作曲 + 数字人。含 Docker 一键部署、入门/进阶学习文档、面试简历摘要。Star 支持持续更新。
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-07-08
- **Last Updated**: 2026-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent 开源矩阵 · 14 套可运行 AI Agent + LangGraph 多智能体编排

[![Star](https://gitee.com/assssshuhuhuh/agent/badge/star.svg?theme=dark)](https://gitee.com/assssshuhuhuh/agent/stargazers)
[![Fork](https://gitee.com/assssshuhuhuh/agent/badge/fork.svg?theme=dark)](https://gitee.com/assssshuhuhuh/agent/members)

> **一套仓库，学完 AI Agent 全家桶** — RAG 知识库 · NL2SQL 问数 · 代码助手 · 网页爬虫 · GUI 自动化 · 办公 Copilot · 短视频/作曲 · 数字人  
> **LangGraph + WebSocket + Docker Compose**，能跑、能部署、能写简历、能面试。  
> 觉得有用？右上角 **[Star ⭐](https://gitee.com/assssshuhuhuh/agent/stargazers)** 一下，更新不迷路。

---

## 3 秒看懂

| 指标 | 内容 |
|------|------|
| **规模** | 14 个专业 Agent + 1 个总管 + 1 个运维平台 |
| **技术栈** | LangGraph · Nuxt 4 · FastAPI · Playwright · pgvector · Docker |
| **亮点** | 真实多服务架构，不是单文件 Demo |
| **文档** | 入门版 + 进阶版 + 14 篇单 Agent 教程 |
| **部署** | `docker compose up` 一键 LAN，ClawHive 控制台管模型 |

```mermaid
flowchart LR
  U[用户] <-->|WebSocket| M[Manager 总管]
  M --> RAG[RAG 文档问答]
  M --> DB[NL2SQL 问数]
  M --> CODE[代码助手]
  M --> WEB[爬虫 / GUI / 办公 / 媒体]
```

---

## 为什么值得 Star？

- **面试稀缺**：多 Agent 编排 + RAG + NL2SQL + 工具调用，一个仓库全覆盖  
- **源码可读**：每个 Agent 独立目录，带简历摘要与学习文档  
- **能真部署**：Manage-platform 提供 Compose + 控制台，不是 PPT 架构  
- **持续更新**：P0 编排底座、黄金路径 smoke、能力层 SSOT 在迭代  

**适合 Star 如果**：你在学 LangGraph / 准备 Agent 面试 / 想 Fork 做企业知识库或问数助手 / 需要多 Agent 参考实现。

---

## 5 分钟跑起来（最快体验）

```bash
git clone https://gitee.com/assssshuhuhuh/agent.git && cd agent

# 配置 API Key（DashScope 或 OpenAI 兼容）
cd Manager_Agent && npm i && cp .env.example .env
cd ../RAG_Agent && npm i && cp .env.example .env

# 终端 A：RAG  →  http://127.0.0.1:13102
cd RAG_Agent && npm run dev

# 终端 B：总管 →  http://127.0.0.1:13106
cd Manager_Agent && npm run dev
```

**验收**：RAG 上传 PDF → Manager 问「这份文档讲了什么？」→ 看到**带引用**的回答。

**一键全套部署** → [`Manage-platform_Agent/README.md`](Manage-platform_Agent/README.md)

---

## 学习文档（Star 后从这里开始）

| 文档 | 一句话 | 链接 |
|------|--------|------|
| **总索引** | 文档地图 | [Agent学习指南](docs/Agent学习指南.md) |
| **入门版** | 零基础 · 5 分钟体验 · 4 周路线 | [→ 入门](docs/Agent学习指南-入门版.md) |
| **进阶版** | 源码精读 · 跨 Agent 协作 · 面试话术 | [→ 进阶](docs/Agent学习指南-进阶版.md) |
| **单 Agent** | 14 篇，各含入门 + 进阶 | 见下表 · 位于各 Agent 目录 `学习指南.md` |

---

## Agent 能力矩阵

| Agent | 端口 | 关键词 | 学习文档 |
|-------|------|--------|----------|
| `Manager_Agent` | 13106 | **LangGraph 编排** · WebSocket · HITL | [📖](Manager_Agent/学习指南.md) |
| `RAG_Agent` | 13102 | **混合检索** · 引用溯源 · 私有知识库 | [📖](RAG_Agent/学习指南.md) |
| `DB_Agent` | 13101 | **NL2SQL** · Schema 接地 · 只读护栏 | [📖](DB_Agent/学习指南.md) |
| `code_assistent_Agent` | 13103 | Monaco · 语义检索 · 受控写盘 | [📖](code_assistent_Agent/学习指南.md) |
| `Extractor_Agent` | 13104 | HTTP/Playwright · 结构化爬虫 | [📖](Extractor_Agent/学习指南.md) |
| `Lobster_Agent` | 13108 | **GUI 自动化** · verify/recover | [📖](Lobster_Agent/学习指南.md) |
| `AI_admin_Agent` | 13105 | 办公 Copilot · 工具调用 | [📖](AI_admin_Agent/学习指南.md) |
| `Multimodal_Agent` | 13107 | 识图 · ASR · 视频理解 | [📖](Multimodal_Agent/学习指南.md) |
| `Music_Agent` | 13110 | MIDI 作曲 · 翻唱重混 · BGM | [📖](Music_Agent/学习指南.md) |
| `Video_Agent` | 13111 | 万相文生视频 · ffmpeg 混流 | [📖](Video_Agent/学习指南.md) |
| `AI_Agent` | 13112 | 语音数字人 · 对口型 | [📖](AI_Agent/学习指南.md) |
| `Companion_Agent` | 13115 | VRM 虚拟伴侣 · 表情驱动 | [📖](Companion_Agent/学习指南.md) |
| `Tavern_Agent` | 13109 | 规则引擎 + LLM 人格 Demo | [📖](Tavern_Agent/学习指南.md) |
| `Manage-platform_Agent` | 18073 | **Docker 一键部署** · ClawHive | [📖](Manage-platform_Agent/学习指南.md) |

各子目录 `README.md` 含**简历摘要**（技术栈 + 亮点），可直接写进项目经历。

---

## 按目标选 Agent（搜索导航）

| 你想做… | 先学这个 |
|---------|----------|
| 企业知识库 / RAG 面试 | `RAG_Agent` + `Manager_Agent` |
| BI 问数 / NL2SQL | `DB_Agent` |
| Cursor 类编程助手 | `code_assistent_Agent` |
| 数据采集 / 爬虫 | `Extractor_Agent` |
| 浏览器 RPA | `Lobster_Agent` |
| 办公 Copilot | `AI_admin_Agent` |
| 短视频 AIGC | `Video_Agent` → `Music_Agent` |
| 数字人 / VTuber | `AI_Agent` + `Companion_Agent` |
| 内网一键部署 | `Manage-platform_Agent` |

---

## 阅读顺序（建议）

1. [**入门版学习指南**](docs/Agent学习指南-入门版.md) — 建立全局观  
2. [`Manager_Agent/学习指南.md`](Manager_Agent/学习指南.md) — 理解编排层  
3. [`RAG_Agent/学习指南.md`](RAG_Agent/学习指南.md) + [`DB_Agent/学习指南.md`](DB_Agent/学习指南.md) — 数据双雄  
4. [**进阶版**](docs/Agent学习指南-进阶版.md) — 源码与面试  
5. 按兴趣深入各 Agent 目录下的 `学习指南.md`  

---

## 更多文档

| 文档 | 说明 |
|------|------|
| [Agent 升级评估与优先级](docs/Agent升级评估与优先级.md) | 生产差距 · P0/P1 路线图 |
| [企业级能力层模型方案](docs/企业级能力层模型方案.md) | 7 层 CAP 模型治理 |
| [公共技能市场方案](docs/公共技能市场方案.md) | Skill 化与市场 |
| [Gitee 仓库简介模板](docs/Gitee仓库简介.md) | 复制到 Gitee 项目描述，提升搜索曝光 |

---

## 参与与 Star

本项目在 [Gitee](https://gitee.com/assssshuhuhuh/agent) 持续维护：

1. **Star ⭐** — 支持更新，也让更多人发现这套 Agent 矩阵  
2. **Fork** — 只带走 `RAG_Agent` / `DB_Agent` 等单模块二次开发  
3. **Issue** — 标注 `学习反馈` / `文档` / `bug`  
4. **PR** — 欢迎补充 smoke 测试与学习文档  

---

## 维护说明

- 已移除弃用目录 `Older_Agent`（能力由 `Multimodal_Agent` 接管 13107）
- 根 `.gitignore` 统一忽略 `__pycache`、`dist/`、`.data/` 等运行时产物
- 分步优化路线图见下方（内部维护用）

<details>
<summary>分步优化路线图（点击展开）</summary>

| 阶段 | 范围 | 状态 |
|------|------|------|
| 1 | 全仓库 `.gitignore` 强化 | ✅ |
| 2 | `Tavern_Agent` | ✅ |
| 3 | `Video_Agent` | ✅ |
| 4 | `Multimodal_Agent` | ✅ |
| 5 | Nuxt 四件套 | ✅ |
| 6 | 升级文档精简 | ✅ |
| 7～10 | Music / Manager / Platform / 跨 Agent 共享 | 进行中 |

</details>

---

<!-- 搜索关键词：AI Agent, 多智能体, LangGraph, RAG, 知识库, NL2SQL, 自然语言查数, 代码助手, 爬虫, Playwright, 多模态, 数字人, Docker Compose, 开源, 教程, 面试 -->