sandbox_list

列出帳號的箱子(隊友的也在內),最近用過的在前,附每個箱子的名字、goal、狀態與網址。只讀,不會喚醒箱子。

輸入 輸出
all(可省略) boxes[{id, name, goal, status, agent, placement, size, clientName, createdAt, lastUsedAt, stopsAt, restorableUntil, sceneUrl, webUrl, services, linkedFrom, recentNotes}],最近用過的在前,最多 100 個,還有更多時附 note

列出帳號裡的箱子,最近用過的在前,最多 100 個(還有更多時 note 會講還有幾個)。同一個帳號的每個連線看到的都一樣,所以隊友的 agent 開的箱子也在裡面。預設只列還活著的箱子(開機中、ready、有人接手、凍結、正在停);all: true 連已經停掉的(terminated 或 interrupted)也列。它只讀資料:列箱子不會喚醒凍結的箱子,也不算使用。stopsAt 是沒有人再用它的話閒置規則永久停掉箱子的時間;帶 all: true 列出的已停箱子若有 restorableUntil,在那之前都能用 sandbox_start 的 restore 拿回來(箱子狀態)。

sandbox_list {}
sandbox_list { "all": true }
  • 每個箱子有 id、name、goal、status、agent(只有還活著的箱子有:最後用它的對話還在不在做,見哪個對話在用箱子)、placement、size、clientName(開它的 MCP client)、createdAt、lastUsedAt、sceneUrl、webUrl、services、linkedFrom(link 到它的、還活著的箱子)與 recentNotes:最近 3 步的說明,舊的在前,不必一個個 sandbox_status 就看得出它在做什麼、說明有寫的話用了哪個測試帳號或資源。agent.untracked: true 標出最後是被沒帶對話 id 的呼叫(API key 腳本、REST)用的箱子,它的 state 只是照閒置時間猜的。
  • services 就是宣告的內容,加上每個 web 服務的 url、link 的 fromBox 與版本的 version。這裡版本的 run 是 ParallelSandbox 記下的(not_started、starting,或帶錯誤的 failed);即時狀態要看 sandbox_status,它會去問箱子。
  • 用它找要 link 的箱子的 id(services[].fromBox)、看隊友在跑什麼、用 name 或 goal 找別的對話留下的箱子(接手別的對話留下的箱子),以及找出沒人要的箱子再 sandbox_stop:跑著的箱子會扣點,凍結的箱子也照樣算在帳號的箱數上限裡。
  • 箱子記的是開它的 MCP client(clientName),不是憑證,所以在共用的帳號裡,只有箱子的 name 看得出是誰的,goal 看得出是做什麼的。箱子要取名為 <人>:<工作>,其餘寫在 goal;只停自己開的箱子(留著 sandbox_start 回的 id),或名字寫明是自己的;絕對不要照時間大量停箱子;要停隊友的箱子先問。
  • REST 對應的是 GET /v1/boxes,加 ?all=1 會連停掉的箱子也列。它照開箱時間排(最新開的在前)、最多 200 個,還多帶 screenInUse、screenActive、posterUrl 與等著人的卡片 review(見 REST)。

所有工具與主題都列在工具參考。