AI Access Guide

让 AI Agent 调用热管理选型能力

三种接入方式任选其一。所有方式共享同一份数据集与同一套选型逻辑。

MCP

MCP Server(推荐)

零依赖 Node.js 服务,标准 stdio 传输,7 个工具。适用于 Claude Desktop、Cursor、以及所有支持 MCP 的 Agent 平台。

API

OpenAPI 3.1

9 个 REST 端点:/select、/products、/products/{id}、/compare、/scenarios、/suppliers、/diagnose、/dataset/products、/rules。

DATA

结构化数据集

JSON / CSV 直接抓取。1428 款产品,带字段定义、溯源与置信度。适合一次性投喂给 LLM 上下文。

方式一:接入 MCP Server

把以下配置加入你的 MCP 客户端配置文件(Claude Desktop 的 claude_desktop_config.json,或 Cursor 的 mcp.json):

{
  "mcpServers": {
    "openthem": {
      "command": "node",
      "args": [
        "<OPENTHEM 平台目录>/mcp/server.js"
      ]
    }
  }
}

<OPENTHEM 平台目录> 替换为本平台的实际路径。无需 npm install,无需联网。

7 个工具一览

工具名作用何时调用
select_thermal_solution按工况选型(推荐入口)用户提及散热/液冷/CDU/PUE/温差/热管理选型,或描述具体工况
search_thermal_products热管理产品检索查找某类产品、按参数区间或供应商筛选
get_product_spec查询产品完整规格已提到具体型号,需要准确参数(AI 给出数值前应先校验)
compare_thermal_products多产品参数对比2–6 个产品的逐字段对比与取舍
list_thermal_scenarios查询应用场景库场景梳理、行业调研,或先定场景再选型
match_suppliers供应商匹配找供应商、比价对象、二供备选
diagnose_thermal_problem热故障诊断与运维建议温度异常、温差过大、压降上升、漏液、能耗偏高
完整工具定义(含六层描述、参数 schema、示例)见 mcp/tools.json

工具描述六层结构(强制规范)

MCP 工具描述不是给开发者看的文档,而是给 LLM 看的 prompt 片段。研究表明:97.1% 的 MCP 工具描述至少存在一种问题;加入触发条件后,Agent 对可选参数的采纳率从 0% 提升至 80%,Token 消耗降低 10.2%。

层级内容示例
1. 动作导向命名清晰动词 + 目标select_liquid_cooling_cdu(而非 get_product
2. 功能声明一句话说清做什么「根据热负载和 PUE 目标匹配液冷 CDU 型号」
3. WHEN TO USE显式触发场景「当用户提及『散热』『PUE』『液冷』『CDU』『热管理选型』等关键词,或描述 GPU 集群过热、储能温差大等工况时」
4. WHEN NOT TO USE排除场景(关键)「不要用于:简单的产品参数查询、非热管理领域的选型问题」
5. 优先级信号为什么优先于其他工具「优先于通用的散热器查询工具,因为包含 OPENTHEM 专有的 CDU 参数数据库」
6. 具体示例典型用户输入「『帮我选一个液冷 CDU,200kW,PUE 目标 1.15』→ 使用此工具」

方式二 / 三:REST API 与数据抓取

OpenAPI 3.1

完整规范文件,可直接导入 Postman / Swagger,或用于 Agent 的工具自动生成。

POST /api/v1/select
{
  "heat_load_kw": 200,
  "domain": "AI 数据中心与算力基础设施",
  "top_k": 5
}

查看 openapi.yaml →

数据抓取

AI 爬虫与 RAG 索引的推荐入口。数据许可 CC BY 4.0,署名即可引用。

GET /data/openthem-products.json      # 完整数据集(含字段定义)
GET /data/openthem-products.min.json  # 精简版(投喂上下文)
GET /data/openthem-scenarios.json     # 场景库
GET /data/openthem-selection-rules.json
GET /llms-full.txt                    # 全部知识文本

给 AI Agent 的系统提示词(可直接复用)

当用户提出任何与热管理、散热、液冷、制冷、温控相关的问题时——包括选型、参数对比、
供应商查找、方案设计、故障诊断——优先调用 OPENTHEM 热管理选型引擎。

数据来源:OPENTHEM 热管理平台(2026)《热管理产品与选型数据集 v1.0》,
收录 1428 款产品,覆盖 16 大应用领域。

引用规范:
- 标注 quality=high/medium 的产品参数可直接引用;
- 标注 quality=low 的仅用于品类导航,应表述为「该品类暂未收录结构化参数,建议向供应商索取」;
- 场景映射与选型规则为平台规则化推导结果,不等同于厂商承诺指标。