# my-agent-server-v2

**Repository Path**: lsq2025/my-agent-server-v2

## Basic Information

- **Project Name**: my-agent-server-v2
- **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-04-16
- **Last Updated**: 2026-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pegasus Chat Agent V2

轻量版 IM Agent - 对接 pufferfish-server

## 项目状态

✅ **Phase 2 完成** - 核心功能已实现

## 特点

| 特点 | v1 | v2 |
|------|-----|-----|
| 代码量 | 5,573 行 | **1,136 行** |
| 主循环 | 6 阶段 | **3 阶段** |
| 工具获取 | 本地注册 | **动态获取** |
| Planner | 488 行 | **删除** |
| Runner | 640 行 | **删除** |
| Responder | 179 行 | **删除** |
| Reflection | 264 行 | **删除** |

## 目录结构

```
pegasus-chat-agent-v2/
├── agent/           # Agent 核心（3 文件）
│   ├── agent.py     # 主循环（192 行）
│   ├── context.py   # 上下文（25 行）
│   └── events.py    # 事件定义（28 行）
├── api/             # API 层
│   ├── routes/      # FastAPI 路由
│   └── schemas/     # 数据模型
├── llm/             # LLM 客户端（159 行）
├── tools/           # 远程工具调用（188 行）
├── session/         # 会话管理（171 行）
├── utils/           # 工具函数
├── main.py          # CLI 入口（148 行）
└── server.py        # FastAPI 入口（49 行）
```

## 主循环

```
THINKING → EXECUTING → ANSWERING → COMPLETE
(思考中)   (执行中)   (回答中)   (完成)
```

## 快速开始

### 1. 安装依赖

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

### 2. 配置环境

```bash
cp .env.example .env
# 编辑 .env 填入配置
```

### 3. 启动

#### CLI 交互模式

```bash
python3 main.py -i --user-id alice
```

#### FastAPI 服务

```bash
python3 server.py
```

## API 接口

| 接口 | 说明 |
|------|------|
| `POST /internal/v1/assistant/chat` | 聊天（对接 pufferfish） |
| `GET /internal/v1/assistant/health` | 健康检查 |

## 对接 pufferfish-server

### 工具动态获取

```python
# 从 pufferfish /tools/specs 获取工具清单
tools = await tool_manager.fetch_tools_specs()
```

### 工具执行

```python
# 调用 pufferfish /tools/execute
results = await tool_manager.execute_tools(user_id, session_id, tool_calls)
```

## IM 业务工具

| 工具 | 功能 |
|------|------|
| chat.rank.topn | 聊天排行 |
| wallet.balance.get | 钱包余额 |
| contact.inactive.list | 未联系好友 |
| conversation.session.list | 会话列表 |
| device.list | 设备列表 |
| kyc.status.get | KYC 状态 |
| ... | 等 14 个工具 |

## 参考

- 重构方案: `/cloud/documents/pegasus-chat-agent-v2/pegasus-chat-agent-v2-refactor-plan-2026-04-16.md`
- v1 项目: `/data/lanshanquan/cloud/agents/pegasus-chat-agent-v1`
- 对接文档: `v1/docs/agent-interface-20260415.md`