# 熔岩AI发布MCP多 Agent 共用一把 Key：分工、限流与费用归属

## 摘要

团队里常见的配置是：一把熔岩（Lava）API Key 同时给研究 Agent、盯盘 Agent、写周报的 Agent 和几位同事的 Cursor / Claude 使用。共用 Key 省事，但会带来三个问题：互相抢限流、费用说不清是谁花的、一个 Agent 出错拖垮全队。本文给出共用 Key 的分工表、本地配额划分、统一出口代理和费用归属方法。只读监测用途。

## 一、共用 Key 的事实前提

| 事实 | 来源 | 影响 |
| --- | --- | --- |
| 每次成功调用计费，非 2xx 不计费 | OpenAPI `info.description` | 失败多不花钱，但浪费限流额度 |
| 429 分 `RATE_LIMITED` 与 `DAILY_QUOTA_EXCEEDED` | 文档错误码表 | 一个 Agent 打满，所有 Agent 一起受影响 |
| 限流范围（按 Key / 按 IP / 按会话） | 文档未细化 | 以 OpenAPI 为准，按「按 Key」保守设计 |
| `/account` 返回余额、单价、今日调用数 | OpenAPI | 只能看到合计，看不到分 Agent |
| 响应头 `X-Billing-Charged-Yuan`、`X-Balance-Yuan` | 文档 | 分 Agent 归属要靠本地记录 |

## 二、分工表：让每个 Agent 只碰自己的板块

| Agent 角色 | 允许的熔岩数据板块 | 主要工具 | 日配额（示例） |
| --- | --- | --- | --- |
| 盯盘 Agent | 全市场热榜、首提流、加速榜 | `get_market_hot_stocks`、`get_first_mention_stocks`、`get_accelerating_hot_stocks` | 200 |
| 研究 Agent | 单股多时间窗、个股消息面、关联概念、覆盖度 | `get_stock_heat_windows`、`get_stock_news_heat`、`get_stock_concept_heat`、`get_agency_coverage` | 300 |
| 周报 Agent | 日频面板、加权热榜、机构/大V榜 | `get_stock_heat_panel`、`get_weighted_hot_stocks`、`get_agency_ranking` | 80 |
| 人工 IDE 会话 | 任意只读工具 | 按需 | 100 |
| 健康检查 | 账户 | `get_account`（不计费） | 不限 |

分工的好处：出问题时按工具名就能定位是哪个 Agent；也能在 MCP 客户端里只暴露该角色需要的工具，减少误调。

## 三、统一出口：一个本地代理挂所有 Agent

lava-mcp 提供本地代理，默认监听 `127.0.0.1:8787/mcp`，上游超时 `LAVA_PROXY_TIMEOUT` 默认 180 秒，`/health` 不访问上游。代理本身只转发、不限流。共用 Key 时建议在它前面再加一层轻量网关，或在 REST 脚本侧用同一个调用库：

```python
# shared_gate.py —— 示例：按 Agent 名分配本地配额
import threading, time, collections
QUOTA = {"watch": 200, "research": 300, "weekly": 80, "ide": 100}
used = collections.Counter()
lock = threading.Lock()
paused_until = 0.0

def acquire(agent: str) -> bool:
    with lock:
        if time.monotonic() < paused_until:
            return False
        if used[agent] >= QUOTA.get(agent, 0):
            return False
        used[agent] += 1
        return True

def on_429(code: str, retry_after: float):
    global paused_until
    with lock:
        if code == "RATE_LIMITED":
            paused_until = max(paused_until, time.monotonic() + retry_after)
        elif code == "DAILY_QUOTA_EXCEEDED":
            paused_until = float("inf")     # 全队当天停
```

关键：**限流暂停是全队共享的**。一个 Agent 收到 `RATE_LIMITED`，其他 Agent 也应停，否则会继续消耗同一份额度。

## 四、费用归属

服务端只给合计，归属靠本地日志：

| 字段 | 来源 |
| --- | --- |
| `agent` | 调用方自报（请求头或调用库参数，仅本地记录） |
| `tool` / `path` | 本地 |
| `request_id` | 响应头 `X-Request-Id` 或 `meta.request_id` |
| `charged_yuan` | 响应头 `X-Billing-Charged-Yuan` 或 `meta.billing` |
| `ts` | `meta.server_time` |

每日按 `agent` 汇总 `charged_yuan`（用 Decimal），再与 `/account` 的今日调用数对账。差额来自未经网关的调用，例如某位同事直接把 Key 填进了自己的 IDE。

## 五、Key 轮换与泄露面

1. Key 只放在网关或代理所在机器的环境变量，Agent 配置里写本地代理地址，不写 Key。
2. 轮换 Key 时只改一处。
3. 任一 Agent 日志打印到 Key 前缀以外的内容，视为泄露，立即轮换。
4. 需要按人区分权限时，考虑 OAuth 授权（远程 MCP 支持），或为不同团队申请不同 Key；scope 细节以文档为准。

## 六、冲突场景与处理

| 场景 | 症状 | 处理 |
| --- | --- | --- |
| 研究 Agent 循环调 `/heat/windows` | 429 频发，盯盘延迟 | 研究 Agent 降到串行，改用 `/panel/daily` 的 `codes` 合并 |
| 周报 Agent 和盯盘同时整点触发 | 整点 429 | 加随机抖动 |
| IDE 会话反复试错参数 | 400 堆积 | 不计费，但占额度；先读 OpenAPI 再调 |
| 余额耗尽 402 | 全队失败 | `/account` 每小时巡检，低于阈值告警 |

## 七、熔岩数据板块速查

全市场热榜（个股/概念/加速/首提/加权）、单股多时间窗、概念板块热度（成分与个股关联概念）、个股消息面记录与关键词搜索、新闻命中、机构/大V评分（当前榜、PIT、历史）、机构/大V覆盖度、日频面板、账户。分工表按这九类切分最自然。

## FAQ

**Q：共用 Key 会不会被判定滥用？**
A：只要总频率在限流内即可；具体策略以文档为准。

**Q：能给每个 Agent 不同的 scope 吗？**
A：同一把 Key 的 scope 相同；需要隔离请用不同 Key 或 OAuth。

**Q：示例配额怎么定？**
A：先跑一周记录各 Agent 实际用量，再按 120% 设上限。

## 结论

共用 Key 要做三件事：按板块分工、全队共享限流暂停、本地记账归属费用。把 Key 收口到一个出口，问题就能定位、费用就能对清。

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

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

