together-sandboxes

Together 沙箱

概述

当用户希望在托管沙箱中远程执行 Python 时，请使用 Together Sandboxes。

典型适用场景：

• 有状态的 Python 会话
• 数据分析和图表生成
• 执行 Agent 生成的代码
• 将文件上传到远程运行环境

适合使用此技能的场景

• 用户希望远程执行，而非在本地 shell 中执行
• 会话状态需要在多次调用之间持久保留
• 结果可能包含图表等显示输出
• 轻量级托管运行环境已足够，无需自定义基础设施

切换到其他技能

• 如需全面控制基础设施或运行规模更大的分布式任务，请使用 together-gpu-clusters
• 如需自定义容器化运行逻辑，请使用 together-dedicated-containers
• 如果用户只需要生成代码，而不需要执行代码，请使用 together-chat-completions

快速路由

• 远程执行并重用会话
  • 从 scripts/execute_with_session.py 或 scripts/execute_with_session.ts 开始
• 响应架构和会话列表
  • 阅读 references/api-reference.md
• 用于 Agent 工作流的 MCP 风格访问
  • 阅读 references/api-reference.md

工作流

1. 判断任务需要执行代码，还是只需生成代码。
2. 使用 client.code_interpreter.execute() 启动会话。
3. 如果工作流依赖之前的状态，请重用 session_id。
4. 分别检查 stdout、stderr、结构化输出和显示输出。
5. 仅在用户需要查看运行情况或清理资源时列出会话。

重要规则

• Python 脚本需要 Together v2 SDK（together>=2.0.0）。如果用户使用的是较旧版本，必须先升级：uv pip install --upgrade "together>=2.0.0"。
• 将 session_id 视为工作流状态的一部分。
• 在认定运行成功之前，先检查 response.errors。
• 使用 Agg 后端时，plt.show() 无法可靠地产生 display_data 输出。若要获取图表，请使用 fig.savefig() 将图形保存到 BytesIO 缓冲区，对其进行 base64 编码，并将编码后的字符串打印到 stdout。然后在客户端从 stdout 输出中解析该字符串。请参阅 scripts/execute_with_session.py 中的图表示例。
• 当用户需要远程有状态执行时，请使用此技能，而不要仅仅因为涉及 Python 就使用它。
• 如果任务超出沙箱模式的适用范围，请转交给 GPU 集群或专用容器。

资源索引

• API 参考：references/api-reference.md
• 其他访问方式：references/api-reference.md
• Python 工作流：scripts/execute_with_session.py
• TypeScript 工作流：scripts/execute_with_session.ts

官方文档

• Together 沙箱
• 沙箱 API