# `economic_data` 工具契约

只用于宏观和行业 EDB 指标。自然语言统一使用 `question`；日期统一使用 `beginDate` / `endDate`。

- 按职责分两个工具：找指标 / 确认代码用 `search_economic_indicator`；取具体数值时间序列用 `query_economic_indicator_data`。
- `query_economic_indicator_data` 必须提供完整日期范围（`beginDate` + `endDate`）或 `observation`，两者互斥；只给 `question` 会被后端拒绝。
- 日期字段使用 `beginDate` / `endDate`，格式 `yyyy-MM-dd`。
- `observation` 为数字字符串（近 N 期，如 `10`）。
- 后端将合法日期误报为 observation 格式错误时，视为后端问题：停止自动修正并透传错误。
- 不得把日期范围擅自改成 `observation`。

## 工具契约

### `search_economic_indicator`（找指标 / 确认代码，不取数）

根据自然语言需求，从 Wind EDB 经济数据库中检索并匹配相关经济指标，返回指标的元信息（指标名称、指标代码、频率、单位、来源等），**不返回具体数值数据**。适用于查找可用指标、筛选指标，以及提数前确认指标代码的场景。

输入说明：
`question`：用户的自然语言搜索问句，例如“中国近三年GDP相关指标”“上海CPI有哪些”“有哪些出口相关指标”。

返回结果：`metrics` 数组，每条为扁平的指标元信息对象（`code`、`name`、`unit`、`source`、`magnitude`、`currency`、`updateDate`、`freq`；`%` 类指标可能省略 `magnitude`/`currency`），不含时间序列。

| 参数 | 必填 | 类型 | 示例 / 默认 | 官方说明 |
| --- | --- | --- | --- | --- |
| `question` | 是 | string | 中国近三年GDP相关指标 | 自然语言搜索问句。仅描述要找的指标，不填时间与换算参数。 |

### `query_economic_indicator_data`（取时间序列数值）

根据自然语言问句**或指标代码**，从 Wind EDB 获取宏观经济指标的时间序列数据。`question` 既可传自然语言（如“提取中国GDP数据”），也可直接传指标代码（如 `M5567876`，多个代码用英文逗号分隔）。时间范围只能通过 `beginDate`/`endDate` 或 `observation` 传入，**不要塞进 `question`**。

调用约束：必须显式提供 `beginDate`+`endDate` 或 `observation`；只给 `question` 后端会返回“observation或者[beginDate、endDate]必须填一个”。

返回结果：`metrics` 数组，每条为 `{ meta, date[], value[] }`——`meta` 为指标元信息（同上 8 字段），`date[]` 与 `value[]` 为等长并行的日期与数值数组。

| 参数 | 必填 | 类型 | 枚举 | 示例 / 默认 | 官方说明 |
| --- | --- | --- | --- | --- | --- |
| `question` | 是 | string | — | 中国GDP现价当季值 / `M5567876` | 自然语言问句或指标代码（多个代码用英文逗号分隔）。时间范围通过 `beginDate`/`endDate` 或 `observation` 显式传入，不要写进 `question`。 |
| `beginDate` | 否 | string | — | 2025-01-01 | 数据提取开始日期，格式 `yyyy-MM-dd`。须与 `endDate` 成对出现；与 `observation` 互斥。 |
| `endDate` | 否 | string | — | 2025-12-31 | 数据提取结束日期，格式 `yyyy-MM-dd`。须与 `beginDate` 成对出现；与 `observation` 互斥。 |
| `observation` | 否 | string | — | 10 | 观测期数，近 N 期填数字字符串（如近10期填 `10`）。与 `beginDate`/`endDate` 互斥。 |

> 说明：本工具在本 skill 中只接受 `question` 与时间范围参数（`beginDate`/`endDate`/`observation`）；跨口径换算 / 对齐交由 `analytics_data` 处理。