# zhipin-cloud-agent-server

**Repository Path**: nomenofear/zhipin-cloud-agent-server

## Basic Information

- **Project Name**: zhipin-cloud-agent-server
- **Description**: 智聘云图AI Agent服务
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-10-10
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zhipin-cloud-agent-server (智聘云图智能体服务)

> 基于 Python + LangChain 的 AI 智能体服务框架，为智聘云图平台提供 AI 智能决策能力。

**技术栈：** `Python 3.13` · `FastAPI` · `LangChain` · `LangGraph` · `Redis` · `Nacos`

### 核心特性

- 🤖 **多智能体架构**：基于抽象基类的统一 Agent 管理
- 🔄 **SSE 流式输出**：支持 Server-Sent Events 实时推送，可中断控制
- 🔌 **Nacos 服务注册**：自动注册发现，心跳健康检查
- ♻️ **热更新配置**：Nacos 配置中心驱动的 Prompt 热更新
- 🛠️ **工具可扩展**：支持 LangChain Tool / MCP 等多种工具集成

### 快速开始

```bash
# 安装依赖
uv sync

# 配置环境变量
cp .env.example .env

# 启动服务
uv run python main.py
```

服务启动后监听 `0.0.0.0:18600`，自动向 Nacos 注册。

### 日常开发命令

| 命令 | 说明 |
|------|------|
| `uv sync` | 安装/同步所有依赖 |
| `uv run python main.py` | 启动服务 |
| `uv add <pkg>` | 添加新依赖 |
| `uv remove <pkg>` | 移除依赖 |
| `uv lock` | 重新生成锁文件 |
| `uv pip list` | 查看已安装包 |

### API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/chat` | 非流式对话 |
| POST | `/chat/stream` | 流式对话（SSE） |
| POST | `/chat/stop` | 停止会话 |
| GET | `/hello` | 健康检查 |

### 项目结构

```
├── main.py              # 入口
├── agent/               # 智能体核心（基类 + 注册表 + 实现）
├── web/                 # FastAPI Web 层
├── config/              # 配置管理（YAML/Nacos/Redis）
├── common/              # 公共常量
└── util/                # 工具类
```

### 开发指南

新增智能体：在 `agent/` 下创建模块 → 继承 `BaseAgent` → 在 `Agents.py` 注册。详见 `AGENTS.md`。