熵基知识库客服助手（zkteco-knowledge-base）
面向客服、售前、集成方的傻瓜式工具：描述问题 → 自动路由到对应产品线知识库 → 返回可直接转述的答案。
一、怎么用（3 步）
- 直接描述问题，例如："V6600 考勤模块怎么加人员？"、"ZKTime5.0 报表怎么导出？"、"停车设备支持哪些车牌识别相机？" —— 不需要指定任何技术细节。
- 本 skill 自动判断问题属于哪条产品线，调用对应的知识库工具查询。
- 按下方"回答模板"输出答案（含出处），可直接转发给客户。
二、路由表（核心，记住"查什么 → 用哪个工具"）
| 产品线 | 要调用的工具名（ToolSearch 加载后调用） |
|---|---|
| 门禁 / 梯控硬件 | mcp__门禁梯控设备知识库__Access-control_and_elevator-control_products |
| 门禁软件 ZKAccess 3.5 | mcp__门禁软件ZKAccess35知识库__zkaccess3.5_stand-alone_version_access-control_software |
| 通道闸机 | mcp__通道闸机知识库__Channel_device_products |
| 安检设备 | mcp__安检设备知识库__SecurityCheck_device_products |
| 考勤硬件 | mcp__考勤设备知识库__Attendance_device_product |
| 云考勤 | mcp__云考勤知识库__Cloud_Attendance_Product-Line |
| 考勤软件 ZKTime 5.0 | mcp__考勤软件ZKTime50知识库__ZKtime5.0_Standalone_Attendance_Management_Software |
| EcoPro 云办公 | mcp__EcoPro云办公知识库__ecopro_software_product |
| 人证核验 | mcp__人证核验知识库__Personnel-verification_device_products |
| 智能视频 | mcp__智能视频知识库__Intelligent_video_products |
| 消费硬件 | mcp__消费设备知识库__Consumer_device_products |
| 单机消费 ePOS | mcp__单机消费ePOS知识库__ZKepos_Standalone_Consumption_Software |
| 停车管理 | mcp__停车管理知识库__park_device_products |
| 万傲瑞达 V6600 平台 | mcp__万傲瑞达V6600平台知识库__V6600_software_product |
| 熵基云联 | mcp__熵基云联知识库__zkteco_Cloud_Link |
| 熵基互联 | mcp__熵基互联知识库__zkteco_Interconnected_product_line |
| 外协生态 | mcp__外协生态知识库__Outsourced_Ecological_Product-Line |
> 工具名即每个知识库 MCP 暴露的查询函数，统一接收 ques 参数（自然语言问题）。详细场景映射见 references/01-知识库路由表.md。
三、调用规范
- 用
ToolSearch加载工具 schema：tool_names: ["mcp__{server}__{resource}"]。 - 用
DeferExecuteTool调用，参数为{"ques": "用户的原始问题"}：
DeferExecuteTool(toolName="mcp__万傲瑞达V6600平台知识库__V6600_software_product", params={"ques": "V6600 考勤模块怎么加人员"}) - 个别工具 schema 若有差异，以
ToolSearch加载到的实际参数为准（字段名大概率仍是ques）。
四、回答模板（客服可直接转述）
结论：<一句话回答>
详情：<2-4 条要点，口语化>
出处：<来源产品线知识库>（如「万傲瑞达V6600平台知识库」）
若知识库返回为空或含糊，如实告知并引导用户补充：设备型号 / 软件版本 / 报错现象。
五、快速定位问题（速查，完整版见 references/03）
| 现象 | 处理 |
|---|---|
| 工具搜不到 / 报"not found" | 该 MCP 未信任或未启用 → 见 references/02 配置指南 |
| 返回空结果 | 换关键词重问；确认产品线归属；转用对应专用 skill |
| 网络错误 / 超时 | 检查 zktecowebui.com 可达性；稍后重试 |
| 问题跨多条产品线 | 并行调用多个工具后综合回答 |
| 涉及 API/协议对接 | 改用专用 skill（如 v6600-api-reference、zkteco-push-protocol、consume-device-api） |
六、无 MCP 时的兜底路径
下载本 skill 但未配置 MCP 时：按 references/02-MCP配置指南.md 自助添加 17 个知识库 MCP（跨电脑通用版，不依赖用户名/系统/安装路径，任何电脑 5 分钟内可完成）；配置前可先依赖各专用对接 skill 或官方文档回答问题。
七、文件结构
references/01-知识库路由表.md— 18 条产品线 × 场景 × 工具 × URL 全量映射references/02-MCP配置指南.md— 第三方自助接入指南（含全部 MCP URL 清单）references/03-常见问题快速定位.md— 客服 FAQ / 排障手册
