# my-agents

**Repository Path**: ai_1024/my-agents

## Basic Information

- **Project Name**: my-agents
- **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-02-28
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# My Agents

个人智能体项目

## 项目简介

基于 LangGraph 的多智能体协作系统，支持：
- **多智能体协作**：4 个专业 Agent 自动协调完成任务
- **渐进式 Skills**：Token 消耗减少 60-80%
- **配置驱动**：通过 YAML 文件定义 Agent
- **知识库问答**（RAG）
- **CLI 交互**：命令行智能体对话

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 配置环境变量

```bash
cp .env.example .env
# 编辑 .env 文件，填入你的 ZHIPU_API_KEY
```

### 3. 启动 CLI

```bash
python scripts/cli_chat.py
```

### 4. 启动后端服务（可选）

```bash
uvicorn backend.main:app --reload --port 8000
```

## 多智能体系统

### 架构

```
config/agents.yaml ─────────────────┐
                                    ▼
MultiAgentOrchestrator ──▶ AgentFactory ──▶ ToolRegistry (14 工具)
                                    │
                                    └──▶ ProgressiveSkillLoader
                                                │
                                                ▼
                                        skill/*/SKILL.md (4 个)
```

### Agent 角色

| Agent | 职责 | 工具 |
|-------|------|------|
| **Researcher** | 技术调研、资料收集 | web_search, analyze_repo |
| **Coder** | 代码实现 | read_file, write_file, run_command |
| **Reviewer** | 代码审核 | run_lint, run_tests, security_check |
| **Doc Writer** | 文档编写 | write_file |

### 使用示例

```python
from framework.multi_agent import MultiAgentOrchestrator
from framework.core.llm import GLMClient

llm = GLMClient()
orchestrator = MultiAgentOrchestrator(llm=llm)
app = orchestrator.compile()

result = app.invoke({"messages": ["开发一个 REST API"]})
```

### 配置驱动

编辑 `config/agents.yaml` 添加新 Agent：

```yaml
agents:
  my_agent:
    name: "my_agent"
    tools:
      - read_file
      - write_file
    enabled: true
```

## 项目结构

```
my-agents/
├── config/
│   └── agents.yaml           # Agent 配置
│
├── skill/                    # 渐进式 Skills
│   ├── researcher/
│   ├── coder/
│   ├── reviewer/
│   └── doc_writer/
│
├── framework/
│   ├── core/                 # 核心组件
│   │   └── llm.py
│   │
│   ├── tools/                # 统一工具（14 个）
│   │   ├── file_tools.py
│   │   ├── web_tools.py
│   │   └── code_tools.py
│   │
│   ├── skills/               # 渐进式加载
│   │   └── progressive_loader.py
│   │
│   └── multi_agent/          # 多智能体
│       ├── orchestrator.py
│       ├── factory.py
│       └── config.py
│
├── scripts/
│   └── cli_chat.py           # CLI 入口
│
└── tests/                    # 测试文件
```

## CLI 使用

```bash
# 启动 CLI
python scripts/cli_chat.py

# 命令
> mode multi    # 切换到多智能体模式
> team          # 查看 Agent 信息
> skills        # 查看已安装技能
> help          # 查看帮助
```

## 运行测试

```bash
# 运行所有测试
pytest tests/ -v

# 运行多智能体测试
pytest tests/test_multi_agent/ -v

# 运行单个测试
pytest tests/test_multi_agent/test_factory.py -v
```

## 开发进度

- [x] Stage 1: LLM 基础封装
- [x] Stage 2: 多模态能力
- [x] Stage 3: Embedding + 向量存储
- [x] Stage 4: Agent 框架
- [x] Stage 5: RAG Agent
- [x] Stage 6: 多智能体协作
- [x] Stage 7: 渐进式 Skills
- [x] Stage 8: 配置驱动架构
- [x] Stage 9: CLI 交互
- [x] Stage 10: 代码清理与重构

## 环境变量

**必需**：
- `ZHIPU_API_KEY`: 智谱 AI API 密钥

**可选**：
- `SERPER_API_KEY`: Serper 搜索 API 密钥
- `ZHIPU_BASE_URL`: API 端点
- `ZHIPU_MODEL`: 模型名称（默认: glm-4）

## 许可证

MIT