# `analytics_data` 工具契约

仅当专项服务无法覆盖结构化取数时使用；不得替代行情、K 线、Quote 或价格指标。自然语言统一使用 `question`。

- 首次调用保持用户原意，不增加筛选条件。
- 首次失败、空数据或明显不匹配后，才可在同一取数意图内改写或拆分一次。

## 工具契约

### `get_financial_data`

根据自然语言描述执行结构化数据的计算与提取，支持自定义指标组合、跨实体聚合与灵活的数据加工。仅当所需结果不能由任何预定义数据工具直接返回时使用本工具：单一实体的属性数据、指数与板块的预定义加权指标、宏观指标均调用相应数据服务；按条件筛选并返回实体列表使用各服务的筛选工具（本工具返回计算结果而非实体列表）。

| 参数 | 必填 | 类型 | 枚举 | 示例 / 默认 | 官方说明 |
| --- | --- | --- | --- | --- | --- |
| `question` | 是 | string | — | 示例："查询中国A股市场过去一年的平均成交量" | 自然语言计算与取数要求，为"实体 + 指标 + 指标参数"三要素的组合超集，应包含实体范围、指标或计算逻辑、日期（或时间范围、报告期）等要素。|