用途:Together Sandboxes 用于在 Together AI 的托管沙箱中远程执行 Python,适合需要远程运行而非本地 shell 执行、会话状态需跨多次调用保持、结果可能包含图表等显示输出、且轻量托管运行时即可满足的场景。
主要能力:支持有状态 Python 会话、数据分析与图表生成、智能体生成代码的执行、向远程运行时上传文件,以及类 notebook 的运行方式。
使用方式:先判断任务需要执行代码还是仅生成代码;通过 client.code_interpreter.execute() 启动会话;当工作流依赖先前状态时复用 session_id;分别检查 stdout、stderr、结构化输出和显示输出;仅在需要运维可见性或清理时列出会话。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,再由客户端解析。若任务超出沙箱模型,应改用 GPU 集群或专用容器;若只需生成代码而非执行,应使用聊天补全类技能。
资源:API 参考见 references/api-reference.md,Python 工作流见 scripts/execute_with_session.py,TypeScript 工作流见 scripts/execute_with_session.ts。