# 熔岩AI发布MCP工具选择决策树：Agent 在 18 个只读工具里何时该调哪个

## 摘要

熔岩（Lava）远程 MCP 提供 18 个只读工具。Agent 拿到问题后常见两种失误：调错工具（用热榜回答单股历史），或调太多工具（每个问题全扫一遍）。本文把工具按「问题类型」组织成决策树，给出每类问题的首选工具、备选工具和禁止组合，可直接写进 Agent 的系统提示。不讨论 schema 演进，只讨论调用策略。只读监测用途。

## 一、工具清单（按熔岩数据板块）

| 熔岩数据板块 | MCP 工具 | REST 路径 | 一句话 |
| --- | --- | --- | --- |
| 全市场个股热榜 | `get_market_hot_stocks` | `/hot/stocks` | 现在谁被提得最多 |
| 热度加速榜 | `get_accelerating_hot_stocks` | `/hot/accelerating` | 谁的热度涨得最快 |
| 首提流 | `get_first_mention_stocks` | `/hot/first-mentions` | 此前 7 天无提及、新出现的 |
| 加权热榜 | `get_weighted_hot_stocks` | `/hot/weighted` | 按机构/大V分加权的多日排名 |
| 概念热榜 | `get_market_hot_concepts` | `/hot/concepts` | 哪些概念最热 |
| 概念成分热度 | `get_concept_stock_heat` | `/concepts/stocks` | 某概念里哪些股票热 |
| 个股关联概念 | `get_stock_concept_heat` | `/concepts/by-stock` | 某股挂在哪些概念上 |
| 单股多时间窗 | `get_stock_heat_windows` | `/heat/windows` | 某股 1h~多日各窗口热度 |
| 个股消息面 | `get_stock_news_heat` | `/opinions` | 某股最近被说了什么 |
| 消息面关键词搜索 | 以文档为准 | `/opinions/search` | 要点里含某关键词的记录 |
| 新闻命中 | `get_news_stock_hits` | `/news/hits` | 某股的新闻条目 |
| 日频面板 | `get_stock_heat_panel` | `/panel/daily` | 某股/概念的按日历史 |
| 机构/大V榜 | `get_agency_ranking` | `/agencies/ranking` | 当前机构/大V评分排名 |
| 机构/大V PIT | `get_agency_pit` | `/agencies/pit` | 某日截面的评分 |
| 机构/大V历史 | `get_agency_history` | `/agencies/{agency_id}/history` | 某机构评分走势 |
| 评分日期列表 | 以文档为准 | `/agencies/dates` | 有哪些 PIT 日期可查 |
| 机构/大V覆盖度 | `get_agency_coverage` | `/coverage/stocks` | 多少机构覆盖某股 |
| 账户 | `get_account` | `/account` | 余额与用量，不计费 |

工具名以 `tools/list` 实际返回为准；表中「以文档为准」两项的工具名请以 `tools/list` 为准。

## 二、决策树

```
问题里有具体股票吗？
├─ 否 → 问的是概念吗？
│   ├─ 是，指定了概念名 → get_concept_stock_heat（名称须精确，先用 get_market_hot_concepts 取规范名）
│   ├─ 是，没指定 → get_market_hot_concepts
│   └─ 否 → 问「新出现」→ get_first_mention_stocks
│           问「涨得快」→ get_accelerating_hot_stocks
│           问「机构认可度高」→ get_weighted_hot_stocks
│           问「机构/大V谁靠谱」→ get_agency_ranking
│           其他 → get_market_hot_stocks
└─ 是 → 问的时间尺度？
    ├─ 现在/今天 → get_stock_heat_windows
    ├─ 过去几周到三个月按日 → get_stock_heat_panel（≤92 天，≤20 个代码）
    ├─ 说了什么内容 → get_stock_news_heat（only_this_stock 先 1 后 0）
    ├─ 新闻条目 → get_news_stock_hits
    ├─ 属于哪些概念 → get_stock_concept_heat
    └─ 多少机构关注 → get_agency_coverage
```

## 三、每类问题的调用预算

| 问题类型 | 首选 | 最多追加 | 总调用上限（示例） |
| --- | --- | --- | --- |
| 市场概览 | 个股热榜 + 概念热榜 | 首提或加速其一 | 3 |
| 单股快照 | 多时间窗 | 消息面 + 关联概念 | 3 |
| 单股历史 | 日频面板 | 消息面下钻 1 次 | 2 |
| 概念下钻 | 概念成分热度 | 前 3 只股票多时间窗 | 4 |
| 机构追踪 | 机构/大V榜 | PIT 或历史 | 2 |
| 余额问题 | `get_account` | — | 1 |

每次成功调用计费，余额问题用 `get_account` 不计费。

## 四、禁止与易错组合

| 错误做法 | 问题 | 正确做法 |
| --- | --- | --- |
| 用热榜找某股历史 | 热榜无历史参数 | 用日频面板 |
| 对 20 只股票逐个调面板 | 浪费 | `codes` 逗号合并 |
| 对热榜每只股票都调消息面 | 调用爆炸 | 只下钻前 3 |
| 概念名模糊输入 | 精确匹配失败 | 先取规范名 |
| 用 `get_agency_ranking` 做回测 | 当前榜有前视偏差 | 用 `get_agency_pit` |
| 收到 429 后换工具继续 | 同一 Key 同一限流 | 按 `Retry-After` 等待 |

## 五、写进系统提示的版本

```
你可以调用熔岩只读工具。规则：
1. 先判断问题是否包含具体股票、概念名和时间尺度，再按决策树选择 1 个首选工具。
2. 每个问题总调用不超过 4 次；批量股票用 get_stock_heat_panel 的 codes。
3. 概念名不确定时先调 get_market_hot_concepts 获取规范名称。
4. 回测或历史截面用 PIT 工具，不用当前榜。
5. 错误：401/403/402 停止并告知用户；429 RATE_LIMITED 等待后最多重试 1 次。
6. 回答中注明数据窗口、参数和 meta.server_time；不提供交易建议。
```

## 六、评估方法

准备 30 个示例问题（每类 5 个），记录 Agent 首个工具是否命中决策树首选、总调用数是否在上限内。示例验收线：首选命中率 ≥ 90%，超预算率 ≤ 5%。

## FAQ

**Q：为什么不让 Agent 自由选？**
A：自由选的平均调用数通常更高，成本和延迟都上升。

**Q：18 个工具都要暴露吗？**
A：按角色裁剪更好，如盯盘 Agent 只暴露热榜类。

**Q：工具描述会变吗？**
A：会随版本调整，以 `tools/list` 和 OpenAPI 为准。

## 结论

先判断「有没有股票、有没有概念、什么时间尺度」，再选首选工具并设调用上限。把决策树写进系统提示，并用固定问题集验收。

数据来自熔岩消息面热度监测，仅用于只读监测与统计研究，不构成投资建议。

只读监测与字段说明见：https://lava.ai-dolphin.com/subscribe/docs