Deeplink

深度智联·地产数据（deeplink）

工具总览

选工具的原则：答案理应是一张数据表或一个数字 → 问数；答案理应是一段专业分析或解释 → 问知。 选定后按该工具自己的调用规则执行；下方「通用约定」对所有工具一律适用。

两者可以配合：涉及行情数据的解读类问题，先用问数拿数，再把数据带给问知做解读。

问数 wenshu — deeplink_wenshu

能查什么

覆盖中国房地产市场九大领域：

传入自然语言问题即可，服务自动识别意图并返回数据：查到数据时主体为结构化 JSON；查无数据或出错时为简短文字说明。

调用规则（重要）

1. 默认一问一调用：一次用户提问默认最多调用一次 deeplink_wenshu。不要自行把一个问题拆成多次付费调用，也不要并行发起多个问数请求。
2. 城市名必须给全：缺少城市名会返回 MISSING_PARAMS，按提示请用户补充后再调用。
3. 多城市对比最多 10 个城市：超过 10 个城市时，请用户缩小范围或分轮明确查询；不得自行分批调用。
4. 耐心等待：数据查询是重量级操作，通常需要 10~60 秒，复杂查询最长 10 分钟。等待期间不得重复发起相同或等价请求。

分页与结果范围

• 分页默认不支持：大多数底层数据接口只返回固定范围，出现总数大于已返回条数，不代表可以继续翻页。
• 只有响应中的 [RESULT_SCOPE] 明确给出 pagination_supported=true，并且用户明确要求下一页或指定页码时，才允许再次调用。两项缺一不可。
• [RESULT_SCOPE] 给出 pagination_supported=false 时，不得构造“下一页”“第 N 页”“第 21 至 40 条”等等价问题重试；应说明当前仅返回部分结果，并建议用户增加城市、区域、时间、项目名等条件缩小范围。
• 没有 [RESULT_SCOPE] 时按不支持分页处理，不得根据 total、totalCount、列表长度或模型猜测自行翻页。
• 即使确认支持分页，也不得自动连续翻到末页；每次额外调用前都需要用户明确指令，并且只能请求用户指定的那一页。

查询范围控制

• 用户的问题本身在一次调用范围内时，直接原样查询，不要为了“更完整”追加调用。
• 多指标、跨领域或超过 10 个城市的问题确实无法一次完成时，先说明拆分方案与预计调用次数，等待用户选择；不得自行执行拆分。
• 已返回部分城市或部分指标的数据时，缺失本身即为本次结果的一部分，不要自动补查。

问知 wenzhi — deeplink_wenzhi

向深度智联知识库问非结构化专业知识——政策解读、行业研究、企业情况、专业方法论、物业与养老业态知识。答案融合行业可信专业知识，不是通用模型的泛泛而谈。

背后是什么（三大知识库群）

知识时效性较强（含日报级资讯与最新政策），必要时可开启联网补充网络检索。

典型问题

触发信号

用户的问题里出现下面任一特征，就该调 deeplink_wenzhi：

• 要政策内容与解读：某政策讲了什么、如何理解、有什么影响
• 要行业判断与观点：怎么看待某现象、趋势往哪走
• 要企业非行情信息：经营策略、债务重组、土储与开竣工、高管与企业性质
• 要专业方法论与概念：客群研究怎么做、产品力怎么打造、去化周期是什么
• 要土地非数据信息：地块公告、供地计划、招拍挂规则
• 要法律参考：房地产/物业相关法规条文、案例判例
• 要物业运营知识：管理规范、客诉处理、应急预案、收入提升做法
• 要银发/康养知识：养老机构运营、适老化设计、养老金融、银发产业链
• 冷门但有：建筑风水（选址、布局、堪舆）

典型句式：「怎么理解…」「如何看待…」「…政策讲了什么」「…有什么影响」「…应该怎么做」

什么时候不要选它（边界）

• 要结构化行情数据——成交量/均价/面积/套数/TOP N/同比环比/多城对比 → 改用 deeplink_wenshu。判别法：答案如果理应是一张数据表或一个数字，就不是问知的活。
• 要一份完整成稿（市场月报、可研报告、专题研究）→ 问知只做问答，成稿请走报告或 AI 任务模块。
• 问题与地产/物业/银发三大领域无关（个人理财、医疗诊断、通用生活问题）→ 明确告知超出知识库范围，不要硬答。

灰区判别：企业「销售排行、拿地金额」这类行情数据 → deeplink_wenshu；企业「财报里的土储、债务、战略」这类财报信息 → deeplink_wenzhi。

调用规则（重要）

