# agent客服

**Repository Path**: cxuq/agent-customer-service

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-31
- **Last Updated**: 2026-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能客服 Agent (Smart CS Agent)

基于 LLM + RAG + Function Calling 的电商智能客服系统。

## 快速开始

### 本地开发

```bash
# 1. 安装依赖
pip install -r requirements.txt

# 2. 配置环境变量
cp .env.example .env
# 编辑 .env，填入 OPENAI_API_KEY

# 3. 运行
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# 4. 测试
pytest tests/ -v
```

### Docker 部署

```bash
# 配置环境变量
cp .env.example .env
# 编辑 .env，填入 OPENAI_API_KEY

# 构建并启动全部服务
docker compose up -d

# 验证
curl http://localhost/health/
# {"status":"ok","version":"1.0.0","model":"gpt-4o"}

# 聊天测试
curl -X POST http://localhost/api/v1/chat \
  -H "Content-Type: application/json" \
  -d '{"session_id":"test-1","message":"你好","user_id":"u1"}'

# 可选：启动监控（Prometheus + Grafana）
docker compose -f docker-compose.monitoring.yml up -d
```

## 项目结构

```
agent/
├── app/
│   ├── main.py              # FastAPI 入口
│   ├── config.py            # 配置管理（YAML + 环境变量）
│   ├── models.py            # Pydantic 数据模型
│   ├── agent/
│   │   ├── core.py          # Agent 核心：LLM 调用 + 工具调度 + 置信度
│   │   ├── prompt.py        # Prompt 组装（YAML 模板 + Few-Shot）
│   │   ├── rag.py           # 向量检索（Milvus + BGE-M3）
│   │   ├── tools.py         # Function Calling 工具（5 个）
│   │   └── guardrail.py     # 安全护栏（敏感词 + 高风险转人工）
│   ├── api/
│   │   ├── chat.py          # 聊天接口（同步 + SSE 流式）
│   │   └── health.py        # 健康检查
│   └── utils/
│       ├── logger.py        # structlog 日志
│       └── session.py       # Redis 会话存储
├── tests/                   # 单元测试（4 个文件）
├── prompts/system_prompt.yaml
├── config/
│   ├── settings.yaml
│   ├── sensitive_words.txt
│   └── knowledge_seed.json
├── monitoring/              # Prometheus + 告警规则
├── Dockerfile
├── docker-compose.yml
├── docker-compose.monitoring.yml
├── nginx.conf
├── requirements.txt
└── 智能客服Agent开发案例.md   # 完整案例文档（立项→设计→开发→部署）
```

## 核心特性

| 特性 | 说明 |
|------|------|
| LLM 推理 | OpenAI GPT-4o，支持多轮 Function Calling |
| RAG 检索 | Milvus 向量库 + BGE-M3 Embedding + Rerank |
| 安全护栏 | 输入输出双重检查 + 高风险意图自动转人工 |
| 会话管理 | Redis 多轮对话，TTL 30 分钟 |
| 流式响应 | SSE 流式输出 |
| 工具调用 | 订单查询、物流查询、商品信息、退换货、转人工 |
| 监控告警 | Prometheus + Grafana，P95 延迟 / 错误率告警 |

## API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/v1/chat` | 同步聊天 |
| POST | `/api/v1/chat/stream` | SSE 流式聊天 |
| GET | `/health/` | 健康检查 |
| GET | `/health/ready` | 就绪检查 |