SIDERIUSSIDERIUS

English

教程 1 / 5

用快速开始跑第一个工作流

为你的任务打开一个现成的研究循环，给提案智能体写一句建议，保存，然后运行。

先记住这一点

控制台把保存、准备和启动分成三步。保存和准备都不会运行任何东西；只有你点了启动，才会真正跑代码，也才可能产生模型调用费用。每次运行都会把当时的输入固定下来，所以之后再改工作流，只影响以后的运行。

开始之前

  • 已经完成安装（英文），并且有一个配置好任务的项目。还没有的话，先看教程 5。
  • 控制台的配置文件 console.json 已经写好，里面登记了这个项目，并且保存了一个 LLM 配置文件。照着控制台设置步骤 (opens in a new tab)做，或者让编程助手帮你写。
  • 启动之前，要用到的模型服务密钥已经按安装说明绑定好。

以此为准：控制台 README（英文） (opens in a new tab)

步骤

  1. 第 1 步：启动控制台并连接

    在 SIDERIUS 代码目录里先检查配置，再在一个不会关掉的终端里启动服务：

    .venv/bin/python -m tools.candidate_console check --config /absolute/project/console.json
.venv/bin/python -m tools.candidate_console serve --config /absolute/project/console.json

    服务只监听本机。如果它跑在远程机器上，先开一个 SSH 隧道，再在浏览器里打开 http://127.0.0.1:8740：

    ssh -N -L 127.0.0.1:8740:127.0.0.1:8740 YOUR_HOST

    把控制台令牌（token）粘进去，点 Connect。这个令牌只用来打开控制台，和模型服务的密钥无关。

    你应该看到：首页（Home）显示 Connected，下面有三个入口：Quick start、Open a workflow、Monitor runs。

  2. 第 2 步：用快速开始打开研究循环

    在首页的 Quick start 卡片上点 Choose a task。在 Project 下拉框里选你的项目（它自带任务和数据的位置），然后点 Open research loop。标着 “edit only, not runnable” 的项目只能编辑，不能从这个控制台运行。

    你应该看到：进入 Workflow 页，画布上是五个连好的模块：Interpret results → Propose model → Implement → Validate → Train & tune，还有一条从 Train & tune 回到开头的反馈线。页面标着 Unsaved changes，因为这还是草稿。

  3. 第 3 步：写一句建议

    光标已经停在 Propose model 的 Your advice to the agents 输入框里。写一句你知道的事或你的要求，比如 “先从小的、好解释的基线模型开始”。这段话会发给模型服务商，也会留在版本历史里，所以不要贴密钥。

    快速开始打开的是模板 “Single loop with your own advice”。这个模板已经把 Propose model 读建议的输入接好，所以你写的话会真正送到提案智能体。Implement、Validate、Train & tune 各自也有建议框，写了同样会送到对应的智能体。

    如果你改用普通的 “Single research loop” 模板，Propose model 的建议框下面会出现提醒：只有接上 “human_advice” 输入，它才会读你的建议。见教程 2。

    你应该看到：建议出现在 Propose model 的 Selection 面板（右侧显示选中模块的面板）里，下面没有黄色提醒，草稿多了一处改动。

  4. 第 4 步：看一眼默认设置

    • Research loop 面板：Final iteration 是 1，也就是只跑一轮，花费最少（见循环和路由）。
    • 选中 Train & tune：Run policy 里健康检查是 Record only，结果性质是 Diagnostic，适合第一次探索。

    想改轮数、预算或停止条件，看教程 2。

    你应该看到：你知道这次会跑几轮、结果算不算科学证据。现在不用改。

  5. 第 5 步：保存成一个版本

    点 Save。控制台会先检查工作流，并列出准确的 Python 改动。给这个版本起个名字（Version name），再点 Save version。保存写进去的，就是你刚才看到的那份文件。

    你应该看到：状态显示已保存，Next: Run 按钮变成可用。到这里还什么都没运行。

  6. 第 6 步：准备并启动

    点 Next: Run。第 1 步 Prepare：在 Task and resources 里选任务，填一个运行名（Run name），点 Check inputs 检查输入，再点 Prepare。准备好以后点 Open prepared run。

    第 2 步 Review and launch：点 Review prepared run，看输出目录、每个模块用的模型、密钥是否就绪（只检查名字，不显示密钥值）。准备好花钱了，再点 Launch run。

    你应该看到：运行页的步骤条走到 3 Follow in Monitor，页面上显示这次运行的编号（operation）。

  7. 第 7 步：在监控页跟进

    点 Watch in Monitor。怎么读结果、怎么停止运行，见教程 4。

    你应该看到：监控页显示这次运行的状态和日志。跑完不等于成功，要看验证和训练结果。

刚才跑了什么

每个模块做了什么、接收和发出什么，见功能总览里的完整例子和模块参考。