deepsop-humabot — deepsop-huma机器人

人机协作台（Human-AI Collaboration） 功能简介

人机协作台是基于 deepsop 平台的智能销售任务助手，能够：

理解自然语言指令：直接描述需求，如「帮我找50个美国做服装的客户」 智能任务拆解：自动识别目标数量、行业、地区、执行周期等参数 多员工协作：根据任务类型自动分配对应职能员工 AIWa：客户挖掘（找客户、行业客户等） Frank：邮件销售 Fran：电话销售 Lisa：短信销售 Toby：AI 视频生成并发布到 TikTok 自动提交任务：调用 deepsop API 提交任务，后台异步执行 定时查询结果：任务提交后询问用户期望等待时长，按用户指定时间自动查询并推送结果（默认 8 分钟） 生成 xlsx 报表：AIWa 客户数据自动生成带样式的 Excel 文件返回 Frank 邮件统计：查询邮件发送总数、成功数、已读数、回复数、点击数，并展示发送详情 Fran 电话销售：自动查询号码池与场景库，由用户选择后提交电话销售任务（必须与 AIWa 搭配使用） Lisa 短信统计：查询短信发送总数、成功数、失败数，并展示发送详情（必须与 AIWa 搭配使用） Toby TikTok 发布统计：查询视频发布数、播放量、点赞、评论、分享等数据，并展示每条视频明细和 TikTok 链接 前置条件：获取 API Key

本技能需要 API Key 授权才能调用 DeepSOP 接口。请按以下步骤获取：

获取 API Key 入口： 已有账号 → 前往 https://AI.deepsop.com/记录in?source=3 登录获取 没有账号 → 前往 https://AI.deepsop.com/register?source=3 注册后获取 登录后进入「设置」或「API 管理」页面 新建 API Key，复制以 sk- 开头的密钥 在 OpenClaw 中配置环境变量： DEEPSOP_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxx

所有 API 请求头需携带：x-API-key: $DEEPSOP_API_KEY API Base URL：https://AI.deepsop.com/prod-API/

⛔ 接口路径强约束（最高优先级，所有 HTTP 请求必须遵守）

🔒 核心规则： 调用任何接口时，必须严格使用本文档对应步骤标注的完整 URL，不得做任何形式的改写、简化、猜测或自创。

请求前自检流程（每一次 HTTP 请求都必须执行）：

在下方「API 路径权威清单」中找到对应步骤的接口； 将即将发出的完整 URL（含 host、path、查询 key 名与顺序、pageNum/pageSize/平台 等参数值）与清单中的 Path 列逐字符比对； 完全一致才允许发出请求；任何偏差立即停止，按清单中的路径修正后再重试； 若某接口未在清单中列出 → 绝对禁止自行编造路径，必须先向用户确认。

禁止行为：

❌ 把 prod-API 改成 API / v1 / prod / prodAPI ❌ 把 camelCase 改成 snake_case 或全小写（如 pre设置Employee ≠ pre设置_employee ≠ pre设置employee） ❌ 把 outBound 写成 outbound、emAIlconfig 写成 emAIlConfig、authaccount 写成 authAccount（这三个偏偏就是全小写，特别注意） ❌ 用同义词替换路径段（获取CustomerPoolDetAIl ≠ customerPoolDetAIl / 获取CustomerDetAIl；collaborationCall结果 ≠ call结果） ❌ 漏写或私自补加 查询 参数（如漏 平台=1 / 状态=1，或私自加 pageSize=20 改成 pageSize=10） ❌ 凭"上一次调用记得"或"经验"猜测路径，不回到本文档对照

路径错误是最常见、最可避免、影响最大的事故，必须零容忍。

