DojoAgents API 参考完全指南Chat API、dojo.v2 协议与 DojoSDK 金融取数实战【免费下载链接】DojoAgentsDojoAgents: Full-Market AI Copilot for Personal Investment项目地址: https://gitcode.com/gh_mirrors/do/DojoAgentsDojoAgents 是一个面向个人投资的「全市场 AI Copilot」其 API 体系由三部分组成兼容 OpenAI 格式的 Chat API、可观测 Agent 全过程的 dojo.v2 事件协议以及专为 Agent 设计的 DojoSDK 金融取数工具。本指南帮你快速掌握 DojoAgents API 的核心用法从一条请求发起对话到读取类型化事件再到用 dojo.sdk.* 工具拉取 K 线、板块与财务数据。 三大入口先看清整体格局DojoAgents Dashboard 后端基于 FastAPI所有接口都注册在 server.py 中分为三层层级入口用途Agent 对话POST /api/chat主 Agent 入口兼容 OpenAI Chat Completions 格式运行生命周期/api/chat/runs/*创建、查询、取消后台 run并回放事件流金融领域数据/api/v1/*市场概览、板块、个股、组合等产品级 REST 接口官方参考文档Chat API、dojo.v2 协议、DojoSDK、Dashboard API Chat API 快速上手一条请求开启 AI 对话POST /api/chat支持两种请求格式。推荐使用OpenAI 兼容格式——这样任何现成的 OpenAI SDK 都能直接对接 DojoAgents{ model: default, messages: [ {role: user, content: 帮我分析今天的市场结构} ], stream: true, metadata: { session_id: session-123, event_format: dojo.v2, locale: zh } }关键解析规则详见 chat-api.mdmessages必须非空最后一条非空user消息作为本轮输入之前的消息自动进入历史上下文metadata.session_id缺省时由后端自动生成metadata.event_format可取openai.v1默认或dojo.v2stream: true时返回 SSE 流每个data:chunk 兼容 OpenAIchat.completion.chunk格式服务端实现位于 server.py#L534-L598流式模式下 Agent 在后台任务中运行事件通过队列推送给客户端因此对话不会阻塞。 dojo.v2 协议读懂 Agent 的每一步动作这是 DojoAgents API 的精华所在在不破坏 OpenAI 兼容性的前提下附加类型化事件流让你精确知道 Agent 何时思考、调用了什么工具、花了多少 token。请求中只要加上event_format: dojo.v2响应就会携带结构化事件。三种传输形态模式传输方式事件位置streamfalse普通 JSONmetadata.dojo.eventsstreamtrueSSEchunk 上附加dojo_event字段/api/chat/runs/{run_id}/eventsSSE每条data:直接是事件 JSON核心事件类型速查每个事件都包含schema_version当前为2.0、run_id、seqrun 内递增序号等公共字段客户端用(run_id, seq)即可去重排序phase—— Agent 阶段切换planning / tooling / answeringdelta—— 模型输出文本增量tool_start/tool_result—— 工具调用开始与结束通过call_id关联think_start/think_delta/think_end—— 思考过程可脱敏token_usage—— session 级 token 账本快照含上下文压缩阈值done/error—— run 成功结束或失败其中tool_result还携带展示能力data结构化结果、viz_blocks可视化块、artifacts产物、latency_ms耗时。这意味着你可以构建完全自研的 Agent 前端不用解析自然语言直接按事件类型渲染 UI。协议细节与完整字段表见 dojo-v2-protocol.md事件定义源码在 events.py。后台 Run断线也能续读除了同步聊天你还可以创建后台 run 再异步消费事件MethodPath说明POST/api/chat/runs创建后台 run返回run_idGET/api/chat/runs/{run_id}查询 run 状态GET/api/chat/runs/{run_id}/events?cursor0从指定序号以 SSE 续读事件POST/api/chat/runs/{run_id}/cancel取消运行中的 run配合dojo.v2协议前端刷新页面后凭run_idseq即可无损恢复现场。 DojoSDK 金融取数Agent 的只读数据主路径Dashboard 的/api/v1/*REST 接口服务于产品 UI而Agent 和金融 Task 取数的目标主路径是 DojoSDKdojo.sdk.*工具族通过 dojo_sdk_tool.py 注册为 Agent 工具走 HF offline / qdata 数据链路。常用 dojo.sdk.* 工具清单工具能力典型用途dojo.sdk.stock.kline个股 K 线单票走势分析dojo.sdk.stock.current_quote当前报价实时行情解读dojo.sdk.stock.news单票新闻分页事件驱动的个股研究dojo.sdk.stock.fin_indicators财务指标基本面分析dojo.sdk.sector.info板块 taxonomy行业层级定位L1/L2/L3dojo.sdk.sector.symbol_relations板块↔股票关系成分股粗定位dojo.sdk.sector.precomputed_sector_alpha_factors_daily板块 alpha 因子板块强弱定量佐证dojo.sdk.benchmark.kline基准指数 K 线相对大盘表现dojo.sdk.forex.kline外汇 K 线跨市场联动分析完整工具表、数据流与能力规划见 dojo-sdk.md。预计算 → 取数一条自动链路DojoAgents 还有一个值得新手了解的机制预计算产物直接喂给 SDK 消费。CLI 命令dojoagents precompute-sector*会生成dojo_sector_precomputed/数据集成分股、板块日线、个股日线、主题状态、alpha 因子等随后 Agent 通过dojo.sdk.sector.precomputed_*工具按date/market/L1–L3精确过滤查询而不是整表拉取。相关 CLI 与任务文档financial-workflows.md、tasks-and-pipelines.md️ 常见错误与避坑指南现象原因与解决422错误messages为空或没有非空user消息legacy 请求缺少message/user_id/session_id404错误找不到 session、run、ticker 或 portfolio请检查 ID 是否正确客户端只收到纯文本未设置event_format: dojo.v2默认走openai.v1格式事件乱序/重复用(run_id, seq)去重排序工具事件用call_id关联历史消息还原用/api/v1/chat/sessions/*查询不要用 token 接口还原 transcript一个高频误区/api/v1的 REST 路由名 ≠ Agent 工具名。Agent 金融取数应优先走dojo.sdk.*/api/v1/*domain 接口是 UI 配套不要在新 Task 中反向依赖。 模块路径速查关注点位置Chat API 与 Run 生命周期实现server.pydojo.v2 事件定义events.py、models.pyDojoSDK 工具注册dojo_sdk_tool.py金融领域路由routers/请求/响应 Schemaschemas/Dashboard 启动方式dojoagents dashboard --host 127.0.0.1 --port 8765 小结想快速接入用 OpenAI 兼容格式打POST /api/chat零改造成本想构建自研前端开启dojo.v2消费类型化事件流工具调用、token 用量、阶段切换一目了然想让 Agent 取数注册并调用dojo.sdk.*工具族配合预计算数据集做板块与个股研究掌握这三层 API你就拥有了从「对话」到「数据」的完整 DojoAgents 集成能力。更多细节可查阅 reference 文档目录。【免费下载链接】DojoAgentsDojoAgents: Full-Market AI Copilot for Personal Investment项目地址: https://gitcode.com/gh_mirrors/do/DojoAgents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考