tw/图绘派单系统集成说明.md

图绘派单系统集成说明

📋 功能说明

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. 查询在线设计师

from services.service_tuhui_dispatch import get_tuhui_dispatch_client

client = get_tuhui_dispatch_client()
designers = await client.get_online_designers()
# 返回：["橘子", "婷婷"]

2. 创建任务

task_id = await client.create_task(
    task_name="图片处理 -1234",
    description="客户需要做高清修复",
    task_type="image_process",
    priority=2
)
# 返回："ea853bd9"

3. 分配任务

success = await client.assign_task(
    task_id="ea853bd9",
    designer_name="橘子",
    notes="AI 客服自动派单"
)
# 返回：True

4. 查询任务状态

status = await client.get_task_status("ea853bd9")
# 返回：{"status": "assigned", "assigned_to": "橘子", ...}

5. 完成任务

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. 查询在线设计师

designers = await workflow._get_online_designers()
# 返回：["橘子", "婷婷"]

2. 创建派单任务

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. 分配给设计师

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. 企业微信通知

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 位}

---

🔍 日志查看

# 查看派单日志
grep "派单" /tmp/ai-cs.log

# 查看在线设计师查询
grep "在线设计师" /tmp/ai-cs.log

# 查看任务创建
grep "创建任务" /tmp/ai-cs.log

---

📈 派单统计

查询派单队列

curl -X GET "http://1.12.50.92:8005/dispatch/queue" \
  -H "X-API-Key: tuhui_dispatch_key_2026"

返回:

{
  "pending_tasks": {"count": 3, "tasks": [...]},
  "online_designers": {"count": 2, "designers": ["橘子", "婷婷"]},
  "suggestion": "橘子"
}

---

🎯 完整示例

AI 客服转人工派单

# 客户说"做不了"
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

查看派单系统日志:

tail -f /var/log/dispatch_api.log

查看派单进程:

ps aux | grep dispatch

重启派单服务:

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