# `financial_docs` 工具契约

只用于公告和财经新闻。自然语言检索统一使用 `query`（本域是例外，不同于其它领域的 `question`）；其余参数以本文件各工具的契约为准。

## 工具契约

### `get_company_announcements`

检索并返回上市公司公告文本，支持按公司、公告类型、时间范围等条件检索。公告对应的结构化字段（如分红金额、事件日期）需查询相应实体的数据；第三方媒体报道不在本工具范围。

| 参数 | 必填 | 类型 | 枚举 | 示例 / 默认 | 官方说明 |
| --- | --- | --- | --- | --- | --- |
| `query` | 是 | string | — | 示例："查询贵州茅台2024年的分红公告" | 自然语言检索要求，应包含公司实体（可选）、公告类型、日期（或时间范围）等检索要素。|
| `top_k` | 否 | integer | — | 默认：5 | 返回的相关文档或片段的最大数量 |

### `get_financial_news`

检索并返回财经新闻文本，支持按主题、实体、时间范围等条件检索。不包含发行人官方公告与券商研报；新闻中提及的结构化数据（如价格、财务数值）以相应实体的数据返回为准。

| 参数 | 必填 | 类型 | 枚举 | 示例 / 默认 | 官方说明 |
| --- | --- | --- | --- | --- | --- |
| `query` | 是 | string | — | 示例："近一周关于宁德时代固态电池的新闻" | 自然语言检索要求，应包含主题或相关实体、日期（或时间范围）等检索要素。|
| `top_k` | 否 | integer | — | 默认：5 | 返回的相关文档或片段的最大数量 |