從終端機連線至 Managed Agents 工作階段
將 ant CLI 附加至 Claude Managed Agents 工作階段,以即時追蹤其對話紀錄、傳送訊息、允許或拒絕工具呼叫,或在瀏覽器中開啟工作階段檢視器。
ant beta:sessions connect 會將您的終端機附加至現有的 Claude Managed Agents 工作階段。它會載入工作階段的「transcript」(對話紀錄),並在代理程式運作時即時追蹤。您也可以介入操作:傳送訊息、中斷代理程式,或允許或拒絕正在等待核准的工具呼叫。使用 --web 時,它會改為在瀏覽器中以 Claude Console 的工作階段檢視器開啟該工作階段。
此命令需要 1.32.0 或更新版本的 CLI。若要安裝或更新 CLI 並進行驗證,請參閱 CLI 快速入門。
連線至工作階段
傳入您工作區中某個工作階段的 ID。您可以從建立回應、ant beta:sessions list 或 Console 中複製該 ID。
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7若未使用 --web,此命令需要互動式終端機。在指令碼中,請改用 ant beta:sessions:events stream 和 ant beta:sessions:events send。請參閱 CLI 指令碼與自動化。
按下 Ctrl+C 即可中斷連線。工作階段會持續執行,再次連線時會載入其完整歷史紀錄。
追蹤並引導工作階段
終端機檢視會即時顯示對話內容:訊息與工具呼叫,以及每次呼叫的持續時間與結果。狀態列會顯示工作階段是正在執行、閒置,還是正在等待您的核准。在多代理程式工作階段中,檢視會追蹤工作階段的主要執行緒,其中包含協調者與其委派的代理程式之間交換的訊息。
| 按鍵 | 動作 |
|---|---|
| Enter | 將您的輸入以 user.message 事件傳送。Alt+Enter 或 Ctrl+J 可換行。 |
| Esc | 在代理程式執行時中斷它(user.interrupt)。 |
| Ctrl+O | 顯示或隱藏詳細資訊:工具輸入與結果、token 用量,以及狀態事件。--verbose(-v)會在啟動時即顯示詳細資訊。 |
| Page Up、Page Down | 捲動瀏覽對話紀錄。向上捲動會暫停追蹤;按 End 可恢復追蹤。 |
| Ctrl+C | 中斷連線。在空白輸入行按下 Ctrl+D 也會中斷連線。 |
當工具呼叫正在等待您的核准時,輸入行會變更為 Allow tool call?。這會在 always_ask 政策下發生,或在 auto 政策下伺服器無法做出判定時發生。請選擇 Yes、No 或 No, and tell the agent why。CLI 會將您的選擇以 user.tool_confirmation 事件傳送,您輸入的任何理由則會作為其 deny_message。
如果工作階段已 terminated 或已刪除,檢視將為唯讀。
在瀏覽器中開啟工作階段檢視器
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web--web 會從 127.0.0.1 上的本機伺服器提供 Console 的工作階段檢視器,印出其 URL,並在您的瀏覽器中開啟。加上 --no-browser 可略過開啟瀏覽器。您也可以從瀏覽器傳送訊息、中斷代理程式,以及允許或拒絕工具呼叫。與終端機檢視不同,瀏覽器檢視器會追蹤多代理程式工作階段的每一個執行緒。
該 URL 只能開啟一次,且必須在印出後兩分鐘內開啟。重新載入該分頁是可行的,但若要在其他地方開啟檢視器,請再次執行此命令。您的憑證永遠不會離開 CLI:頁面只會將請求傳送至本機的 ant 程序,再由該程序發出 API 請求。伺服器會持續執行,直到您按下 Ctrl+C 為止。
Was this page helpful?