WorkBuddy 可以把自然语言任务拆成多个步骤,调用连接器和工具,处理本地或云端文件,再交付报告。官方文档也已经提供自定义连接器和 MCP 服务管理能力。

这让“每天自动生成 A股复盘”从一个提示词问题,变成了一个可以落地的工程问题。

真正的难点不在于能否成功调用一次行情接口,而在于它能否连续运行:周末会不会把旧数据写成今天,空数组会不会被当成市场没有涨停,某个工具失败后会不会继续编造结论,报告是否能保留数据时间和失败记录。

本文给出一套 WorkBuddy 股票数据工具层的接入与验收方法。示例使用悟道 A股股票数据 MCP,但验收思路同样适用于自己封装的 Tushare、AkShare 或内部数据库工具。

1. 先定义数据层与 Agent 的职责

一个稳定的自动复盘任务可以拆成四层:

WorkBuddy 任务层
  -> MCP / Connector 工具层
  -> A股结构化数据层
  -> Markdown、表格或网页报告

每一层只解决自己的问题:

  • WorkBuddy 负责拆任务、选择工具、组织结果和交付文件;
  • MCP 工具层负责暴露工具名称、参数 schema 和结构化返回;
  • 数据层负责行情、K 线、涨停梯队、题材、资金、龙虎榜和事件等事实数据;
  • 报告层负责固定格式、审计信息和归档。

不要让提示词承担本该由数据层解决的问题。例如,提示词无法保证某个网页结构永远不变,也无法把没有时间戳的数据变成真正的实时数据。

2. 在 WorkBuddy 中连接 MCP

WorkBuddy 当前把外部服务作为连接器管理,并支持安装自定义 MCP 服务。不同版本的入口和字段展示可能变化,应以客户端当前界面为准。

以悟道 A股股票数据 MCP 为例,核心连接信息如下:

