deeplink

---
name: deeplink
version: "3.0.0"
description: 深度智联提供的地产 AI 数据服务——「问数」使用经克而瑞授权的中国房地产结构化数据（新房、二手房、土地、企业、宏观、长租公寓、产城、康养、商办九大领域）；「问知」查地产/物业/银发三大领域专业知识库（政策解读、行业研究、企业财报、法规判例、运营方法论）。自然语言提问，按次消耗预付积分。
---

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

## 工具总览

| 工具 | 能力 | 什么时候用 |
|------|------|-----------|
| `deeplink_wenshu` | **问数（wenshu）**——深度智联房地产市场数据查询（数据源获克而瑞授权） | 用户要具体数字、排行、走势、城市间对比 |
| `deeplink_wenzhi` | **问知（wenzhi）**——地产/物业/银发专业知识库问答 | 用户要政策解读、行业观点、方法论、法规判例、运营知识 |

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

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

---

# 问数 wenshu — `deeplink_wenshu`

## 能查什么

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

| 领域 | 典型问题 |
|------|---------|
| 新房 | 上海最近一个月新房成交面积/金额/套数 |
| 二手房 | 北京二手房挂牌均价走势 |
| 土地 | 杭州今年土地成交 TOP10 地块 |
| 企业 | 某房企在重点城市的成交排行 |
| 宏观 | 城市 GDP、人口、居民收入等宏观指标 |
| 长租公寓 | 城市集中式公寓租金水平；个人房东直租小区的租金与挂牌套数 |
| 产城 | 产业园区市场数据 |
| 康养 | 康养项目、床位、入住率 |
| 商办 | 写字楼/商铺市场行情 |

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

<!-- BEGIN SHARED: wenshu-call-policy -->
## 调用规则（重要）

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 个城市的问题确实无法一次完成时，先说明拆分方案与预计调用次数，等待用户选择；不得自行执行拆分。
- 已返回部分城市或部分指标的数据时，缺失本身即为本次结果的一部分，不要自动补查。
<!-- END SHARED: wenshu-call-policy -->

---

# 问知 wenzhi — `deeplink_wenzhi`

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

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

| 知识库群 | 覆盖内容 |
|------|---------|
| 地产 | 中央及地方政策规章、国土空间规划、克而瑞研究报告、券商月度市场研报、宏观统计数据及解读、中国房地产年鉴、企业财报/业绩公告/高管信息、土地知识（地块、供地计划、招拍挂公告）、房地产项目信息、住宅产品设计、项目品牌营销、购房客群研究、法律法规与判例、经纪行业、长租行业、行业标准、核心概念、建筑风水学 |
| 物业 | 物业项目综合管理（守则/指引/行业与地方标准）、管理案例、客诉处理、应急响应、收入提升、物业行业研究、物业法律法规与判例、物业企业业绩与榜单、物业服务投标方案 |
| 银发经济 | 养老产业全景、养老机构与运营、适老化与养老建筑设计、医养结合与健康管理、智慧养老、养老金融与保险、老年就业/教育/用品、银发商业项目（CCRC、养老院、银发产业园）、相关政策法规与统计数据 |

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

## 典型问题

| 领域 | 典型问题 |
|------|---------|
| 政策法规 | 解读 4 月底深圳购房新政；2026 年政府工作报告如何定调房地产；某市限购/限售政策要点；国土空间规划要求 |
| 行业研究与观点 | 高端豪宅是否已成独立的避险资产；房票安置为何成为主流模式；经纪行业面临的挑战与转型方向；长租行业发展格局 |
| 宏观数据解读 | 如何理解当前社融/人口数据对楼市的影响；某省房地产投资、库存的形势解读 |
| 企业 | 某房企的债务重组进展与所需政策支持；财报中的土储、开竣工、偿债与战略；高管信息；企业性质（国企/央企/民企） |
| 土地 | 某地块招拍挂公告内容；年度供地计划；土拍规则变化解读 |
| 项目与产品 | 某住宅项目的定位与产品力分析；「好房子」理念下的产品设计要点；项目品牌营销案例 |
| 客群研究 | 首次置业年轻客群最关注什么；购房客群画像的研究方法 |
| 法律 | 房地产开发相关法规条文；商品房买卖/物业纠纷的案例判例参考 |
| 物业 | 物业管理规范与行业标准；客诉处理办法；应急预案；项目收入提升做法；物业企业业绩与榜单 |
| 银发/康养 | 养老机构运营模式；适老化设计标准；医养结合、智慧养老、养老金融；CCRC 等银发项目情况 |
| 通识与冷门 | 房地产核心概念（去化周期、三道红线）；克而瑞介绍；建筑风水（选址、布局、堪舆） |

