仕上げ

ボックスの作業の終え方:人に結果を試してもらうなら sandbox_review、見せるものがなければ sandbox_stop。それぞれ何が残るかも。

起動したボックスは、手を離す前に必ず仕上げます。

  • 動いているアプリを人に試してもらうときは sandbox_review を使います。ボックスはすぐ「確認待ち」に表示され、呼び出しはクライアントが対応する上限まで待ちます。宣言がなければ最大 25 秒、長い待機を設定すれば最大 30 分です。返ったレポートを読んでから作業を続け、タイムアウト後は reviewId で再開するか sandbox_report で既知のレポートを読み直します。その後停止しても、過去 7 日に撮影した画像と動画は「すべて」→「停止済み」で開けます。ボックスと /work は残りません。確認待ちのボックスも通常のアイドルの規則どおり凍結・停止します(ボックスの状態)。凍結中なら人がレビューを開くと起き、停止したものは新しいボックスで渡し直す必要があります。人が何を開くかは open で指定します。ページを配信しているポートを付けた web か、ボックスの画面を渡す box です。画面に何もないため box の交付に失敗したら、ボックスのディスプレイかデバイスでアプリを起動して再試行します。
  • 人に試してもらうアプリがない場合は sandbox_stop を使います。ボックスは停止し、スクリーンショットと録画は撮影後 7 日間、アプリの停止済み一覧から開けます。必要な /work のファイルは先にダウンロードしてください。

どちらもせずに動かしたままのボックスは、人のアプリで「AI は手を止めました」(下記)と表示され、どうするかを人が決めるまで待ちます。会話はそこまで行く前に終わることもある(ノート PC を閉じた、クライアントを閉じた)ので、作業しながら /work でコミットし、何が終わって何が残っているかをメッセージに書き、大事なものは push するか sandbox_pull で取り出します。steps[] に残るのは実行したことで、ファイルではありません。MCP サーバーの instructions もすべてのクライアントに同じことを伝えています。sandbox_start には必ず goal を渡し、どのボックスも sandbox_review か sandbox_stop で仕上げ、別の会話が残したボックスを引き継ぐ前に sandbox_status を読むことです。

ボックスが残すものと、ボックスを止めたあと誰が見られるか(詳細はリンク先の各節):

もの 削除されるとき ボックスを止める前 止めたあと
ステップと sandbox_shot のスクリーンショット・録画(sandbox_exec、sandbox_shot) それぞれ撮影後 7 日 アプリの画像・動画欄と GET /v1/boxes/{id}/media 「すべて」→「停止済み(過去 7 日)」と /media。期限まで開けます
sandbox_get で取り出したファイル(録画を含む。sandbox_get) 約 1 日後に自動削除。保存量には含まず、URL は 1 時間有効 ボックスがある間は新しい URL を取得でき、sandbox_pull で直接ダウンロードもできます 有効な手元の URL のみ。新しい URL は取得できません
凍結時の posterUrl と sandbox_review のカード画像:それぞれ最新の 1 枚だけを保存し、古いものは置き換えます(クレジット) アカウント削除時。現在アプリから個別削除はできません アプリで最新の画像を表示 停止済み一覧と GET /v1/boxes?all=1 で最新のポスターを表示できます
自動で止められ、まだ取り出していない録画(sandbox_shot) /work と一緒に あなたは sandbox_get で。アプリにも /media にも出ない なくなる
/work ボックスを止めたとき あなたは sandbox_exec、sandbox_get、sandbox_pull で なくなる

すべてのツールとトピックはツールリファレンスに並んでいます。