| name | CRM 综合能力演示 |
| description | CRM 数据查询、统计分析、歧义处理、数据操作（周报生成→信息抽取→客户录入→商机任务创建）、结构化本体创建与视图、非结构化本体管理的综合演示。Use this skill whenever the user mentions CRM 演示、百应数据查询、客户查询、商机统计、项目管理、本体对象、视图管理、新手引导、产品演示、产品理念，or asks「什么是对象/视图」「查询快在哪里」「本体解决了什么问题」「结构化+非结构化融合」「多跳数据查询」「数据安全怎么做」「解决口语表达的歧义」— even if they don't say "演示" explicitly. |
| allowed-tools | baiying_call, Bash |
CRM 综合能力演示
核心原则：按用户要求逐项演示，不一次做完所有项。全部使用简体中文。
执行路线图
Agent 打开本文件后，先根据用户意图匹配下表，找到对应的演示项和工具。
| 序号 | 演示项 | 说明 |
|---|
| 1 | 数据查询 | 自然语言到结构化数据，一句话问到数据无需 SQL |
| 2 | 数据统计 | 聚合、排序、分组 — 不需要写函数，说出来就行 |
| 3 | 歧义处理 | 能确定的不问，不确定的要问 — 智能消歧义 |
| 4 | 数据操作 | 非结构化文本进去，结构化数据出来，中间有人确认 |
| 5 | 结构化本体 | 自己建模自己查询 — 对象即表、视图即关联、挂载即生效 |
| 6 | 非结构化本体 | 给文档打上结构化标签，检索就像查数据库一样精准 |
用户说"新手引导""给我演示一下"时，先列出全部能力清单等用户回应再继续。
环境准备（一次性，所有演示通用）
Agent 收到演示请求后，先判断环境是否就绪。就绪标准：
- venv 存在：
/tmp/ont_env/bin/python 文件存在且可 import by-datacloud
- 本体已挂载：
list_mounted_resources.py 返回的 data 数组中至少有一条 VIEW 或 OBJECT 记录
两个条件都满足 → 直接开始演示。任一不满足 → 按以下步骤准备。
Step 1：安装 Python 环境
bash scripts/setup.sh
幂等，已安装则跳过。完成后 /tmp/ont_env/bin/python 可用，by-datacloud 和 by-framework 可导入。
Step 2：挂载视图（仅在未挂载时执行）
先执行 list_mounted_resources.py 检查是否已有 scene_sales_management：
/tmp/ont_env/bin/python scripts/ontology/structured/list_mounted_resources.py \
'{"resource_id": <Agent的数字后缀>}'
- 已存在 → 跳过挂载，直接开始演示（无需等待）
- 不存在 → 执行挂载：
/tmp/ont_env/bin/python scripts/ontology/structured/mount_resource.py \
'{"agent_id": <Agent编码的数字后缀>, "resource_code": "scene_sales_management"}'
agent_id 从 Agent 编码中提取数字后缀（如 agent-10014603 → 10014603）。
Step 3：验证挂载生效（仅首次挂载后需要）
首次挂载后 baiying_call 不会立即可用。必须结束本轮，等待用户下一轮输入后生效。
回复话术："好的，我先准备一下演示环境～ 马上开始！"
下一轮收到用户输入后，再次执行 list_mounted_resources.py 确认挂载成功 → 环境就绪，开始演示。
演示通用规则
各 demo 子文件中不再重复以下规则：
resource_id 获取
baiying_call 的 resource_id 是数字型 ID，通过 list_mounted_resources.py 运行时动态获取，不可硬编码：
/tmp/ont_env/bin/python scripts/ontology/structured/list_mounted_resources.py \
'{"resource_id": <Agent的resource_id>, "keyword": "<中文名称>"}'
从返回 JSON 的 data 数组中提取数字 resourceId。各 demo 步骤中注明了对应的 keyword。
resource_type
baiying_call 必须指定 resource_type：VIEW（查询）或 OBJECT（写入），必须大写。
挂载生命周期
演示 5/6 中创建的视图/对象挂载后，属于非首次挂载，无需结束本轮等待生效。规则同上 Step 3。
Python 环境详情见 Python 环境搭建。
baiying_call 工具
baiying_call 是 MCP 工具，挂载资源后才在工具列表中可见。未挂载时调用会直接不可用。
| 参数 | 说明 |
|---|
resource_id | 数字型 ID，不同资源 ID 不同。通过 list_mounted_resources.py（查询已挂载资源）获取，不可硬编码 |
resource_type | VIEW（查询）或 OBJECT（写入），必须大写 |
query | 自然语言，用户想做什么就写什么 |
获取 resource_id：执行 list_mounted_resources.py。不传参数默认查全部（个人+企业、OBJECT+VIEW）。可按 keyword 中文名称筛选，从返回结果中获取数字 resourceId。
挂载生命周期
挂载视图后 不会立即生效——需要用户下一轮输入后，baiying_call 才会出现在工具列表中。
标准处理流程：
收到用户请求
↓
尝试调用 baiying_call
├── ✅ 成功 → 返回结果，继续
└── ❌ 工具不可用 / 404
↓
执行 mount_resource.py 挂载 scene_sales_management
↓
用自然语言结束本轮，**不要要求用户重复已说过的需求**。
根据场景选择话术：
通用：
"我来准备一下数据环境～ 好了！"
"稍等，我先加载数据～ 好了，继续！"
新手引导（用户刚说"给我演示一下"）：
"好的，我先准备一下演示环境～ 马上开始！"
中途挂载（正在演示中遇到 404）：
"稍等，数据连接需要刷新一下～ 好了！"
↓
⚠️ 必须结束当前轮次，等待用户下一轮输入
↓
下一轮 → baiying_call 已可用 → 继续执行用户原请求
（Agent 需记住上一轮用户需求，不要让人重复）
关键规则：挂载回复 禁止 包含提问句式（"你想查什么？""请再说一次？"）——Agent 已知道用户要什么，下一轮直接执行即可。
常见演示场景
Agent 根据用户问题匹配下表，找到对应场景，打开链接文件按步骤执行。
场景 3-8 依赖已完成的前置演示。如果用户直接问但还没演示过，先执行场景 1（全量演示），演示结束后再回答。
详细话术和时间分配见 演示场景指南。
故障排查
仅在 baiying_call 调用失败或演示 4/5/6 遇到脚本错误时才需阅读本节。正常演示流程不需要。
常见错误速查
| 现象 | 原因 | 处理 |
|---|
baiying_call 工具不在列表中 / 404 | 视图未挂载 | 执行下方「挂载视图」→ 自然引导用户继续对话 → 结束本轮（下一轮生效） |
baiying_call 超时 | 后端未响应 | 等 30s 后重试一次 |
baiying_call 返回权限错误 | 视图未授权 | 执行下方「挂载视图」→ 结束本轮等待生效 |
| Python import 失败 | 环境未搭建 | 执行 bash scripts/setup.sh |
| 脚本执行报错 | 环境变量缺失 | 执行 bash scripts/check_env.sh 检查 |
检查视图挂载状态
/tmp/ont_env/bin/python scripts/ontology/structured/list_mounted_resources.py \
'{"resource_id": <Agent的resource_id>}'
挂载视图
/tmp/ont_env/bin/python scripts/ontology/structured/mount_resource.py \
'{"agent_id": <Agent 编码里的数字后缀>, "resource_code": "scene_sales_management"}'
list_mounted_resources.py 用于检查某资源是否已挂载到当前 Agent。
脚本路径速查
演示 4/5/6 涉及以下脚本（相对于 skill 根目录，通过 /tmp/ont_env/bin/python 执行）：
| 脚本 | 用途 |
|---|
scripts/ontology/structured/list_mounted_resources.py | 查询 Agent 已挂载的资源 |
scripts/ontology/structured/create_object.py | 创建结构化对象（collect → submit） |
scripts/ontology/structured/create_view.py | 创建本体视图 |
scripts/ontology/structured/delete_object.py | 删除结构化对象 |
scripts/ontology/structured/delete_view.py | 删除本体视图 |
scripts/ontology/structured/mount_resource.py | 挂载视图到当前 Agent |
scripts/ontology/structured/list_term_types.py | 查询可绑定的术语类型 |
scripts/ontology/structured/get_term_type_values.py | 查询术语类型的值列表 |
scripts/ontology/unstructured/list_knowledge_bases.py | 查询可用知识库 |
scripts/ontology/unstructured/list_kb_directories.py | 查询知识库目录 |
scripts/ontology/unstructured/create_object.py | 创建非结构化对象（collect → submit） |
scripts/ontology/unstructured/delete_object.py | 删除非结构化对象 |
scripts/ontology/unstructured/mount_resource.py | 挂载非结构化对象到 Agent |
scripts/ontology/unstructured/list_mounted_resources.py | 查询 Agent 已挂载的非结构化对象 |
scripts/meeting-minutes/generate_meeting_minutes.py | 生成模拟会议纪要 |
scripts/weekly-report/generate_weekly_report.py | 生成模拟周报 |
参考文档
