feat: 完整功能部署 v1.0
新增功能: - 天网协作系统 (HTTP API 端口 6060) - 三种工作流 (查找图片/处理图片/转人工派单) - 图片任务数据库 (支持客户后续增加需求) - 图绘派单系统集成 (API: 8005) - 文字检测与加价 (60-80 元高价值订单) - 风险评估与接单判断 - 作图失败自动转人工 新增文档: - 项目功能汇总.md - 三种工作流功能说明.md - 文字加价功能说明.md - 风险评估功能说明.md - 图片任务数据库功能说明.md - 图绘派单系统集成说明.md - 作图失败转接人工说明.md - DEPLOYMENT.md - TIANWANG_INTEGRATION.md 核心修改: - core/pydantic_ai_agent.py - core/workflow.py - core/websocket_client.py - image/image_analyzer.py - services/service_tuhui_dispatch.py - db/image_tasks_db.py 版本:v1.0 日期:2026-02-28
This commit is contained in:
278
图绘派单系统集成说明.md
Normal file
278
图绘派单系统集成说明.md
Normal file
@@ -0,0 +1,278 @@
|
||||
# 图绘派单系统集成说明
|
||||
|
||||
## 📋 功能说明
|
||||
|
||||
AI 客服系统已接入图绘派单系统 API,实现自动派单给在线设计师。
|
||||
|
||||
---
|
||||
|
||||
## 🚀 派单系统 API
|
||||
|
||||
### 基础信息
|
||||
- **API 地址**: http://1.12.50.92:8005
|
||||
- **API Key**: tuhui_dispatch_key_2026
|
||||
- **认证方式**: Header: X-API-Key
|
||||
|
||||
### 核心接口
|
||||
|
||||
| 接口 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/dispatch/queue` | GET | 获取派单队列 |
|
||||
| `/online/designers` | GET | 获取在线设计师 |
|
||||
| `/tasks` | POST | 创建任务 |
|
||||
| `/tasks/{id}/assign` | POST | 分配任务 |
|
||||
| `/tasks/{id}` | GET | 查询任务状态 |
|
||||
| `/tasks/{id}/complete` | POST | 完成任务 |
|
||||
|
||||
---
|
||||
|
||||
## 🔄 工作流程
|
||||
|
||||
### 转人工派单流程
|
||||
|
||||
```
|
||||
客户:这个能做吗 [图片]
|
||||
AI: 抱歉,这个我做不了,帮您转接设计师
|
||||
↓
|
||||
1. 查询在线设计师
|
||||
GET /online/designers
|
||||
返回:["橘子", "婷婷"]
|
||||
↓
|
||||
2. 创建派单任务
|
||||
POST /tasks
|
||||
返回:{"task_id": "ea853bd9"}
|
||||
↓
|
||||
3. 分配给设计师
|
||||
POST /tasks/ea853bd9/assign
|
||||
{"designer_name": "橘子"}
|
||||
↓
|
||||
4. 企业微信通知设计师
|
||||
↓
|
||||
5. 回复客户
|
||||
"好的,已帮您安排设计师处理,请稍候"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 API 调用示例
|
||||
|
||||
### 1. 查询在线设计师
|
||||
|
||||
```python
|
||||
from services.service_tuhui_dispatch import get_tuhui_dispatch_client
|
||||
|
||||
client = get_tuhui_dispatch_client()
|
||||
designers = await client.get_online_designers()
|
||||
# 返回:["橘子", "婷婷"]
|
||||
```
|
||||
|
||||
### 2. 创建任务
|
||||
|
||||
```python
|
||||
task_id = await client.create_task(
|
||||
task_name="图片处理 -1234",
|
||||
description="客户需要做高清修复",
|
||||
task_type="image_process",
|
||||
priority=2
|
||||
)
|
||||
# 返回:"ea853bd9"
|
||||
```
|
||||
|
||||
### 3. 分配任务
|
||||
|
||||
```python
|
||||
success = await client.assign_task(
|
||||
task_id="ea853bd9",
|
||||
designer_name="橘子",
|
||||
notes="AI 客服自动派单"
|
||||
)
|
||||
# 返回:True
|
||||
```
|
||||
|
||||
### 4. 查询任务状态
|
||||
|
||||
```python
|
||||
status = await client.get_task_status("ea853bd9")
|
||||
# 返回:{"status": "assigned", "assigned_to": "橘子", ...}
|
||||
```
|
||||
|
||||
### 5. 完成任务
|
||||
|
||||
```python
|
||||
success = await client.complete_task(
|
||||
task_id="ea853bd9",
|
||||
notes="客户已确认,效果满意"
|
||||
)
|
||||
# 返回:True
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 集成代码位置
|
||||
|
||||
### 派单客户端
|
||||
|
||||
文件:`/root/ai_customer_service/ai_cs/services/service_tuhui_dispatch.py`
|
||||
|
||||
**类**: `TuhuiDispatchClient`
|
||||
|
||||
**方法**:
|
||||
- `get_online_designers()` - 查询在线设计师
|
||||
- `create_task()` - 创建任务
|
||||
- `assign_task()` - 分配任务
|
||||
- `get_task_status()` - 查询状态
|
||||
- `complete_task()` - 完成任务
|
||||
|
||||
---
|
||||
|
||||
### 工作流集成
|
||||
|
||||
文件:`/root/ai_customer_service/ai_cs/core/workflow.py`
|
||||
|
||||
**方法**:
|
||||
- `transfer_to_designer_workflow()` - 转人工派单工作流
|
||||
- `_get_online_designers()` - 查询在线设计师
|
||||
- `_dispatch_to_designer()` - 派单给设计师
|
||||
|
||||
---
|
||||
|
||||
## 📊 派单逻辑
|
||||
|
||||
### 1. 查询在线设计师
|
||||
|
||||
```python
|
||||
designers = await workflow._get_online_designers()
|
||||
# 返回:["橘子", "婷婷"]
|
||||
```
|
||||
|
||||
### 2. 创建派单任务
|
||||
|
||||
```python
|
||||
dispatch_task_id = await workflow.dispatch_client.create_task(
|
||||
task_name=f"图片处理-{customer_id[-4:]}",
|
||||
description=f"{reason}\\n客户:{customer_id}\\n图片:{image_url}",
|
||||
task_type="image_process",
|
||||
priority=2
|
||||
)
|
||||
```
|
||||
|
||||
### 3. 分配给设计师
|
||||
|
||||
```python
|
||||
success = await workflow.dispatch_client.assign_task(
|
||||
task_id=dispatch_task_id,
|
||||
designer_name=designer_name, # "橘子"
|
||||
notes=f"AI 客服自动派单\\n原因:{reason}\\n客户:{customer_id}"
|
||||
)
|
||||
```
|
||||
|
||||
### 4. 企业微信通知
|
||||
|
||||
```python
|
||||
await _wechat_notify(
|
||||
f"📋 **新任务派单**\\n"
|
||||
f"设计师:{designer_name}\\n"
|
||||
f"任务 ID: {dispatch_task_id}\\n"
|
||||
f"客户:{customer_id}\\n"
|
||||
f"原因:{reason}\\n"
|
||||
f"请及时处理"
|
||||
)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 注意事项
|
||||
|
||||
1. **API Key**: 固定为 `tuhui_dispatch_key_2026`
|
||||
2. **超时设置**: 默认 10 秒
|
||||
3. **错误处理**: 所有 API 调用都有 try-except
|
||||
4. **企业微信通知**: 派单成功后自动发送
|
||||
5. **任务命名**: 格式为 `图片处理-{客户 ID 后 4 位}`
|
||||
|
||||
---
|
||||
|
||||
## 🔍 日志查看
|
||||
|
||||
```bash
|
||||
# 查看派单日志
|
||||
grep "派单" /tmp/ai-cs.log
|
||||
|
||||
# 查看在线设计师查询
|
||||
grep "在线设计师" /tmp/ai-cs.log
|
||||
|
||||
# 查看任务创建
|
||||
grep "创建任务" /tmp/ai-cs.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📈 派单统计
|
||||
|
||||
### 查询派单队列
|
||||
|
||||
```bash
|
||||
curl -X GET "http://1.12.50.92:8005/dispatch/queue" \
|
||||
-H "X-API-Key: tuhui_dispatch_key_2026"
|
||||
```
|
||||
|
||||
**返回**:
|
||||
```json
|
||||
{
|
||||
"pending_tasks": {"count": 3, "tasks": [...]},
|
||||
"online_designers": {"count": 2, "designers": ["橘子", "婷婷"]},
|
||||
"suggestion": "橘子"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 完整示例
|
||||
|
||||
### AI 客服转人工派单
|
||||
|
||||
```python
|
||||
# 客户说"做不了"
|
||||
await workflow.transfer_to_designer_workflow(
|
||||
customer_id="customer_123",
|
||||
image_url="https://xxx.com/image.jpg",
|
||||
acc_id="shop_001",
|
||||
acc_type="AliWorkbench",
|
||||
reason="图片过于模糊,AI 无法处理"
|
||||
)
|
||||
|
||||
# 执行流程:
|
||||
# 1. 查询在线设计师 → ["橘子", "婷婷"]
|
||||
# 2. 创建任务 → "ea853bd9"
|
||||
# 3. 分配给"橘子"
|
||||
# 4. 企业微信通知
|
||||
# 5. 回复客户:"好的,已帮您安排设计师处理"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📞 技术支持
|
||||
|
||||
**派单系统服务器**: 1.12.50.92:8005
|
||||
|
||||
**查看派单系统日志**:
|
||||
```bash
|
||||
tail -f /var/log/dispatch_api.log
|
||||
```
|
||||
|
||||
**查看派单进程**:
|
||||
```bash
|
||||
ps aux | grep dispatch
|
||||
```
|
||||
|
||||
**重启派单服务**:
|
||||
```bash
|
||||
pkill -f dispatch_api
|
||||
cd /root/tuhui/backend
|
||||
nohup python3 -m uvicorn dispatch_api:app --host 0.0.0.0 --port 8005 > /var/log/dispatch_api.log 2>&1 &
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**文档版本**: v1.0
|
||||
**更新日期**: 2026-02-27
|
||||
|
||||
Reference in New Issue
Block a user