> ## 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 Python SDK 和 CLI 中影响用户的变更

本更新日志重点介绍会影响 rollout 安装、开发、evaluation 和 training 的 SDK 与 CLI
变更。它比规范的 [SDK changelog](https://github.com/Osmosis-AI/osmosis-sdk-python/blob/main/CHANGELOG.md)
更侧重实际任务；后者仍是完整的仓库发布记录。

<Info>
  Release candidate 会作为增量发布记录保留在时间线中。每个稳定版本都会提供相对上一个
  稳定版本的完整摘要，因此升级时无需先阅读每一条 release-candidate 记录。
</Info>

<Update
  label="2026 年 7 月 28 日"
  description="0.3.0rc1"
  rss={{
title: "Osmosis Python SDK 0.3.0rc1",
description: "引入单 sample rollout 契约，以及 rollout-scoped 模型与 callback 路由。",
}}
>
  `0.3.0rc1` 引入 0.3 rollout protocol。每次 workflow 执行现在只生成一个
  `RolloutSample`，grader 也只分配一个 reward。

  ### 变更内容

  * `GraderContext.samples` 改为 `GraderContext.sample`，
    `set_sample_reward(sample_id, reward)` 改为 `set_reward(reward)`。
  * 自定义 integration 通过 `set_sample_source()` 注册一个 source，并通过
    `get_sample()` 读取它。
  * 移除了 `RolloutSample.id` 和 `MultiTurnMode`。执行身份现在由 rollout URL 提供。
  * 模型和 callback 请求使用 rollout-scoped URL。Integration 不再为每次调用附加
    sample 或 rollout routing headers。
  * Backend 交换 `sample.json` 和只包含单个值的
    `reward.json`（`{"reward": <float>}`）。
  * Strands 和 OpenAI Agents integration 强制每次 workflow 执行只能注册一个 agent
    或 session。

  ### 谁需要采取行动

  如果你使用自定义 grader、自定义 sample source、backend adapter，或在一个 workflow
  执行中创建多个已注册的 Strands agent / OpenAI Agents session，请更新相关代码。
  Evaluation 和 training 仍可针对同一个 prompt 请求多次独立执行。

  请按照[从 v0.2 迁移到 v0.3](/zh/migration-guides/v0-3)中的前后对比代码和验证步骤完成升级。

  [SDK changelog](https://github.com/Osmosis-AI/osmosis-sdk-python/blob/main/CHANGELOG.md#030rc1---2026-07-28)
  · [GitHub release](https://github.com/Osmosis-AI/osmosis-sdk-python/releases/tag/v0.3.0rc1)
  · [完整 diff](https://github.com/Osmosis-AI/osmosis-sdk-python/compare/v0.2.30...v0.3.0rc1)
</Update>