跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.osmosis.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
什么是 Osmosis 工作区？

Osmosis 工作区是一个本地项目目录，用于开发 AgentWorkflow 和 Grader 代码。它提供了一个标准化的结构，用于组织 rollout、配置、数据集和 AI 编码助手指令 —— 包含您在本地迭代 agent 行为所需的一切，然后再同步到平台进行训练。 工作区通过 osmosis init 命令创建，并通过 Git Sync 连接到 Osmosis 平台。
在 Osmosis 生态系统中有两种”工作区”：
  • 本地工作区 —— 通过 osmosis init 在您的机器上创建的目录。您在这里编写和测试 AgentWorkflow、Grader 和配置。
  • 平台工作区 —— Osmosis 平台上的远程组织空间，用于管理数据集、训练任务、模型和团队成员。通过 osmosis workspace 命令管理（参见 CLI 安装）。
本页文档介绍的是本地工作区。

​
快速开始

使用 osmosis init 创建新的工作区： 
osmosis init my-project
cd my-project
这会创建一个 my-project/ 目录，结构如下： 
my-project/
├── .osmosis/            # 工作区元数据和 AI 技能
├── rollouts/            # AgentWorkflow + Grader 代码
├── configs/             # 训练、eval 和 serve 配置
├── data/                # 本地测试数据集
├── pyproject.toml       # Python 项目配置
├── AGENTS.md            # AI 编码助手指令
├── CLAUDE.md            # Claude Code 指令
└── .gitignore
工作区同时会被初始化为一个 git 仓库并创建初始提交，可以直接推送到 GitHub。 详细的文件和目录说明请参见结构与配置。

​
--here 标志

如需将当前目录初始化为工作区，而不是创建子目录： 
mkdir my-project && cd my-project
osmosis init my-project --here
当前目录必须为空（允许已存在 .git/ 目录）。

​
名称验证

工作区名称只能包含小写字母、数字和连字符，最长 64 个字符。名称不能以连字符开头或结尾。 
有效:    my-project, agent-v2, data-extraction-tool
无效:    My-Project, -agent, agent_, my project

​
下一步

编写 AgentWorkflow

定义在训练 rollout 期间运行的 agent 循环。

编写 Grader

创建评估逻辑，为 RL 训练中的 agent 输出评分。

本地运行 eval

在提交训练前，使用数据集测试您的 agent。

同步到平台

推送到 GitHub，让平台自动同步您的 rollout 代码。