task-management

# 销售任务管理 Skill ## 1. Description 这是一个销售任务管理技能，用于帮助销售人员管理客户跟进任务。支持以下操作： - **查询任务**：查询指定销售和客户的任务列表，支持按日期筛选 - **创建任务**：为销售人员创建新的客户跟进任务 - **更新任务**：修改已有任务的标题、内容或时间 - **删除任务**：根据任务 ID 删除一个或多个任务 后端 API 地址：`https://iautomark.sdm.qq.com/ai-assistant` ## 2. When to use - 用户说："帮我查一下销售 XXX 的任务" - 用户说："查看客户 XXX 今天的跟进任务" - 用户说："帮我创建一个任务，明天下午3点跟进客户" - 用户说："新建一个任务提醒我联系客户" - 用户说："把任务 123 的时间改成后天上午10点" - 用户说："更新任务标题为..." - 用户说："删除任务 456" - 用户说："批量删除任务 1,2,3" - 用户提到"日程"、"任务"、"跟进"、"提醒"等与销售任务相关的关键词 ## 3. How to use ### 3.1 查询任务 (list_tasks) 从用户消息中提取参数，调用 `agent.py` 中的 `list_tasks` 函数： - `sale_id`（必填）：销售人员 ID - `external_id`（可选）：客户 ID。不传则查询该销售的所有任务 - `task_date`（可选）：指定日期，格式为 `yyyy-MM-dd` 返回任务列表，包含任务 ID、标题、详情、时间、目标客户昵称。 ### 3.2 创建任务 (create_task) 从用户消息中提取参数，调用 `agent.py` 中的 `create_task` 函数： - `sale_id`（必填）：销售人员 ID - `external_id`（必填）：客户 ID - `title`（必填）：任务标题 - `content`（必填）：任务内容 - `task_time`（必填）：任务时间，格式为 `yyyy-MM-dd HH:mm` - `sop_id`（可选）：SOP ID，格式为 `sopId` 或 `sopId-groupId` ### 3.3 更新任务 (update_task) 使用前需已知任务的详情信息（建议先查询）。调用 `agent.py` 中的 `update_task` 函数： - `sale_id`（必填）：销售人员 ID - `task_id`（必填）：任务 ID（数字） - `title`（可选）：新的任务标题 - `content`（可选）：新的任务内容 - `task_time`（可选）：新的任务时间，格式为 `yyyy-MM-dd HH:mm` ### 3.4 删除任务 (delete_task) 调用 `agent.py` 中的 `delete_task` 函数： - `task_ids`（必填）：要删除的任务 ID，多个用逗号分隔，如 `"1,2,3"` ## 4. Implementation - 核心文件：`agent.py` - 依赖库：`aiohttp`（异步 HTTP 请求） - 后端 API 基础地址：`https://iautomark.sdm.qq.com/ai-assistant` - 接口列表： - `POST /v1/task/getMyTask` - 查询任务 - `POST /v1/task/create` - 创建任务 - `POST /v1/task/updateMyTask` - 更新任务 - `POST /v1/task/deleteMyTask` - 删除任务 - 时间格式：`yyyy-MM-dd HH:mm`（上海时区） ## 5. Edge cases - 时间格式不正确：提示用户使用 `yyyy-MM-dd HH:mm` 格式 - 未提供必填参数：提示用户补充 - 查询无结果：告知用户没有找到匹配的任务 - API 请求失败：返回错误信息，建议用户重试 - 删除部分失败：返回失败的任务 ID 列表 - 更新任务前建议先查询确认任务存在