你的第一次 DojoAgents Agent 运行：10 分钟从零生成首份跨市场大盘概览

你的第一次 DojoAgents Agent 运行：10 分钟从零生成首份跨市场大盘概览

【免费下载链接】DojoAgentsDojoAgents: Full-Market AI Copilot for Personal Investment项目地址: https://gitcode.com/gh_mirrors/do/DojoAgents

如果你想在 10 分钟内完成第一次DojoAgents Agent 运行，这篇文章就是为你准备的完整教程。DojoAgents 是一款面向个人投资的全市场 AI 智能助手（Full-Market AI Copilot），核心是强大的 Agent Loop 推理引擎——你只需用一句自然语言提问（例如"今天全球市场什么值得关注？"），它就能自主调用行情、板块、新闻等金融工具，跨 A 股、美股、港股拉取数据，最终在你的本地 Dashboard 里生成一份可视化的跨市场大盘概览。全程无需写代码，新手也能跟着走完。

一、运行前准备：3 个环境要求 ✅

在开始第一次 DojoAgents 安装之前，先确认本机满足以下条件：

建议同时安装uv。

二、最快安装方法：一条命令装好 DojoAgents 🚀

大多数用户无需克隆仓库，直接从 PyPI 安装发布包即可：

# macOS / Linux uv venv && source .venv/bin/activate uv pip install dojoagents # Windows (PowerShell) uv venv && .venv\Scripts\Activate.ps1 uv pip install dojoagents

安装完成后用dojoagents --help验证，能看到命令帮助即说明环境就绪。如果你希望从源码二次开发，可改用uv pip install -e ".[dev]"，源码入口在 dojoagents/cli/main.py。

三、模型配置指南：交互式填好你的 LLM 引擎 ⚙️

Agent 的"大脑"来自大语言模型。推荐使用 CLI 交互式配置，它会引导你选择 Provider、填写 Base URL、输入 API Key 并自动探测可用模型：

dojoagents model

配置会安全写入本地~/.dojo/agents.yaml，全程不出本机。预设支持 OpenAI、Anthropic、Google Gemini、智谱 GLM、DeepSeek，也兼容 Ollama、vLLM 等本地端点。更多字段说明见 docs/site/zh/getting-started/model-configuration.md。

四、启动 Dashboard：打开你的个人投资指挥中心 🖥️

模型配置好后，一条命令启动本地 Web 服务：

dojoagents dashboard --host 127.0.0.1 --port 8765

浏览器打开http://127.0.0.1:8765/，你看到的界面如下——Agent 对话区就是与智能体交流的地方：

💡 提示：Dashboard 启动后也可以在右上角设置图标里直接配置模型，效果与命令行配置一致。启动细节参考 docs/site/zh/getting-started/quickstart-dashboard.md。

五、发送第一条指令：见证 Agent 生成大盘概览 📊

在聊天输入框中，直接输入你的第一个分析任务：

今天全球市场什么值得关注？请生成一份跨市场大盘概览。

接下来几分钟内，你会亲眼看到 Agent 的"分析过程"逐步展开：

1. 拆解问题—— Agent 先把任务拆成"全市场涨跌、行业轮动、个股异动、资金情绪"几个维度；
2. 调用工具—— 自动调用dojo.sdk.*行情工具，拉取 A 股、美股、港股的异动板块与强势标的；
3. 实时展示—— 每一步工具调用、引用数据都可展开查看，杜绝"黑盒"；
4. 输出结论—— 最终生成结构化文字总结 + 图表可视化区块。

除了交互式聊天，你也可以用 CLI 一行发起 Agent 运行，无需打开浏览器：

dojoagents chat "Analyze BTC market structure" --market crypto --symbols BTC-USD --timeframe 1d

三种运行方式（CLI / Dashboard / API）的完整对照见 docs/site/zh/getting-started/first-agent-run.md。

六、常见问题：第一次运行遇到报错怎么办 🛠️

完整排错清单见 docs/site/zh/user-guide/dashboard.md。

七、下一步：从大盘概览到更深的投资研究 🧭

完成第一次运行后，你可以继续探索 DojoAgents 的更多能力：

• 突发新闻归因：问"某条消息会影响哪些股票？"，Agent 会跨市场定位受影响标的；
• 持仓截图诊断：上传一张多市场持仓截图，Agent 自动识别并生成组合风险诊断；
• 模拟组合生成：根据诊断结论生成新的观察组合并持续跟踪。

整体能力由七层架构支撑（CLI、Dashboard、网关、Agent Loop、工具执行、数据层、基础设施），架构全景图可参考 docs/imgs/structure.png 中的系统架构图，更深的架构解读见 docs/site/zh/architecture/agent-loop.md。

⚠️ 免责声明：DojoAgents 仅供教育、研究和演示使用，不提供投资建议。交易有风险，决策请自行负责。

现在，打开终端，10 分钟后你就能拥有自己的第一份 AI 生成的跨市场大盘概览。祝你研究愉快！

【免费下载链接】DojoAgentsDojoAgents: Full-Market AI Copilot for Personal Investment项目地址: https://gitcode.com/gh_mirrors/do/DojoAgents