Rollouts

Rollout 是 Osmosis 评估和训练的 agent 行为单元。它把两部分连接在一起：定义 agent 如何处理 prompt、调用模型和使用工具的 AgentWorkflow，以及把每个结果打分为数值 reward 的 Grader。当您提交 evaluation run 或 training run 时，平台会为 dataset 的每一行执行一次 rollout，并对其产出进行评分。在 Multiply 快速入门中，multiply-local-openai 就是一个 rollout：它的 AgentWorkflow 让模型解答乘法 prompt，它的 Grader 将答案与该行的 ground_truth 进行比对。

Rollout 包含什么

Rollouts 是您 workspace 仓库中的代码，每个 rollout 在 rollouts/ 下占一个目录，并由评估和训练配置引用：

repository/
├── rollouts/
│   └── my-rollout/
│       ├── main.py        # explicit workflow, grader, config, and backend wiring
│       └── pyproject.toml # rollout-local dependencies
├── configs/
│   ├── eval/
│   │   └── my-rollout.toml
│   └── training/
│       └── my-rollout.toml
└── data/
    └── test.jsonl

组成部分	作用	了解更多
`AgentWorkflow`	定义 agent 行为：prompt 处理、模型调用和工具使用	AgentWorkflow
`Grader`	把每个结果转化为驱动训练的 reward 信号	Grader
评估与训练配置	让 run 指向 rollout、入口点、模型和平台 dataset	配置文件

关于 rollout 的完整定义——包括执行后端以及 rollout 在训练循环中的位置——请参阅 SDK 概览。

Rollouts 页面

Platform 的 Rollouts 页面列出从已连接的 workspace 仓库发现的所有 rollouts。Git Sync 会扫描每个已 push 分支的 rollouts/ 目录，每个子目录成为一条记录，显示名称、最近同步的 commit 和最近同步时间。选择一个 rollout 会在 GitHub 上打开其同步 commit 对应的源码。每个分支有自己的 rollout catalog。分支选择器默认选中仓库默认分支。

Rollouts 页面需要已连接的 workspace 仓库。如果尚未连接仓库，请在 Git Integration 中完成设置——参见入门引导。

创建 Rollout

Rollouts 通过代码创建，而不是在控制台中创建。New Rollout 会显示在本地 workspace clone 中生成脚手架的 CLI 命令：

osmosis rollout init <name>

Commit 并 push 生成的文件；分支同步后，该 rollout 就会出现在 Rollouts 页面上。您也可以通过 CLI 列出已同步的 rollouts：

osmosis rollout list [--branch NAME]

要使用 AI 编码 agent 为您自己的任务构建 rollout，请遵循自定义 Rollout 指南。

下一步

SDK 概览

理解 rollout 定义、核心抽象和训练循环。

自定义 Rollout 指南

使用 workspace Agent Skills 创建面向特定任务的 rollout。

Git Sync

了解 push 的分支如何填充 rollout catalog。

命令参考

查看 rollout init 与 rollout list 的选项。

开始使用

运行

资源

工作区

Rollout 包含什么

Rollouts 页面

创建 Rollout

下一步

SDK 概览

自定义 Rollout 指南

Git Sync

命令参考

​Rollout 包含什么

​Rollouts 页面

​创建 Rollout

​下一步

SDK 概览

自定义 Rollout 指南

Git Sync

命令参考

Rollout 包含什么

Rollouts 页面

创建 Rollout

下一步