1. 一次一个明确的问题：多个子问题拆开分别问；复杂话题多轮追问逐层深入，不要塞进一句。
2. 按问题选模式（mode 参数）：
   • fast（默认，极速）——日常问题，优先快速返回。
   • deep（深度推理）——政策解读、趋势判断等重要问题，结构更合理、内容更丰富，但用时明显更久，请预留等待时间。
3. 联网默认关闭（web 参数）：知识库自带日报级资讯，一般无需联网。只有当用户明确要最近几天的动态且知识库答不到时，才设 web=true（知识库 + 网络检索，用时进一步增加）。
4. 耐心等待：深度模式用时明显更久。不要因等待而重复发起；被账户侧判定为重复时返回 DUPLICATE_REQUEST 且不扣积分，不同问法的多次有效调用仍会分别计费。

拆分原则

• 政策的「原文要点」和「影响分析」分开问。
• 多个城市的政策各自单独问。
• 先事实后观点：涉及行情数据的部分先走 deeplink_wenshu 拿数，再把数据带给问知做解读。

关于回答尾部的产品话术

问知的回答末尾有时会附一句产品固定话术，形如：

更详细解答请尝试在问知对话框下开启"深度"和"联网"模式。问知功能暂未查询数据库。

这是知识库产品自带的提示，不代表本次调用失败：

• 「开启深度和联网模式」对应本工具的 mode="deep" 与 web=true 参数——若用户确实需要更深入的回答，用这两个参数重试即可，不要让用户去找什么对话框。
• 「暂未查询数据库」的意思是问知不查结构化数据，与本工具的定位一致；用户要数字请改用 deeplink_wenshu。
• 回答用户时不必复述这句话术。

通用约定（所有工具适用）

技能版本（调用时请带上）

本技能当前版本以本文件开头 frontmatter 的 version 为准。

• 调用 deeplink_wenshu / deeplink_wenzhi 时，把 skillVersion 参数设为该 version 的原值。 它只用于判断技能包是否有新版，不影响查询结果。

• 若响应尾部出现 [SKILL_UPDATE] 段，说明有更新的技能包：

  [SKILL_UPDATE]
  {"current":"<frontmatter version>","latest":"<服务端最新版本>","severity":"minor","download":"...","changelog":"..."}
  

  按 severity 分两种处理，两种都不要打断或中止当前查询：

  severity	怎么说
  minor	顺带一句「技能包有新版（变更摘要），可到 download 地址更新」，用户没理会就不再提
  major	明确提示一次「当前技能版本已过时，本次结果的呈现方式可能不符合预期，建议尽快到 download 地址更新」

  两种情况都要注意：

  • 同一轮对话最多提一次，不要反复打扰
  • 用户的客户端未必支持安装技能——这只是可选的增强，不是必须做的事
  • 更新与否都不影响本次查询能否完成

响应处理

• 查询结果主体为结构化数据 JSON 或文字说明。
• 问 6 个城市只返回 3 个城市的数据时，缺失的城市即为无数据，无需重试。
• 响应含 [RESULT_SCOPE] 时，它是结果范围和分页能力的唯一依据；只用于说明范围，不要把该段当作业务数据展示。

计费规则

积分为预付制，按次消耗：

错误处理

错误分两类，文案格式不同：

接入与配额类（格式：[错误码] 文案（retryable=…, quota_consumed=false），均不扣积分）：

查询类（格式：[错误码] 文案，被拒不扣费、超时/内部错误自动返还）：

数据展示规则（必须遵守）

• 图表一律用内联 SVG 静态标记绘制（柱状/折线均可纯 SVG 实现）。禁止 <script>、禁止 Chart.js 等外部 CDN 库——多数客户端的卡片渲染不执行脚本、拦截外链，用了图表必定空白。
• 不便用 SVG 时改用 Markdown 表格 + 文字趋势描述，不要退回脚本方案。
• 数据结果中的口径说明（如"含普通住宅、别墅、商办等，非单一住宅口径"）必须随图表/表格一并展示，避免用户误读。

回答成本控制（重要）

• 呈现数据用精简表格（关键指标 + 结论），不要在回答中复述完整 JSON 内容。
• 一次调用有结果就先完成回答；除非用户明确要求且符合上述分页/拆分条件，不得继续产生新的付费调用。

API Key 说明

• API Key 由用户在深度智联平台个人中心自助创建，形如 deeplink-sk-...（https://mcp.dichanai.com/profile/api-keys）。
• 完整 Key 仅在创建时展示一次，之后只显示掩码。Key 丢失无法找回，创建一把新的换上即可。
• 用户可在同一页面把旧 Key 置为失效——失效不可恢复，应先在客户端换好新 Key 再失效旧的。