## 触发信号

用户的问题里出现下面任一特征，就该调 `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]` 时，它是结果范围和分页能力的唯一依据；只用于说明范围，不要把该段当作业务数据展示。

## 计费规则

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

| 情形 | 是否扣积分 |
|------|-----------|
| 问数查询到数据（含部分城市/部分指标有数据） | 扣费 |
| 问数正常执行确认查无数据（有效空结果） | 扣费 |
| 问知返回了答案 | 扣费 |
| 请求被拒绝（Key 无效、重复提交、限流、积分不足、缺参数、范围过大、不支持分页等） | 不扣费 |
| 查询超时、服务内部错误、技术性失败 | 自动全额返还 |

## 错误处理

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

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

| 错误码 | 含义 | 建议动作 |
|--------|------|---------|
| `INVALID_API_KEY` | API Key 无效 | 提示用户检查连接器配置里的 Key 是否完整；需要时可在个人中心新建一把替换 |
| `API_KEY_DISABLED` | API Key 已禁用 | 新建并替换 Key，不要继续重试旧 Key |
| `ACCOUNT_SUSPENDED` | 账户已暂停或注销 | 联系管理员确认账户状态 |
| `DUPLICATE_REQUEST` | 对方判定为重复提交 | 停止自动重试，直接使用首次结果；确需重查时等待用户明确发起 |
| `RATE_LIMITED` / `CONCURRENCY_LIMITED` | 请求过频/并发达上限 | 稍等几秒后重试（retryable=true） |
| `QUOTA_EXHAUSTED` | 积分余额不足 | 提示用户到个人中心充值；企业批量采购可联系深度智联商务 |
| `QUOTA_NO_GRANT` | 账户暂无可用配额包 | 联系商务开通配额 |
| `QUOTA_NOT_ACTIVE` | 配额包尚未生效 | 等待生效时间，不要频繁重试 |
| `QUOTA_SERVICE_UNAVAILABLE` | 配额服务暂不可用 | 稍后重试（retryable=true） |

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

| 错误码 | 含义 | 建议动作 |
|--------|------|---------|
| `QUERY_TOO_SHORT` / `QUERY_TOO_LONG` | 查询内容过短/超过 500 字符 | 调整问题长度后重试 |
| `MISSING_PARAMS` | 缺少必要参数（通常是城市名） | 按提示补充参数后重试 |
| `QUERY_TOO_COMPLEX` | 查询范围过大 | 向用户说明建议拆分方案，等待用户选择后再调用 |
| `UNSUPPORTED_PAGINATION` | 本次命中的数据接口不支持指定页码/范围 | 不要改写页码重试；建议用户增加筛选条件缩小范围 |
| `QUERY_TIMEOUT` | 查询超时（上限 10 分钟） | 缩小查询范围（减少城市/指标/时间跨度）后重试 |
| `NO_MATCHING_INTERFACE` | 无匹配的数据接口 | 该问题超出数据覆盖范围，换个问法或告知用户暂不支持 |
| `INTERNAL_ERROR` | 内部服务错误 | 稍后重试，持续失败请联系深度智联客服 |

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

- 图表**一律用内联 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 再失效旧的。