> ## Documentation Index
> Fetch the complete documentation index at: https://platform.kimi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 金融深度研究智能体设计
> 拆解官方金融深度研究智能体的长链路交付架构：一条任务如何从取数、研究走到 Word 深度报告和路演 PPT，附完整起点配置、运行成本测算与自建指引。
人工完成一份深度研究报告和投委会 PPT，按 **3–5 个工作日**、**每天 ¥1600** 估算，人力成本 **约 ¥4800–8000**。官方金融深度研究智能体将取数、研究和文件生成串成一次任务：标准档交付 **30–45 页** 的 Word 报告和投委会 PPT，约 **1–1.5 小时、¥50**；深度档交付 **80–120 页** 的 Word 报告和投委会 PPT，约 **2–3 小时、¥100–200**。新上市且公开数据较少的标的，耗时和费用可能偏上限。以上为估算，人工成本不含数据终端费用，智能体费用不含插件调用费用；智能体实际费用以控制台账单为准。智能体负责执行，人工负责复核与决策。
## Agent 架构总览
一次任务的数据流：
1. 调用方上传财报、研报等原始材料拿到 `file_id`，创建会话时挂进 `resources`，文件以只读副本出现在沙箱的 `/mnt/agents/upload/` 下；
2. 调用方下达任务，点名标的、数据口径和产物（Word 报告、PPT，或两者都要）；
3. 智能体进入研究阶段：通过金融投资分析（企业版）插件拉取行情、财务与一致预期，通过财新数据、财联社资讯插件补充行业动态与近期事件，结合上传材料形成完整研究结论；
4. 研究结论定稿后进入产出阶段：走机构金融插件里的 `institutional-research-report` 技能生成 Word 深度报告；
5. 同一份研究结论交给机构金融插件里的 `institutional-slides` 技能规划 storyline，再由独立技能 `ha-slides-pptx` 保证落盘为所有元素可编辑的原生 .pptx；
6. 两个产物写入会话的 `output/` 目录并登记为产物，调用方通过产物接口取回。
这个智能体是单智能体形态，没有委派子智能体。它的分层不在角色之间，而在任务内部：
| 层 | 负责什么 | 能碰的数据 |
| - | - | - |
| 研究层 | 取数、读材料、形成研究结论，统一数据口径 | 数据插件、上传的原始材料 |
| 产出层 | 把研究结论变成 Word 报告和 PPT，不重新取数 | 只有研究层定稿的结论 |
研究阶段先统一口径，产出阶段只用定稿结论，避免边写边查导致前后数字不一致。单智能体即可保留研究上下文，无需为这条链路拆分角色。
## 核心设计
**官方金融深度研究智能体的全部能力来自「模型 + 系统提示词 + 插件 + 一个独立技能」的组合，工具用平台默认内置工具集。它的设计目标有三条，后面每个配置选择都由此出发：**
* **一条链路走到底**：从取数到 Word 报告再到 PPT 不中断，任务里点名要什么就交付什么；
* **一套口径贯穿始终**：市场、币种、会计准则、取数日期在任务开始时确定，报告和 PPT 用同一套数字；
* **取不到就进附录来源表**：数据源查不到或口径对不上的内容，在报告末尾的附录来源表里注明原因，不允许编造数字填坑。
它的配置是六个金融智能体里最重的：四个插件加一个独立技能，因为长链路交付的每一段都需要专门的能力。下面逐项拆解：官方怎么配的、为什么这样配、自建时怎么取舍。
### 系统提示词：把「研究 → 交付」的链路写死
系统提示词的核心不是角色扮演，而是把长链路的工作顺序和交接规则写清楚，让智能体不会在中间某一步停下来交差。关键约定有四条：
* **先研究后产出**：收到任务先完成取数和分析，形成完整的研究结论，再进入产出阶段。不允许「边写边查」，报告里的每个数字都必须来自已经取回的数据；
* **产物点名制**：任务里点名要什么就产出什么。说「深度研究报告」就走机构金融插件里的 `institutional-research-report` 技能出 Word；说「IC PPT」「路演材料」就走 `institutional-slides` 技能出 PPT。两个都要就先后产出，共用同一份研究结论，不重复取数；
* **数据口径一次说清**：市场、币种、会计准则、取数日期在任务开始时确定，报告和 PPT 用同一套口径，PPT 里的数字必须能对应回报告的章节；
* **取不到就进附录来源表**：数据源查不到或口径对不上的内容，在报告末尾的附录来源表里注明原因，不允许编造数字填坑。
### 插件：四件套各管一段
这个智能体挂了四个插件，每个负责链路上的一段，自建时按你的链路长度裁剪：
| 插件 | 管哪一段 | 里面有什么 |
| - | - | - |
| 机构金融插件（`institutional-finance-kit`） | 研究和产出 | `institutional-research-report` 技能（出 Word 深度报告、卖方首覆报告、买方 IC Memo）、`institutional-slides` 技能（出投研 PPT，先规划 storyline 再生成） |
| 金融投资分析（企业版）（`xtt-public-markets-investing`） | 取数 | 统一对接 Wind、同花顺 iFinD、恒生聚源、新华财经、S\&P 等数据源，智能体用能力名取数（如行情、财务、一致预期），不关心供应商接口 |
| 财新数据 | 新闻与宏观 | 财新的新闻和宏观数据，用于行业动态和事件背景 |
| 财联社资讯 | 快讯 | 财联社快讯，用于近期公告、政策和市场事件 |
**为什么深度研究要单独挂新闻源，而建模智能体不用：** 深度报告里「行业趋势」「近期催化剂」「风险提示」这些章节靠的是新闻和事件，不是财务数据；[金融财务建模智能体](/docs/hosted-agents/official-financial-modeling-agent) 的产出是 Excel 模型，用不到。自建时如果你的研究不需要新闻背景，这两个插件可以省掉。
数据源需要授权时，凭据统一放在 [凭据库](/docs/hosted-agents/vaults)，运行时注入，不进智能体配置。插件的引用方式和版本固定规则见 [插件](/docs/hosted-agents/plugins)。
### 独立技能：`ha-slides-pptx` 保证 PPT 是真文件
除了插件里的技能，这个智能体还单独挂了一个独立技能 `ha-slides-pptx`，与 [PPT 助手](/docs/hosted-agents/official-ppt-agent) 使用的产物技能相同。原因是两种 PPT 的产出方式不同：
* **`institutional-slides`（插件里的技能）**：走机构投研 deck 的规范，先梳理 storyline，再生成麦肯锡 / 外资行风格的页面，图表用 PPT 原生 chart；
* **`ha-slides-pptx`（独立技能）**：保证最终落盘的是所有元素可编辑的原生 .pptx 文件（文本框、表格、原生图表），而不是图片贴片或 `.pptd` 中间格式。
两者配合：前者管内容和风格，后者管文件是真的。如果拿到手的产物是 `.pptd` 格式，说明导出环节没走通，检查环境里有没有配 PPT 导出所需的凭据和网络白名单（导出服务域名要放行）。
## 配置选择
模型统一使用 `kimi-k3`。选型考虑：深度研究要通读财报、招股书、行业研报这类长文档，产出本身也是长文档（几十页的 Word 报告加二十页 PPT），对长上下文输入和长文档输出的要求都是六个金融智能体里最高的。自建时这个字段一般不动。
各项资源的配置如下：
| 资源 | 用途 | 本案例的选择 |
| - | - | - |
| 智能体 | 研究 + 产出一条链路 | 单智能体，`kimi-k3` |
| 插件 | 取数、新闻背景、报告与 PPT 技能 | 机构金融插件、金融投资分析（企业版）、财新数据、财联社资讯 |
| 技能 | 保证 PPT 是可编辑的原生文件 | 独立技能 `ha-slides-pptx` |
| 执行环境 | 运行研究与文件生成 | 通用云沙箱；PPT 导出域名与境外数据源主机加网络白名单 |
| 文件 | 财报、券商研报、内部研究等原始材料（建议尽量多提供） | 上传后以只读副本挂载进会话 |
| 凭据库 | 数据插件授权 | 凭据放凭据库，创建会话时挂进 `resources` |
| 触发器 | 当前不需要 | 定期跟踪（季报点评、周报）时再加，见「可扩展方向」 |
| 记忆库 | 当前不需要 | 每份研究独立成会话，不依赖跨会话记忆 |
## 运行成本
成本几乎全部来自模型 tokens；沙箱按运行时长计费（¥0.072 / 小时，一次深度研究约 1–3 小时，不到 ¥0.2），可以忽略；文件上传与抽取限时免费，详见 [托管智能体定价](/docs/pricing/hosted-agents)。以 `kimi-k3` 的 [公开单价](/docs/pricing/chat)，**成本和时间主要随报告页数（研究深度）浮动**：
| 报告篇幅 | 大致成本 | 大致耗时 | 说明 |
| - | - | - | - |
| 30–45 页（标准档） | 约 ¥30–80 | 约 1–1.5 小时 | 首次覆盖报告多在此档；数据全的大公司偏下限，数据少的新上市标的偏上限（实测某新上市标的单次 116 分钟） |
| 80–120 页（深度档） | 约 ¥100–200 | 约 2–3 小时 | 多材料、长篇幅的行业深度或首次覆盖报告；100 页量级就是几百块、几小时 |
| 投委会 PPT（基于同一份研究） | 额外约 ¥20–40 | 约半小时到 1 小时 | 在 Word 报告基础上继续产出，20 页左右 |
以下为大致量级，**实际以控制台账单为准**——它随报告页数/深度、标的数据可得性、是否上传材料、以及取数和返工轮次浮动。上传券商研报、内部研究等材料能让分析更准、减少取数轮次（见下文「第 3 步：准备原始材料」）。上表只是若干次生产会话的大致量级，不是固定价，实际以控制台账单为准。
**建议客户自己准备研报和数据源**：报告质量的上限很大程度由输入材料决定。券商研报、私有数据、内部研究、历史财务原文这些，平台无法直接提供（受版权和合规限制），需要客户自己准备并上传，或自行接入私有信息源（见下文「第 3 步」）。材料越全，历史数据口径越准、假设越有依据、分析越深入。
## 从最小版本开始搭建
下面是一个可运行的最小起点：单智能体 + 四个插件 + 一个独立技能，分五步跑通。它不是官方配置的逐字拷贝，官方当前配置以 `GET /v1/agents` 返回为准。
### 第 1 步：创建智能体
插件 ID 用 `GET /v1/plugins` 列出后按显示名查找（「机构金融插件」「金融投资分析（企业版）」「财新数据」「财联社资讯」），或在控制台智能体表单中直接勾选：
```bash cURL theme={null}
curl -X POST https://api.moonshot.cn/v1/agents \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: 2026-09-01-beta" \
-H "Content-Type: application/json" \
-d '{
"name": "我的深度研究助手",
"model": {"id": "kimi-k3"},
"system": "你是一个金融深度研究助手，覆盖 A 股、港股、美股的公司与行业研究。\n- 收到任务先完成取数和分析，形成完整研究结论后，再进入产出阶段；报告中的每个数字必须来自已取回的数据。\n- 产出深度研究报告（Word）时，使用机构金融插件里的 institutional-research-report 技能；产出投研 PPT 时，使用机构金融插件里的 institutional-slides 技能。\n- 同一份研究产出的报告和 PPT 共用同一套数据口径（市场、币种、会计准则、取数日期），PPT 里的数字必须能对应回报告章节。\n- 取数通过金融投资分析（企业版）插件的数据源完成，所有数据标注来源与取数日期；查不到或无法核实的列入附录来源表并注明原因，严禁编造。\n- 新闻与事件背景优先使用财新数据和财联社资讯插件。\n- PPT 最终产出所有元素可编辑的 .pptx 文件，不要用图片贴片。\n- 所有产出文件写到 output/ 目录，最终回复用相对路径逐一列出。\n- 只做研究，不执行任何交易；结论区分事实、推断与假设。",
"skills": [
{"skill_id": "ha-slides-pptx", "version": "latest"}
],
"plugins": [
{"plugin_id": "<机构金融插件 ID>"},
{"plugin_id": "<金融投资分析（企业版）插件 ID>"},
{"plugin_id": "<财新数据插件 ID>"},
{"plugin_id": "<财联社资讯插件 ID>"}
],
"description": "自建深度研究助手：研究→Word 报告→路演 PPT 一条链路"
}'
```
```bash CLI theme={null}
kha agents create --file - <<'JSON'
{
"name": "我的深度研究助手",
"model": {"id": "kimi-k3"},
"system": "你是一个金融深度研究助手，覆盖 A 股、港股、美股的公司与行业研究。\n- 收到任务先完成取数和分析，形成完整研究结论后，再进入产出阶段；报告中的每个数字必须来自已取回的数据。\n- 产出深度研究报告（Word）时，使用机构金融插件里的 institutional-research-report 技能；产出投研 PPT 时，使用机构金融插件里的 institutional-slides 技能。\n- 同一份研究产出的报告和 PPT 共用同一套数据口径（市场、币种、会计准则、取数日期），PPT 里的数字必须能对应回报告章节。\n- 取数通过金融投资分析（企业版）插件的数据源完成，所有数据标注来源与取数日期；查不到或无法核实的列入附录来源表并注明原因，严禁编造。\n- 新闻与事件背景优先使用财新数据和财联社资讯插件。\n- PPT 最终产出所有元素可编辑的 .pptx 文件，不要用图片贴片。\n- 所有产出文件写到 output/ 目录，最终回复用相对路径逐一列出。\n- 只做研究，不执行任何交易；结论区分事实、推断与假设。",
"skills": [
{"skill_id": "ha-slides-pptx", "version": "latest"}
],
"plugins": [
{"plugin_id": "<机构金融插件 ID>"},
{"plugin_id": "<金融投资分析（企业版）插件 ID>"},
{"plugin_id": "<财新数据插件 ID>"},
{"plugin_id": "<财联社资讯插件 ID>"}
],
"description": "自建深度研究助手：研究→Word 报告→路演 PPT 一条链路"
}
JSON
```
创建成功后，从响应中保存 `id` 作为 `AGENT_ID`。之后按需调整的字段：
| 字段 | 调整频率 | 怎么调 |
| - | - | - |
| `system` | 最常改 | 固定市场范围、数据口径、报告模板和合规表述；上面八条约定建议保留 |
| `plugins` | 按链路改 | 不需要新闻背景就摘掉财新/财联社；换研究领域就换对应领域的工作流插件 |
| `skills` | 一般不动 | `ha-slides-pptx` 保证 PPT 是真文件，换产出物时才调整 |
| `model` | 一般不动 | `kimi-k3` 已适配长文档读写 |
| 工具集 | 一般不动 | 默认内置工具集已够用，无需声明 |
### 第 2 步：创建执行环境
通用云沙箱即可，`config` 传 `{"type": "cloud"}`，详见 [快速开始](/docs/hosted-agents/quickstart)。注意两点：PPT 导出需要放行导出服务的域名；用到 SEC、美联储等境外官方数据源时，对应主机要加进网络白名单。从响应中保存 `id` 作为 `ENVIRONMENT_ID`。
### 第 3 步：准备原始材料并创建会话
研究质量的上限很大程度由输入材料决定。**建议尽可能多地提供资料**：券商研报、私有数据、内部研究、历史财务原文等。材料越全，报告的历史数据口径越准、论点依据越扎实、分析越深入——有原始材料的研究，质量明显高于纯靠插件检索。需要说明：平台无法直接提供券商研报等受版权保护的资料，需要你自己准备并上传，或自行接入私有信息源。提供方式有两种：
1. **直接上传 PDF**：把研报、财报、行业材料通过 `POST /v1/files` 上传拿到 `file_id`，创建会话时挂进 `resources`，文件以只读副本出现在沙箱的 `/mnt/agents/upload/` 下，详见 [文件](/docs/hosted-agents/files)；
2. **MCP + 凭据库连私有信息源**：如果机构有自己的数据服务（Wind、内部研报库、私有数据库），可以包成 MCP 服务挂进智能体，凭据放 [凭据库](/docs/hosted-agents/vaults)，创建会话时把凭据库挂进 `resources`（绑定只在创建时生效），运行时自动注入。数据授权关系留在机构与数据商之间，平台不碰数据，详见 [接入 MCP](/docs/hosted-agents/mcp)。
数据插件需要授权时，凭据同样走凭据库挂载，不进智能体配置。
[快速开始](/docs/hosted-agents/quickstart) 已经完整走过一遍调用流程，这里只展示深度研究任务的特有部分。假设原始材料已上传拿到 `FILE_ID`，创建会话时挂进 `resources`（没有原始材料就省略该字段）：
```bash cURL theme={null}
curl -X POST https://api.moonshot.cn/v1/sessions \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: 2026-09-01-beta" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "'"$AGENT_ID"'",
"environment_id": "'"$ENVIRONMENT_ID"'",
"title": "宁德时代深度研究",
"resources": [
{"type": "file", "file_id": "'"$FILE_ID"'"}
]
}'
```
```bash CLI theme={null}
kha sessions create --file - <
### 第 4 步：下达任务
从响应中保存会话 `id` 作为 `SESSION_ID`，订阅事件流后下达任务。任务描述要点名产物，这一个动作决定智能体走到链路的哪一段：
```bash cURL theme={null}
curl -X POST https://api.moonshot.cn/v1/sessions/$SESSION_ID/events \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: 2026-09-01-beta" \
-H "Content-Type: application/json" \
-d '{
"events": [
{
"type": "user.message",
"data": {
"content": [
{"type": "text", "text": "对宁德时代（300750.SZ）做深度研究：用插件数据源拉取最近四个季度的财务数据和最新一致预期，结合上传的年报材料，给出完整投资论点与估值。产出一份 Word 深度研究报告，再基于同一份研究做一份 20 页的投委会 PPT，所有元素可编辑的 .pptx，都保存到 output/ 目录。"}
]
}
}
]
}'
```
```bash CLI theme={null}
kha sessions send "$SESSION_ID" "对宁德时代（300750.SZ）做深度研究：用插件数据源拉取最近四个季度的财务数据和最新一致预期，结合上传的年报材料，给出完整投资论点与估值。产出一份 Word 深度研究报告，再基于同一份研究做一份 20 页的投委会 PPT，所有元素可编辑的 .pptx，都保存到 output/ 目录。"
```
同一个智能体，任务描述决定它走到链路的哪一段，上面这条就是一个合格示例。以下四条原则按重要性排序：
1. **说清标的和深度。** 给公司代码避免同名歧义；「深度研究」「首次覆盖报告」「IC Memo」对应不同的报告模板，要哪个说哪个。写「对宁德时代（300750.SZ）做深度研究」，而不是「帮我看看宁德」。
2. **点名产物。** 要 Word 说「深度研究报告」，要 PPT 说「投委会 PPT」或「路演材料」，两个都要就明说。不点名时默认只输出文字分析，不会生成文件。
3. **说清数据口径。** 写一句「用插件数据源拉取最近四个季度的财务数据，标注来源与取数日期」就够，不用自己准备数据。
4. **PPT 要可编辑就明说。** 写明「所有元素可编辑的 .pptx，不要图片贴片」，能避免个别任务退化成整页图片。
### 第 5 步：取回产物并核对
会话回到 `idle` 后，通过产物接口取回交付物：
```bash cURL theme={null}
curl "https://api.moonshot.cn/v1/artifacts?session_id=$SESSION_ID" \
-H "Authorization: Bearer $KIMI_API_KEY" \
-H "kimi-api-version: 2026-09-01-beta"
```
```bash CLI theme={null}
kha artifacts list --session "$SESSION_ID"
```
一次完整任务交付两个文件，都保存在会话的 `output/` 目录下：
* **Word 深度研究报告**（如 `output/CATL_deep_dive.docx`）：几十页的完整报告，章节通常包括投资要点、公司分析（业务模式、竞争优势）、行业分析（趋势、格局、风险）、财务分析、估值（一致预期 × 自下而上倍数定价 + DCF 交叉验证）、投资论点与催化剂，末尾附来源表。所有数据标注来源和取数日期。报告篇幅取决于任务复杂度和上传材料规模，首次覆盖报告通常 30–45 页；
* **投研 PPT**（如 `output/CATL_IC_deck.pptx`）：同一份研究的压缩版，20 页左右，麦肯锡 / 外资行风格，每页一个论点、标题即结论，图表是 PPT 原生 chart（可以在 Office / WPS 里直接改数据），不是截图。
两个文件共用同一套数据口径。核对产物时，先抽查 PPT 里的关键数字能不能对应回报告章节：对不上说明研究阶段的数据口径没统一，是系统提示词要收紧的信号。
## 运行与观察
深度研究是长任务，标准档报告通常要跑 1–1.5 小时，深度档 2–3 小时，建议在事件流里盯到结束。判断一次运行是否正常，看这几处：
* **`session.status`**：`running` 表示开工，回到 `idle` 表示本轮完成，可以去取产物；
* **`agent.tool_use` / `agent.tool_result`**：能看到智能体调了哪些数据插件、读了哪些文件。研究阶段应该看到数据插件的调用，产出阶段应该看到文件写入；如果产出阶段还在大量取数，说明「先研究后产出」的约定没生效；
* **`session.error`**：任务失败时出现，携带错误类型与信息。
以下观察点是深度研究场景独有的：
| 看哪里 | 看什么 | 说明什么 |
| - | - | - |
| 产物列表 | 产物是 `.pptx` 还是 `.pptd` | `.pptd` 说明 PPT 导出环节没走通，检查导出凭据和网络白名单 |
| 研究阶段的工具调用 | 数据插件是否都有返回 | 某个数据源反复报错，通常是凭据没配或主机不在网络白名单 |
| 最终回复 | 是否逐一列出 `output/` 下的文件相对路径 | 只回复文字分析、没有文件，说明任务描述没点名产物 |
事件流断连时用最后一帧 SSE 消息的 `id:` 字段作为 `cursor` 续读，详见 [事件流](/docs/hosted-agents/event-stream)。
## 可扩展方向
* **批量研究**：多个标的可以在同一会话里一起下达，产出统一落在该会话的 `output/` 目录；需要会话级隔离时建多会话并发跑；
* **多智能体拆分**：先跑通单智能体长链路，再按「取数 / 研究 / 产出」拆成多个专职智能体，委派配置写在 `multiagent` 字段里，详见 [多智能体编排](/docs/hosted-agents/multiagent-orchestration)；
* **定期跟踪**：首覆报告发出后的定期跟踪（季报点评、周报）是周期性任务，用 [触发器](/docs/hosted-agents/triggers) 按计划自动运行；
* **嵌入自有系统**：把会话创建、事件流订阅、产物取回接进自己的投研平台，人工审核放在你的业务系统里，确认无误再对外发布。
## 下一步
插件的引用方式、版本固定与凭据注入。
上传原始材料、挂载会话与取回产出文件。
用触发器把季报点评、周报做成定期跟踪。