概览 - Osmosis AI Docs

什么是 Workspace？

Osmosis workspace 是团队在平台上管理数据集、训练任务、模型、deployments、成员和一个已连接 GitHub 仓库的空间。已连接的 GitHub 仓库就是 workspace repository。您的本地 clone 是 workspace directory。

术语	含义
Platform workspace	Osmosis Platform 中的团队空间。
Workspace repository	连接到该平台 workspace 的 GitHub 仓库。
Workspace directory	workspace repository 的本地 clone。

开始使用

从 Onboarding 开始，创建或加入平台 workspace、连接 GitHub、clone workspace repository，并认证 CLI。 Onboarding 完成后，您的本地 workspace directory 会包含标准 workspace 结构：

repository/
├── rollouts/            # AgentWorkflow + Grader code
├── configs/
│   ├── eval/            # Evaluation configs
│   ├── training/        # Training configs
│   └── benchmark/       # benchmark submit 的可选 configs
├── data/                # Local test datasets
├── pyproject.toml       # Python project config
├── AGENTS.md            # AI coding assistant 的 canonical instructions
├── CLAUDE.md            # Claude Code 指向 AGENTS.md 的 pointer
└── .gitignore

只有使用 osmosis benchmark submit 时才需要 configs/benchmark/。它不属于 osmosis doctor 检查或修复的必需 workspace scaffold。详细拆解请参见 Structure & Configuration。

CLI 上下文

默认情况下，CLI 会将平台命令限定到您当前所在的 workspace repository。它读取 Git origin，解析 GitHub owner/repo，并将该仓库身份发送到平台。

git remote get-url origin
osmosis dataset list

如果要从其他目录执行 platform-only 工作，root --workspace 可按名称精确选择 workspace：

osmosis --workspace <workspace-name> dataset list
osmosis --workspace <workspace-name> benchmark runs list

这种显式 scope 适用于完整 benchmark 命令族、platform dataset/model/secret commands，以及 train / eval 的 list、info、logs 和 stop。Source-backed eval submit 和 train submit 也可以从任意当前目录运行，只需传入匹配 repository 标准 config 目录中的绝对路径。本地 rollout workflow 仍需要 workspace directory。如果 CLI 无法解析 workspace，请运行：

osmosis doctor

典型本地循环

编辑或创建 rollout scaffold

osmosis rollout init <name>

Push 并同步

git add .
git commit -m "add rollout"
git push

运行本地 evaluation

osmosis eval run configs/eval/<name>.toml

通过 managed evaluation gate

osmosis eval submit configs/eval/<name>.toml

提交训练

osmosis train submit configs/training/<name>.toml

下一步

Workspace 仓库

了解 GitHub origin 如何将 CLI 命令限定到平台 workspace。

结构与配置

了解已 clone workspace repository 中的文件。

Git Sync

Push 到 GitHub，并让平台自动同步 rollout 代码。

开始使用

运行

工作区

参考

概览

什么是 Workspace？

开始使用

CLI 上下文

典型本地循环

下一步

Workspace 仓库

结构与配置

Git Sync

​什么是 Workspace？

​开始使用

​CLI 上下文

​典型本地循环

​下一步

Workspace 仓库

结构与配置

Git Sync

什么是 Workspace？

开始使用

CLI 上下文

典型本地循环

下一步