#使用教程

#1. 控制台准备

1. 登录 控制台 ，完成 实名认证
2. 账户财务 → 充值，保证余额充足（每次拉数按产品单价扣费）
3. 智能报告 → MCP Key 创建密钥（sk-hyr- 开头），妥善保存

#2. 配置 Agent（MCP + Skill）

推荐使用 3 个远程 MCP + 1 份 Skill，详见 MCP 与 Skill，或打开 Agent 一键安装 复制配置。

#3. 推荐 Agent 工作流

与平台策划一致，按顺序调用三个 MCP 上的工具：

1. list_report_products — 查看已启用产品与场景；可选 category: enterprise / person
2. 选型 — 使用 list 返回的 productKey（勿使用或向用户展示上游接口编号）
3. get_report_product_guide — 阅读 fieldGuideMarkdown 与 reportWorkflow
4. fetch_enterprise_data — 传入 productKey 与 params
5. 撰写 — 先将 reportData 整理为结构化报表，再输出解读说明（见 guide 中的 reportWorkflow）

#4. 核对扣费

• 智能报告 → 报告使用记录 / 费用账单
• 与 模型 API 账单分开统计，余额共用

#5. 本地开发联调

Platform 默认 http://127.0.0.1:8080 时，将 MCP URL 主机改为本地，Key 仍为控制台创建的 sk-hyr-。

#常见问题

• Key 无效：检查 Header 是否为 Authorization: Bearer sk-hyr-...
• 列表为空：管理端是否启用对应产品
• 拉数失败：余额、海宇上游账号或入参错误

更多见 平台常见问题 与 智能报告 MCP 文档。