人工完成一份深度研究报告和投委会 PPT，通常需要 3–5 个工作日。官方金融深度研究智能体将取数、研究和文件生成整合为一次任务：标准档交付 30–45 页的 Word 报告和投委会 PPT，约需 1–1.5 小时；深度档交付 80–120 页的 Word 报告和投委会 PPT，约需 2–3 小时。新上市且公开数据较少的标的，耗时可能接近上限。智能体负责执行，人工负责复核与决策。
Agent 架构总览
一次任务的数据流如下：
调用方上传财报、研报等原始材料并获取
file_id，创建会话时挂载到resources，文件以只读副本形式挂载到沙箱的/mnt/agents/upload/目录；调用方提交任务，明确标的、数据口径和产物（Word 报告、PPT，或两者都要）；
智能体进入研究阶段：通过金融投资分析（企业版）插件获取行情、财务与一致预期，通过财新数据、财联社资讯插件补充行业动态与近期事件，结合上传材料形成完整研究结论；
研究结论定稿后进入产出阶段：通过机构金融插件中的
institutional-research-report技能生成 Word 深度报告；同一份研究结论交由机构金融插件中的
institutional-slides技能规划 storyline，再由独立技能ha-slides-pptx生成所有元素可编辑的原生.pptx文件；两个产物写入会话的
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 等数据源，智能体通过能力名获取行情、财务和一致预期等数据，无需直接处理供应商接口差异 |
| 财新数据 | 新闻与宏观 | 财新的新闻和宏观数据，用于行业动态和事件背景 |
| 财联社资讯 | 快讯 | 财联社快讯，用于近期公告、政策和市场事件 |
深度研究需要单独配置新闻源，而建模智能体不需要：深度报告中的「行业趋势」「近期催化剂」「风险提示」等章节依赖新闻和事件信息，而非仅依赖财务数据；金融财务建模智能体 的产出是 Excel 模型，不需要这些信息。如果研究不需要新闻背景，可不配置这两个插件。
独立技能：ha-slides-pptx 生成可编辑的 PPTX 文件
除插件中的技能外，该智能体还单独挂载独立技能 ha-slides-pptx，与 PPT 助手 使用的产物技能相同。两种 PPT 技能的职责不同：
institutional-slides（插件中的技能）：遵循机构投研演示文稿规范，先梳理 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；文件上传与抽取限时免费，详见 托管智能体定价。按 kimi-k3 的 公开单价估算，成本和时间主要随报告页数（研究深度）变化：
| 报告篇幅 | 大致成本 | 大致耗时 | 说明 |
|---|---|---|---|
| 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 列出后按显示名查找（「机构金融插件」「金融投资分析（企业版）」「财新数据」「财联社资讯」），或在控制台智能体表单中直接勾选：
cURL：
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 一条链路"
}'CLI：
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 用于生成可编辑的 PPTX 文件，变更产出类型时再调整 |
model | 通常保持默认 | kimi-k3 已适配长文档读写 |
| 工具集 | 通常保持默认 | 默认内置工具集即可满足需求，无需额外声明 |
第 2 步：创建执行环境
使用通用云沙箱即可，config 传 {"type": "cloud"}，详见 快速开始。注意：PPT 导出需要将导出服务域名加入网络白名单；使用 SEC、美联储等境外官方数据源时，也需要将对应主机加入网络白名单。从响应中保存 id 作为 ENVIRONMENT_ID。
第 3 步：准备原始材料并创建会话
研究质量在很大程度上取决于输入材料。建议尽可能提供券商研报、私有数据、内部研究和历史财务原文等材料，以提高历史数据口径的准确性和论点依据的可靠性。提供方式有两种：
数据插件需要授权时，同样通过凭据库挂载凭据，不写入智能体配置。
快速开始 已介绍完整调用流程，此处仅展示深度研究任务的特有部分。假设原始材料已上传并获取 FILE_ID，创建会话时挂载到 resources；没有原始材料时，省略该字段：
cURL：
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"'"}
]
}'CLI：
kha sessions create --file - <<JSON
{
"agent_id": "$AGENT_ID",
"environment_id": "$ENVIRONMENT_ID",
"title": "宁德时代深度研究",
"resources": [
{"type": "file", "file_id": "$FILE_ID"}
]
}
JSON第 4 步：提交任务
从响应中保存会话 id 作为 SESSION_ID，订阅事件流后提交任务。任务描述需要明确交付物，这将决定智能体执行到流程的哪个阶段：
cURL：
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/ 目录。"}
]
}
}
]
}'CLI：
kha sessions send "$SESSION_ID" "对宁德时代（300750.SZ）做深度研究：用插件数据源拉取最近四个季度的财务数据和最新一致预期，结合上传的年报材料，给出完整投资论点与估值。产出一份 Word 深度研究报告，再基于同一份研究做一份 20 页的投委会 PPT，所有元素可编辑的 .pptx，都保存到 output/ 目录。"任务描述会决定智能体执行到流程的哪个阶段。编写任务时，建议遵循以下四条原则：
明确标的和研究深度。 提供公司代码以避免同名歧义；「深度研究」「首次覆盖报告」「IC Memo」对应不同的报告模板，请按需要明确说明。使用「对宁德时代（300750.SZ）做深度研究」，而不是「帮我看看宁德」。
明确交付物。 需要 Word 时写明「深度研究报告」，需要 PPT 时写明「投委会 PPT」或「路演材料」；同时需要两种产物时，应一并说明。未指定时默认只输出文字分析，不生成文件。
明确数据口径。 在任务中注明「用插件数据源拉取最近四个季度的财务数据，标注来源与取数日期」即可，无需自行准备数据。
明确 PPT 的可编辑要求。 写明「所有元素可编辑的 .pptx，不要图片贴片」，可降低产出退化为整页图片的风险。
第 5 步：取回产物并核对
会话回到 idle 后，通过产物接口取回交付物：
cURL：
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"CLI：
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 重新订阅，以继续读取，详见 事件流。