# PR #1942 完整报告

- 仓库：`THUDM/slime`
- 标题：update docs
- 合并时间：2026-05-25 16:13
- 原文链接：http://prhub.com.cn/THUDM/slime/pull/1942

---

# 执行摘要

- 一句话：更新文档说明 agentic workflow 集成方式
- 推荐动作：值得一读，尤其关注 customization 文档中的接口选择表格，它清晰展现了 slime 将 agentic 任务视为数据生成工作流的设计哲学。

# 功能与动机

随着 agentic RL 需求的增长，需要向用户清晰说明 slime 如何支持 multi-turn tool use、sandbox 等 agentic 工作流，避免用户误以为需要单独引入 agent 框架。PR body 仅写 "update docs"，但实际更新旨在降低用户理解成本和接入门槛。

# 实现拆解

1. **README 与 README_zh 概述更新**：在项目介绍段落增加 agentic 视角的定位说明，将 rolllout 和 data buffer 模块描述扩展，明确其可以承载 multi-turn loop、tool call、verifier 等能力。 
2. **customization 文档增加 agentic guide**：在 `docs/en/get_started/customization.md` 和中文对应文档中新增 "Agentic workflows through customization interfaces" 小节，以表格形式列出常见 agentic 需求（如自定义 agent loop、verifier reward、trace 调试）应使用的接口，并给出 native 示例引用（search-r1、multi_agent、fully_async）。 
3. **pd-disaggregation 与 trace 文档微调**：在 `pd-disaggregation.md` 中补充 PD 分离特别适合 agentic 场景的理由（长上下文、decode 重）；在 `trace.md` 中明确 trace 工具针对 agentic 自定义步骤的用法。 
4. **无测试、配置或部署配套变更**。

关键文件：
- `docs/en/get_started/customization.md`（模块 文档；类别 docs；类型 documentation）: 核心变更：新增 Agentic workflows 小节，包含接口选择表格和示例引用，是用户接入 agentic RL 的主要参考。
- `docs/zh/get_started/customization.md`（模块 文档；类别 docs；类型 documentation）: 中文版对应核心变更，内容与英文版同步。
- `README.md`（模块 文档；类别 docs；类型 documentation）: 项目首页更新，增加了 agentic 视角的概述和示例列表，帮助新用户快速理解框架定位。
- `README_zh.md`（模块 文档；类别 docs；类型 documentation）: 中文版项目首页同步更新。
- `docs/en/advanced/pd-disaggregation.md`（模块 文档；类别 docs；类型 documentation）: 补充 agentic 场景下 PD 分离的优势说明。
- `docs/en/developer_guide/trace.md`（模块 文档；类别 docs；类型 documentation）: 明确 trace 工具适用于 agentic 自定义步骤。
- `docs/zh/advanced/pd-disaggregation.md`（模块 文档；类别 docs；类型 documentation）: 中文版 pd-disaggregation 同步更新。
- `docs/zh/developer_guide/trace.md`（模块 文档；类别 docs；类型 documentation）: 中文版 trace 文档同步更新。

关键符号：未识别


# 评论区精华

无 review 评论。

- 暂无高价值评论线程

# 风险与影响

- 风险：纯文档变更，无回归、性能、安全或兼容性风险。
- 影响：对用户理解 slime 的 agentic 集成方式有正面引导作用，降低接入成本；对系统运行无影响。影响范围较小，仅涉及文档阅读者。
- 风险标记：暂无

# 关联脉络

- PR #1920 Move fully_async example to main codebase: 文档中引用了 fully_async 示例作为 agentic 场景的推荐示例。
- PR #1921 Add example for streaming output: 文档中引用了 streaming 示例（可能间接相关），但更直接的是 search-r1 和 multi_agent 示例未见近期 PR，fully_async 是最近合并的。