{
  "mcpServers": {
    "wudao-stock-data": {
      "url": "https://stock.quicktiny.cn/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

注意这里使用的正式入口是:

https://stock.quicktiny.cn/api/mcp

API Key 应放在 WorkBuddy 连接器的静态请求头或密钥配置中,不要写进任务提示词、报告或公开仓库。

连接完成后的第一项验收不是立即问“今天买什么”,而是检查工具发现结果。悟道数据当前通过 MCP 暴露 63 个远程只读工具,WorkBuddy 应该能够读取工具名称、描述和参数,而不是只显示“连接成功”。

3. 用最小调用验证连接

建议按以下顺序验证:

  1. 工具列表是否能够正常加载;
  2. 一个无参数或少参数的市场概览工具能否调用;
  3. 一个需要股票代码的工具能否正确校验参数;
  4. 错误代码、无权限和限流是否有明确提示;
  5. 返回结果里能否找到实际交易日或更新时间。

不要一开始就运行包含十几个工具的长流程。最小调用失败时,长任务只会产生更多噪声。

4. 日期语义是第一道生产门槛

自动复盘最常见的错误,是把“请求日期”和“实际数据日期”混为一谈。

一个适合 Agent 的返回结构至少应该表达这些信息:

{
  "requestedDate": "2026-08-15",
  "actualTradeDate": "2026-08-14",
  "asOf": "2026-08-14T15:00:00+08:00",
  "status": "ok",
  "data": {}
}
  • requestedDate:用户或任务请求的日期;
  • actualTradeDate:结果真正对应的交易日;
  • asOf:这批数据更新到什么时间;
  • status:本次调用的业务状态。

在周末、节假日和收盘后更新窗口,这几个字段比“接口返回了 200”更重要。

5. 不要把所有空结果都当成空数组

Agent 需要区分至少六种状态:

type ToolStatus =
  | "ok"
  | "empty"
  | "not_ready"
  | "forbidden"
  | "rate_limited"
  | "error";

它们对应的处理方式完全不同:

状态 WorkBuddy 应该怎么做
ok 继续分析并记录数据时间
empty 如实写明无记录,不补造内容
not_ready 延后任务或标记数据尚未更新
forbidden 停止相关步骤并提示权限问题
rate_limited 按规则等待,避免高频重复调用
error 记录失败,不基于缺失数据下结论

如果数据源没有提供统一状态,上层适配器也应该把 HTTP 状态、异常和空结果转换成明确的业务语义。

6. 给 WorkBuddy 一份“失败也算完成”的任务契约

自动任务不应该只有成功路径。下面这段指令可以作为初始模板:

请使用已连接的 A股数据工具完成最近一个已收盘交易日的市场复盘。

执行规则:
1. 先确认实际交易日和数据更新时间;
2. 查询市场概览、涨停梯队、题材、资金线索和自选股变化;
3. 事实数据和分析判断分开书写;
4. 任一关键工具失败时,不要猜测数字,在报告顶部列出失败工具、状态和影响范围;
5. 如果实际交易日不符合预期,停止生成结论,只输出数据状态说明;
6. 保存 Markdown 报告,并在文末保留生成时间、实际交易日和数据来源;
7. 只做研究资料整理,不生成交易指令。

“失败也算完成”的含义是:数据不可用时,任务仍然交付一份清楚的失败报告,而不是卡住、静默结束或生成一篇没有依据的分析。

7. 控制工具范围,避免 Agent 乱调用

工具多不等于每次都要全部开放。更稳妥的做法是按任务建立工具白名单。

例如盘后市场复盘只需要:

  • 市场概览;
  • 涨停统计与连板梯队;
  • 题材或板块强度;
  • 资金线索;
  • 指定自选股的行情和事件。

个股深度研究再单独开放 K 线、财务、公告、龙虎榜等工具。这样既能减少无效调用,也能降低不同工具口径混用的概率。

8. 上线前必须覆盖的 8 个边界测试

测试场景 预期结果
正常交易日收盘后 返回当日完整数据并生成报告
交易日盘中 明确数据仍在变化,不冒充收盘结果
周末查询“今天” 返回最近交易日并显式标注
法定节假日 不生成虚构行情
数据尚未更新 返回 not_ready 或同等语义
API Key 无效 明确鉴权失败,不反复重试
单个工具超时 报告列出缺失项和影响范围
全部数据工具不可用 只交付故障说明,不生成市场结论

这 8 个测试通过后,再考虑定时运行、消息推送和周报汇总。

9. Tushare、AkShare 和现成 MCP 怎么选

如果团队已有数据工程能力,Tushare、AkShare 或内部数据库都可以封装成 WorkBuddy 可调用的工具。优点是口径和缓存策略完全可控,代价是需要维护脚本、鉴权、限流、错误状态和工具 schema。

如果目标是先验证 WorkBuddy 的 A股复盘流程,可以评估悟道数据这类现成的股票数据 MCP。它把 63 个 A股结构化能力整理为远程工具,省去一部分适配工作,但仍然要按照本文清单验证日期、状态、字段和权限。

MCP 只是连接协议,不会自动解决数据质量问题;WorkBuddy 也只是执行与交付层,不应该替代数据源的事实责任。

结论

WorkBuddy 接入股票数据的最低标准,是“能调用”;能够长期运行的标准,则是“日期可验证、错误可解释、工具范围可控、报告可以审计”。

先用一个市场概览工具跑通连接,再验证周末、空数据、无权限和超时,最后才组装完整复盘。这个顺序看起来慢一点,却能避免自动任务每天稳定地产出错误内容。

本文只讨论数据工程、MCP 接入和自动化验收,不构成投资建议。

参考资料

  • WorkBuddy 官方简介:https://www.workbuddy.cn/docs/workbuddy/Overview
  • WorkBuddy 连接器文档:https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Connector
  • 悟道数据 WorkBuddy 接入页:https://data.quicktiny.cn/workbuddy-stock-data-mcp.html
  • 悟道数据 Agent 发现说明:https://data.quicktiny.cn/agent-discovery.html
Logo

欢迎加入 MCP 技术社区!与志同道合者携手前行,一同解锁 MCP 技术的无限可能!

更多推荐