智能体

智能体让你以可视化方式构建交易自动化，而无需编写完整的策略脚本。在 QuantCraft — Agents 画布上，你把节点连接起来：获取数据、做出决策（用规则或 AI 提示词）、下单、发送提醒——然后把整个流程作为历史回测或前向（实盘／模拟）运行来执行。Agents 功能控制 Agents 页面、其导航链接和弹出窗口；从图表的 Agents 菜单运行智能体，以及 AutoTrading 的 New Agent Bulk Run，无论如何都可用。

从导航栏打开 Agents（或将编辑器弹出为独立窗口）。智能体依赖 QuantCraft 的其他部分：AI 助手驱动 AI Prompt 节点；回测使用模拟账户，前向运行可以向你选定的已连接券商账户提交订单。

智能体类型

Create agent 会询问你想要哪种类型，然后询问名称：

当该功能被关闭时，Test 和 Optimization 智能体会显示“Not available in this build.”。

---

节点类型

从选择器中添加节点（Schedule trigger 会为你自动创建，不在选择器中）。

门控节点是 Strategy 和 AI Prompt——它们产生一个布尔值，并控制其子节点是否运行。

---

构建智能体

1. 在侧边栏中创建智能体（Create agent → Trading Agent → 命名）。它以 Draft 状态出现，并已放置好一个 Schedule trigger。
2. 添加节点——点击节点的 +（添加子节点）按钮，或右键点击节点 → Node Actions → New Child Node。选择器只提供对你所点击的节点来说有效的子节点（例如，Execution 节点只会出现在 Strategy 或 AI Prompt 节点之下，而 Execution 节点只提供 Notification 子节点）。
3. 连接节点——把某个节点的重新指定父节点手柄拖到另一个节点上。规则：
   • 一个节点最多可以有 2 个父节点。
   • 不允许出现环。
   • Data 节点会成为它所供给的门控节点的父节点。
   • Execution 节点只能挂靠到 Strategy 或 AI Prompt 节点，其子节点只能是 Notification 节点。
   • 点击一条边即可删除该连接。
4. 配置节点——点击它以打开抽屉式检查器，其中有因类型而异的标签页（Rules / Sources，外加 Output；Strategy 和 AI Prompt 还有 Received data 标签页）。Trigger、Strategy 和 Execution 节点还有 Parameters 标签页——参见暴露的参数。每个规则或数据源行都可点击编辑。
5. 设置上游门——对于门控节点的子节点，抽屉会显示一个 Upstream gate 摘要。打开它可以选择各父节点如何组合（AND / OR），以及每个父节点必须产生什么结果（true / false）。惯例：入场以 true 门控，对应的出场以 false 门控。

数据沿图向下流动：Strategy 或 AI Prompt 节点会读取其上方每个 Data 节点的所有 OHLCV、基本面和因子数据。

想用文字来描述智能体？请使用 AI Builder。

---

配置节点

Schedule trigger

对于回测，计划由 Test 对话框的 Scheduler 标签页设定，它会覆盖此节点。节点的计划适用于前向运行。

数据源

一个 Data 节点可以同时持有多个数据源。

模式描述脚本或 URL 返回的 JSON；其字段就是 Strategy 节点的 Custom data 项可供比较的内容。未填写就保存会显示“Enter a JSON response schema.”

每个节点最多允许一个 Fama-French 数据源，以及每个报告期最多一个 Fundamentals 数据源。

Strategy 项

Strategy 节点组合一个或多个项。可用的项类型取决于上游的 Data（例如，Indicator 规则需要上游有 OHLCV，Fundamentals 项需要上游有基本面数据源）。

项类型：Script、Indicator、Fundamentals、Trade Activity、Account Status、Custom data、Fama-French。

比较运算符

指标——完整的图表指标注册表都可使用。单输出指标包括 SMA、EMA、WMA、RSI、ATR、OBV、VWAP、CCI、ROC、Williams %R、Parabolic SAR、HMA、DEMA、TEMA、Supertrend、VWMA、MFI、Awesome Oscillator、CMF 和 A/D Line。多输出指标——Bollinger Bands、MACD、Stochastic、Donchian、ADX、Ichimoku、Keltner、Stochastic RSI 和 PPO——可以让你选择要比较哪条线（例如 MACD 线与其信号线）。参见指标序列。

Trade Activity 指标：未平仓交易数量、未平仓交易总数量，以及限定在当前标的上的相同计数。 Account Status 指标：权益（equity）、余额、浮动盈亏。

使用 Combine items with（节点级）和 Combine rules with（每项）以 AND 或 OR 连接条件。

Execution 动作

每个动作是 Entry (open)、Exit (close) 或 Script。标的来自运行配置——你不需要在这里输入。

Entry（下单）

**Exit（平仓）：**数量（股）或头寸的百分比。 **Script：**运行一个 QuantCraft Agent Script。

Notification

规则会向收件人发送一封电子邮件，可附带可选的自定义消息和 Include Previous Node Output 开关。节点级的 Disable in Backtest 开关会在 Agent Test 期间跳过邮件。

---

回测智能体

点击编辑器标题栏中的 Test 以打开 Test agent (backtest)。

Setup 标签页

Scheduler 标签页

