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)。
所有工具與主題都列在工具參考。