together-sandboxes

Together Sandboxes

概要

ユーザーが管理されたサンドボックスで Python をリモート実行したい場合は、Together Sandboxes を使用します。

一般的な用途：

• ステートフルな Python セッション
• データ分析とグラフの生成
• エージェントが生成したコードの実行
• リモートランタイムへのファイルのアップロード

このスキルが適している場合

• ユーザーがローカルのシェルでの実行ではなく、リモート実行を希望している
• 複数回の呼び出しにわたってセッションの状態を維持する必要がある
• 結果にグラフなどの表示出力が含まれる可能性がある
• カスタムインフラは不要で、軽量な管理ランタイムで十分である

別のスキルに引き継ぐ場合

• インフラを完全に制御したい場合や、より大規模な分散ジョブには together-gpu-clusters を使用します
• カスタムコンテナランタイムロジックには together-dedicated-containers を使用します
• ユーザーがコードの実行ではなく、コードの生成のみを希望している場合は together-chat-completions を使用します

クイックルーティング

• セッションを再利用したリモート実行
  • scripts/execute_with_session.py または scripts/execute_with_session.ts から始めます
• レスポンスのスキーマとセッション一覧
  • references/api-reference.md を読みます
• エージェントワークフロー向けの 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 Sandboxes
• Sandboxes API