Scheduler 标签页仅在回测中替代 Schedule trigger 节点；前向运行仍遵循该节点。

Optimization 标签页——当智能体有暴露的参数时出现。勾选 Run as optimization 以搜索它们（网格或遗传），而不是只运行一次；此时按钮显示为 Start optimization 而不是 Start test。

要求与控制

• 需要一个处于活动状态的已连接交易账户——它用于预取市场数据，因此没有它 Test 无法启动。
• 运行进行时，Test 按钮会变成 Pause / Resume 和 Stop。暂停在当前正在运行的节点结束后生效。
• 你上次使用的 Test 设置会被记住。

结果——成功时，标题栏会切换到 Test Results 标签页：带指标叠加的 OHLC 图表、交易历史、权益曲线和账户指标，以及适用时的 Screener 再平衡计划和拆股／股息行。多标的运行共用一个模拟账户，因此交易和指标是合并的（不是按标的分开）。每个节点的 Output 标签页会实时输出日志（获取的数据、策略通过／失败、AI 回答、订单成交、邮件意图）；Strategy 和 AI Prompt 节点还会在其 Received data 标签页中显示确切的输入。

---

暴露的参数与优化

在 Trigger、Strategy 或 Execution 节点上，Parameters 标签页让你把数值设置（间隔、指标周期、阈值、订单规模……）标记为暴露（exposed），并设定一个范围。暴露的参数就是 Test 对话框的 Optimization 标签页所搜索的对象，也是 AI 优化智能体所调整的对象。网格搜索和遗传搜索的工作方式，参见优化。

---

AI Builder

Trading 智能体标题栏中的 AI Builder 按钮（闪光图标）会在画布旁打开一个聊天窗口。用普通语言描述智能体，你已连接的 AI 模型就会为你添加、配置和连接节点——还可以向你的工作区写入 Agent Scripts。

• Ask 模式回答关于图的问题而不改变它；Build 模式则进行修改。
• 修改实时生效，每条回复都有 Keep / Undo。
• 你可以在消息中附加文件。
• 它使用与 QuantCraft AI 相同的模型连接；其 token 用量计入该智能体的 token 徽章。

---

AI 测试与优化智能体

Test 和 Optimization 智能体没有节点图。你给 AI 一个目标——一个 IDE 算法或一个 Trading agent——外加 Instructions for the AI 和限制：Max iterations（一次迭代 = 一次回测；AI 会预先规划好全部迭代）、Max AI rounds、Max AI tokens 和 Max backtest windows。勾选 Allow market data tools 可让它使用 QuantCraft Tools（默认关闭）。你可以为指令附加文件。

启动之后，AI 会在它自己的 AI 控制的弹出窗口中工作——运行回测和优化，把发现保存到记忆中——并以一份总结结束。智能体页面有 Overview、Sessions、Windows 和 Memory 标签页，你可以追踪每个会话、查看其迭代计划和运行，并关闭窗口。

回测和优化结果——包括 AI 对其所做的总结——仅描述历史数据，并不保证实盘结果。

---

保存、管理与监控

• Save 会清除 Draft 徽章并保留图的已保存副本。每次编辑仍会在本地自动保存，但一旦你修改了已保存的智能体，Draft 徽章会连同一个 Undo 按钮一起返回，该按钮（在确认之后）会把图恢复到你上次保存的状态。
• 在侧边栏中，右键点击智能体可进行 Rename、Duplicate 或 Delete。复制会把图克隆为新的草稿。
• 以文件形式分享智能体（桌面应用）：标题栏的 ⋯ 菜单有 Export…，将智能体保存为 .qca 文件；侧边栏菜单有 Import…，用于加载一个或多个 .qca 文件。导入时，Agent Script 引用会重新链接到你的工作区。
• 运行期间，每个节点卡片都会显示实时状态徽章——等待中、运行中、ok、失败或跳过——并把事件流式输出到其 Output 标签页。

---

须知

• 回测与前向执行。智能体的 Test（回测）使用模拟的模拟账户。前向运行（图表 Agents 菜单、AutoTrading 的 New Agent Bulk Run）使用选定的已连接券商账户，并且在该账户为实盘时可以提交真实订单。QuantCloud 运行器只运行 IDE 算法——不运行智能体。
• **计划在运行启动之后才生效。**编辑器不会在后台自动启动智能体。在你启动前向／批量／图表运行之后，节奏来自 Schedule trigger（回测则来自 Test 对话框 Scheduler 的覆盖设置）。
• **结构限制：**每个节点最多 2 个父节点，没有环，Execution 节点只能挂靠到 Strategy 或 AI Prompt 节点，且 Execution 节点的子节点只能是 Notification 节点。
• 回测中的基本面数据仅限 Premium（启用时，与其他基本面数据界面使用相同的免费数据访问）。

---

另请参阅

• QuantCraft AI——AI Prompt 节点及其模型的选择方式
• QuantCraft Tools——AI Prompt 节点和 AI 智能体可以调用的只读工具
• AutoTrading——Agent Bulk Run 和本地前向监控
• Screener——按基本面数据筛选股票，用作批量运行目标
• 账户模型——模拟账户、指标、佣金／滑点
• 基本面数据——基本面数据
• Fama-French 因子——Fama-French 因子
• 指标序列——图表指标叠加