English

教程 2 / 6

设置全局默认值

选择共用的模型配置和各任务的数据目录,保存后重启控制台,让设置生效。

先记住这一点

保存不等于生效:必须重启控制台服务。全局设置只补齐 console.json 没写的值,工作流自身的设置优先。全局建议文件目前只保存选择,不会影响运行。

开始之前

  • 已经安装 SIDERIUS,并按第一个工作流教程连接过控制台。
  • 知道运行控制台的服务器和自己的项目目录,能够编辑 console.json 并重启服务。

目标

为未单独配置的任务选一份共用模型配置,并为任务选择数据目录。完成后,你能分清已经保存的设置和当前实际使用的设置。

步骤

  1. 第 1 步:准备工作区

    从 SIDERIUS 代码目录执行下面的命令,把 /absolute/project 换成你自己的项目绝对路径。如果已经用这个命令初始化过,可继续使用原工作区;再次运行只补齐缺失内容。

    .venv/bin/python -m tools.candidate_console init --workspace /absolute/project

    在新工作区的 settings/console.json 中登记任务。初始化会保存并选中标准模型配置,但不会创建或填充 data/<task_id>/,任务数据目录需要你自己准备。

    你应该看到:项目下有 siderius_workspace,命令打印配置文件和令牌位置。

  2. 第 2 步:启用设置并连接

    确认 console.json 包含 "global_settings": {"browser_writable": true}。初始化会将它写入新配置;已有配置需要自己补上。检查后启动服务,在浏览器的 Settings 页连接控制台。

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

    你应该看到:Settings 可以保存设置,页面显示正确的服务器。

  3. 第 3 步:选择模型和数据目录

    在 Models 选择配置,用 Show routes 查看各步骤调用的模型。在 Data folder 选择该任务允许使用的根目录,打开需要的子目录,点 Use <folder>。所有路径都在服务器上。符号链接会显示出来,但不能选。

    如果看不到需要的选项,让控制台维护者在 console.json 的 llm_profiles 或 data_roots 中登记。模型配置也可以通过 Import from this computer… 导入 JSON 文件,检查通过后会存到服务器的 library/llm/。

    你应该看到:已选好需要的模型配置和任务数据目录,还没有改变当前生效值。

  4. 第 4 步:保存并重启

    点击 Save settings,看到 Saved; active after server restart 后,停止控制台服务,再运行相同的 serve 命令,重新连接。检查 Values in effect。若保存时提示别人刚修改过,点 Reload 后重新选择。

    例如,全局选了配置 A,而任务的 console.json 已指定 B,重启后该任务仍使用 B。这时应查看来源,而不是反复点保存。

    你应该看到:Values in effect 显示重启后实际使用的值和来源。

  5. 第 5 步:保存建议,按需导出

    Advice 下的 Import from this computer… 接受命令行格式的建议文件,也接受之前导出的文件。可以选文件或 None,但全局选择目前只保存,工作流仍使用自己写入的建议。

    在 Export a workflow 选择项目、任务和导出名称,点 Export,再用 Download 下载文件。服务器会保存 llm.json、workflow.py;工作流有建议时还会保存 advice.json。导出采用当前生效值,不包含等待重启的设置或密钥。

    你应该看到:你知道建议是否会影响运行,也能把当前配置下载下来。

完成后应该看到什么

重启后的 Values in effect 显示所选默认值,明确覆盖它们的任务仍保留自己的设置。以后准备运行前,先确认这里的值和来源符合预期。

查看全局设置参考:目录布局、优先级和导入导出