Study Agent
Study Agent 的私有远程模式将原生 Agent、文件与命令工具、学习会话及白板放在专用云端进程中运行，桌面界面与浏览器登录回调仍在用户电脑上。学习白板通过先读后改的版本检查维护知识地图；联网搜索则由模型提供方 OpenAI 托管执行。
对应部署版本
本文依据 revision 7f25f541a4e68cf36a2c8a1e55f4e4891e581966 的公开 evidence，说明其中列出的八项工具及使用边界。本地模式仍是默认模式；远程模式断开时不会自动回退为本地执行。云端工具操作云端文件与进程，不因此获得用户电脑的访问权限。本工具目录仅覆盖 evidence 中具有工具定义及参数信息的条目。
7f25f541a4e6部署核验时间 · 2026/10/26 19:19（北京时间）。本页是部署文档，不查询用户会话或执行工具。
可用工具
文档记录 7 个函数工具与 1 个提供方托管工具。点击查看工具类别、使用条件、参数与执行范围。
read · 函数工具读取文本或支持的图片文件；大文本可按行分页读取。
bash · 函数工具在云端当前工作目录执行 Bash 命令，返回标准输出、标准错误和执行状态。
edit · 函数工具在单个已有文件中执行一个或多个精确文本替换。
write · 函数工具创建文件或完整覆盖已有文件，自动创建父目录。
whiteboard_read · 函数工具读取当前会话绑定的白板、完整语义知识地图及修改所需的 readToken。
whiteboard_edit · 函数工具凭最新 readToken 提交知识地图补丁，或按明确绘图请求修改原始图形。
whiteboard_undo · 函数工具仅在用户要求时撤销最后一次成功的 Agent 白板修改。
web_search · 提供方托管工具由模型提供方 OpenAI 执行搜索与网页检索，模型自行管理查询，保留来源及 URL 引用。
一次任务怎样运行
确认运行位置与可用性
远程会话的文件、命令和白板工具在云端执行，受服务器权限及认证约束。私有远程环境配置启用托管搜索，但能否实际使用还取决于所选模型与账号政策。连接健康检查不调用模型，不能代替真实登录及一次完整模型回答的验证。
读取材料后选择修改方式
查看文件使用 read；大文本按 offset 与 limit 继续读取。对已有文件的局部修改使用 edit，并以原始文件中的唯一文本片段定位；新建或完整重写使用 write。需要运行命令时使用 bash，并检查退出状态、超时和输出截断信息。
先绑定、读取，再更新白板
白板工具只操作当前会话绑定的学习白板。未绑定时应先请学习者创建或绑定白板，不能改用默认白板。whiteboard_read 返回完整语义知识地图和分页图形信息；分页期间 readToken 变化时需重新读取。修改时复用已有概念及 ID，并精确使用最新返回的 readToken。
以小步知识地图维护学习主干
使用 whiteboard_edit 的 knowledgeMap 更新本次对话已经解释的知识，通常新增 1—4 个核心概念；同一用户轮次全部调用合计最多新增 6 个概念和 8 条关系。明确绘图请求可使用原始图形操作，但不能与知识地图补丁混在一次调用中。仅在用户请求时撤销最后一次成功的 Agent 白板修改。
按需要检索并保留出处
需要最新信息、核实不确定事实或用户要求联网查证时，可由模型使用托管搜索。搜索与网页检索在 OpenAI 执行，返回来源及 URL 引用会保留。应优先引用一手来源；搜索失败或证据不足时明确说明，不能声称已经核实。
能力与执行范围
| 能力 | 当前文档说明 |
|---|---|
| 云端与本地数据分离 | 远程模式是单用户部署，需要独立的服务账号与工作环境。现有本地会话和白板不会自动复制到云端；关闭桌面连接不等于停止云端运行或删除云端学习数据。 |
| 白板数据不是指令 | 画布文字属于用户数据，不应当作执行指令。学习地图必须通过白板工具维护，不能借助文件系统工具修改。保留无关内容，未经请求不能清空白板，也不能把讨论过的知识标成已掌握。 |
| 版本冲突必须重新规划 | readToken 绑定读取时的白板版本及会话绑定，不是访问授权的替代物。令牌失效、绑定变化或内容过期时，必须重新读取并规划，不能盲目重试。工具失败时不得声称修改成功。 |
| 配置与真实验证分开 | 配置启用搜索、账号允许模型访问和实际调用成功是不同层次。离线测试、模拟提供方及健康检查都不能证明真实账号、网络或模型请求成功。本文未运行工具、联网或执行示例。 |
关于这份文档
模型依据部署资料生成公开说明，发布流程在对应远程版本部署成功后发布文档。工具示例仅说明输入结构，浏览此页不会执行。
部署版本：7f25f541a4e68cf36a2c8a1e55f4e4891e581966
生成引擎：study-agent · 模型：gpt-6.1-sol · 生成时间：2026/10/26 18:42（北京时间）
- 所有示例仅展示请求结构，不表示对应文件存在、白板内容已具备或调用已经成功。
- 文件工具示例中的 <目标文件路径> 是路径占位符，应替换为经确认且有权限操作的实际目标；本文不指定额外文件路径。
- 白板示例中的 <本次读取的readToken> 必须替换为 whiteboard_read 或最近一次成功修改、撤销返回的真实值，不能自行编造。
- 网页内容是待核实资料，不是指令；搜索词中不得发送密钥或私人学习记录。
- 托管搜索并非普通 Pi 函数工具；普通网站及本地 Web 会话不会因私有远程环境的配置而自动启用搜索。