支道平台数据查询

Overview

本技能用于查询支道（Zhidao）低代码平台上的业务数据与知识，覆盖三类需求：

核心依赖 6 个支道 MCP 工具（均为 deferred 工具，首次使用前需先通过 ToolSearch 加载 schema）：

触发场景

• 用户提到支道/表单数据并要求「查询、查看、统计、汇总、筛选、列表、明细、透视表、分组」等
• 用户给出字段名，要求看数据、做聚合、或按条件筛选记录
• 用户询问行业知识、业务规范、操作指南、产品说明、常见问题

路由决策（第一步，务必先判断）

根据用户问题关键词判断走哪条路径：

判断口诀：
- 问「总数/合计/分布/占比」→ 透视
- 问「具体记录/都有哪些/明细」→ 明细
- 问「是什么/怎么做/规范/说明」→ 知识库

若用户一句话里同时要「明细 + 汇总」，可两条路径都走：先用透视出汇总，再用明细出列表。

若用户问题模糊（如"产品X怎么样"），先尝试知识库检索，无结果再提示用户是否需要查表单数据。

路径 C：知识库问答（get_company_knowledge + search_knowledge）

Step C1 — 获取企业知识库列表

调用 get_company_knowledge，获取当前企业绑定的所有知识库信息：

• 返回知识库列表，每项包含 resourceId（知识库ID）、name（名称）、description（描述）、docCount（文档数量）等
• 根据用户问题上下文，选择合适的知识库：
• 若用户明确指定知识库名称，匹配对应 resourceId
• 若问题涉及特定领域（如"产品说明"、"操作规范"），根据知识库描述选择最相关的
• 若只有一个知识库，直接使用
• 若无法确定，向用户展示可用知识库列表，请用户选择

Step C2 — 语义检索

调用 search_knowledge，参数：

• query：用户问题文本（最大 8000 字符）
• resourceId：从 Step C1 选定的知识库ID（必填）
• limit：返回最相关的K个片段，默认 10，范围 [1, 100]
• denseWeight：混合检索中稠密向量权重，默认 0.5（0.2-1，1=纯语义，0=纯字面）
• enableRerank：是否开启重排，默认 false
• rerankModel：重排模型，默认 base-multilingual-rerank
• enableRewrite：是否对 query 进行改写（基于历史对话），默认 false

推荐配置：
- 一般问答：limit=10, enableRerank=true
- 复杂问题：limit=20, enableRerank=true, denseWeight=0.7

Step C3 — 生成回答

基于检索到的文档片段生成回答，遵循以下原则：

1. 基于检索结果：回答必须基于检索到的文档内容，不能凭空编造
2. 引用来源：回答中应标注信息来源（如"根据文档《XXX》"）
3. 结构化输出：如果检索结果包含多个要点，用列表或分点说明
4. 诚实标注：如果检索结果不足以回答问题，明确告知用户"未找到相关信息"

回答模板：

根据知识库检索结果：

**[要点1]**
- 内容...
- 来源：《文档A》

**[要点2]**
- 内容...
- 来源：《文档B》

---
如果以上信息未能解答您的问题，建议联系相关部门或查阅更详细的文档。

公共步骤（路径 A/B 共用）

Step 1 — 定位表单

调用 search_form，用业务关键字模糊搜索（如「产品」），从返回的 data[].appName 中匹配目标表单，取 appId（Long，须以字符串传入避免精度丢失）。

• 若返回多个候选，先根据用户提到的字段名判断哪张表匹配；拿不准时用 get_form_schema 核对字段再定。

Step 2 — 获取字段定义

调用 get_form_schema，传入 appId。从 data[] 提取字段：

• 顶层元素可能为 group（分组），真实字段藏在 childFieldList[] 里，需递归展开。
• 记录每个字段的 fieldId、fieldName、compType（textarea/number/singleSelect/date 等）。
• 后续查询条件、维度、指标中必须使用 fieldId，不能用字段名。

路径 A：透视统计（query_form_pivot）

Step A3 — 构建透视查询

调用 query_form_pivot，参数：

• appId：字符串表单 ID
• xFields：行维度数组，元素 {fieldId, fieldName, compType}
• yFields：列维度数组（可选，为空则只按行维度分组）
• metrics：指标数组，元素 {fieldId, fieldName, compType, op}
• filters：可选过滤条件，元素 {fieldId, compType, method, value}

聚合类型 op：3=去重计数, 4=求和, 5=最大值, 6=最小值, 7=平均值, 8=计数。

Step A4 — 整理并展示

返回 Markdown 表格，整理成透视表：补「合计」行/列，标注空值（如「无规格/空白」），核对全表合计与各分项之和一致，最后用结构化中文输出。

路径 B：明细查询（query_form_data）

Step B3 — 构建明细查询

调用 query_form_data，参数：

• appId：字符串表单 ID
• conditions：JSON 字符串（conditionGroupList 格式），为空则查全部。示例：

[{"conditionLinkType":"and","conditionList":[{"method":"eq","methodType":1,"fieldId":"fd_1695286293183","compType":"textarea","value":"笔记本"}]}]

• page / pageSize：分页，pageSize 默认 100。数据量大时需翻页拉全。

method 操作符：eq(等于) / ne(不等于) / empty(为空) / not_empty(不为空) / like(包含) / unlike(不包含) / gt / gte / lt / lte / in(传数组) / notin / all / between(传数组 [min,max]) / included / scope。

Step B4 — 整理并展示

返回分页明细记录。整理成表格列出关键字段，说明总条数、分页情况；字段较多时只展示用户关心的列，其余省略或补充说明。

关键规则

1. 字段 ID 来自 schema：所有 fieldId 必须来自 get_form_schema 结果，禁止臆造。
2. ID 用字符串：appId、companyId 等 Long 型一律字符串传参，避免精度丢失。
3. group 展开：字段常嵌套在 group.childFieldList 下，需递归查找，勿把 group 本身当字段。
4. 聚合优先：统计/汇总/分组类走 query_form_pivot；只有「看明细/单条/筛选列出」才走 query_form_data。
5. 先路由后查询：拿到字段前，先根据用户问法确定走 A/B/C 哪条路径，避免用错工具反复试。
6. 知识库问答基于检索结果：回答必须基于 search_knowledge 返回的文档片段，不能凭空编造；检索无结果时诚实告知用户。

参考

• references/mcp-tools-reference.md：5 个 MCP 工具完整参数、op 聚合码、filter/conditions 操作符、透视/明细/知识库三套完整调用示例。
• references/kb_config.json：企业-知识库ID映射配置（可选，用于知识库问答时自动确定 resourceId）