📋 API 路径权威清单（Base URL: https://AI.deepsop.com/prod-API） # 步骤 方法 Path（不含 Base URL） 1 Step 1.5 数字员工可用性 获取 /AI/pre设置Employee/列出 1.1 Step 1.5.1① 签约套餐列表 获取 /AI/设置ting/列出?packa获取ype=3 1.2 Step 1.5.1② 人民币→K币汇率 获取 /系统/config/configKey/CNY_TO_KCOIN 1.3 Step 1.5.1③ K币余额查询 获取 /AI/vip/balance?userId={userId} 1.4 Step 1.5.1④ 提交签约（扣K币） POST /AI/order/purchaseIndependentPackageByK令牌 2 Step 3 提交任务 POST /AI/pre设置Employee/submitTask 3 Step 3 前置 A-0 外呼实例 获取 /AI/outBound/describeInstance 4 Step 3 前置 A-1 号码池 获取 /AI/outBound/callerNumber/列出 5 Step 3 前置 A-2 场景库 POST /AI/outBound/列出Scripts 6 Step 3 前置 B0 邮箱绑定检查 获取 /AI/emAIlconfig/列出?pageSize=1000&pageNum=1&状态=1 7 Step 3 前置 B 用户 性能分析 获取 /AI/user/性能分析 8 Step 3 前置 D-1 短信模板列表 获取 /AI/sms/查询SmsTemplate列出?pageNum=1&pageSize=20&pageNumber=1 9 Step 3 前置 E-1 TikTok 账号列表 获取 /AI/authaccount/列出?pageNum=1&pageSize=999&平台=1&状态=1 10 Step 3 前置 E-2 TikTok 账号权限 获取 /AI/auth/tiktok/获取创建器信息?authAccountId={id} 11 Step 3 前置 E-3 视频模型列表 POST /AI/consumeSource/列出?pageNum=1&pageSize=999 12 Step 5-A AIWa 客户池详情 POST /AI/pre设置Employee/获取CustomerPoolDetAIl?pageNum=1&pageSize=10 13 Step 5-B-1 Frank 邮件统计 获取 /AI/emAIl/获取TaskEmAIlCount?taskId={frankDagTaskId} 14 Step 5-B-2 Frank 邮件列表 获取 /AI/emAIl/task列出?pageNum=1&pageSize=2000&taskId={frankDagTaskId} 15 Step 5-C-1 Fran 电话统计 获取 /AI/pre设置Employee/collaborationTaskStatistics?taskId={franDagTaskId}&customerPoolId={franCustomerPoolId} 16 Step 5-C-2 Fran 电话详情 POST /AI/pre设置Employee/collaborationCall结果?pageNum=1&pageSize=10 17 Step 5-D-1 Lisa 短信统计 POST /AI/sms/获取TaskSmsCount 18 Step 5-D-2 Lisa 短信详情 POST /AI/sms/获取Sms结果列出?pageNum=1&pageSize=10 19 Step 5-E-1 Toby 视频统计 获取 /AI/data/count?taskId={tobyDagTaskId}&customerPoolId={tobyCustomerPoolId}&平台=1 20 Step 5-E-2 Toby 视频列表 获取 /AI/data/列出?pageNum=1&pageSize=10&taskId={tobyDagTaskId}&customerPoolId={tobyCustomerPoolId}&平台=1

🔁 本清单与下文各 Step 中"接口："标注的路径完全一致。如发现两处不一致，以下文 Step 中的标注为准（本清单仅为快速比对索引），同时立即向用户报告该不一致以便修正。

🛡️ 双轨强约束（本文档 + 代码）

上述清单同时存在于 scripts/API_paths.py，构成"双轨强约束"：

LLM 直接发请求时（curl/工具调用）： 必须对照本文档清单逐字符比对路径。 脚本调用 API 时（如 submit_task.py）： 严禁脚本内硬编码 URL，必须从 API_paths.py 通过 build_url("xxx") 获取，并配合 assert_url_matches() 自检。 新增/修改接口的强制流程： 先改 技能.md 这张表 → 再改 API_paths.py → 然后才能在脚本里使用；遗漏任一步即视为 bug。 漂移检测： 运行 python scripts/API_paths.py 会扫描本文件中所有 https://AI.deepsop.com/prod-API/... 路径，若有未在 API_paths.py 登记的项目则非零退出。该命令应在每次修改路径后执行一次自检。 完整执行流程 Step 0：触发类型判断（每次进入技能必须首先执行）

检查当前输入内容是否包含 [DeepSOP-Auto查询] 标记：

包含该标记：这是 cron 定时回调。**不得询问用户是否继续，不得等待确认，不得说「我将开始查询」。立即从输入文本中解析变量（taskId、AIwaDagTaskId、AIwaCustomerPoolId、frankDagTaskId、franDagTaskId、franCustomerPoolId、lisaDagTaskId、lisaCustomerPoolId、tobyDagTaskId、tobyCustomerPoolId、taskName、totalTar获取、employee列出、feishuChatId），跳过 Step 1～4 直接执行 Step 5 的全部内容（查询接口 → 生成 xlsx → 发送文件 → 回复文字摘要），直到所有参与员工的结果都处理完毕。 不包含该标记：这是用户主动指令，继续执行 Step 1。 Step 1：第一轮 AI 分析（任务拆解）

用以下 prompt 分析用户指令，严格返回 JSON，不含任何额外文字：

根据【指令】描述，Json格式返回数据 不需要多余的描述，不要过度解读，没有提及的内容请不要擅自理解，识别结果除了Json数据其他文字不要出现 规则如下：{ "taskName": "根据描述总结出一个简洁的任务名称" "executionMode": "判断描述中是否明确提及每日/每天/周期性，如果提及则返回周期性任务，未提及则返回定额任务" "totalTar获取": "提取描述中提及的数量（无单位纯数字）" "employee列出": "首先将描述按逗号、顿号等分隔符拆分成多个子任务，然后为每个子任务匹配对应员工： - 挖掘客户