跳转到主要内容

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.

​
概览

您的本地工作区是一个 git 仓库 —— osmosis init 会自动运行 git init 并创建初始提交。将仓库推送到 GitHub 并连接到 Osmosis 平台，即可同步您的 rollout 代码用于训练。 连接完成后，每次推送时平台都会自动从 rollouts/ 目录中发现并同步 AgentWorkflow 和 Grader 定义。

​
设置步骤

1

将工作区推送到 GitHub

创建 GitHub 仓库并推送您的工作区：
gh repo create my-project --private --source=. --push
或添加已有的远程仓库：
git remote add origin git@github.com:your-org/my-project.git
git push -u origin main
2

在平台中打开 Git 集成

前往 Osmosis Platform，导航至 Integrations > Git。
3

安装 Osmosis GitHub App

点击 Connect GitHub，按提示在您的 GitHub 组织或账号上安装 Osmosis GitHub App。授予您要同步的仓库的访问权限。
4

连接仓库

从列表中选择仓库并连接到您的平台工作区。平台将立即执行首次同步。

​
同步机制

  • 推送到默认分支（通常是 main）会触发自动同步。
  • 平台会发现仓库 rollouts/ 目录中的 rollout 定义。
  • 每个 rollout 子目录（例如 rollouts/my-rollout/）会成为平台上的一个 rollout 实体，可用于训练和评估。
  • configs/ 下的配置文件也会被同步，以便 osmosis train submit 可以通过路径引用。
Git Sync 就是训练的代码源。当您运行 osmosis train submit 时，平台从同步过来的仓库读取 rollout 代码，而不是从您本地的工作区读取。未提交、未推送或未同步的本地修改不会被训练任务读取。

​
同步状态

您可以在平台 UI 的 Integrations > Git 中查看同步历史。每个同步事件显示以下状态：
状态含义
Pending检测到推送，同步已排队
Syncing平台正在处理仓库内容
Success所有 rollout 同步成功
Failed同步遇到错误（查看日志了解详情）
平台 UI 中提供手动 Sync 按钮，可在不推送新提交的情况下触发重新同步。

​
重要注意事项

  • 只有推送到默认分支才会触发自动同步。推送到功能分支在合并前会被忽略。
  • 如果在 Git 集成设置中停用了某个仓库，该仓库中的所有 rollout 将在平台上变为非活跃状态。
在训练配置中使用 commit_sha 可以将训练任务固定到特定提交，确保即使您继续推送更改，训练也具有可复现性。