2.2 更新重點
這是 2.2 的頁面,保留供參考。目前的正式版請看2.3 更新重點。
AgEnD 2.2 在 Telegram 和 Discord 之外,多了一個網頁 app。你可以從瀏覽器和 agent 對話,在同一個地方看到所有在等你處理的事,也可以用第二個 Claude 帳號。fleet 也會自帶 Node,在更多種主機上都能順利升級。2.2.5 又加了更多:agent 有自己的外觀、訪客可以登入看自己的 agent、用量頁面,以及跟得上變化的側欄。這一頁寫給從 2.1.x 或 2.2.0 升級的人:列出你會注意到的變化,附上詳細說明的連結,並標出 2.2.5 新增的部分。
- 從 2.1.12 在 Linux 或 macOS 上升級: 在 General 傳
/update,或在主機上執行agend update。fleet 會以 2.2 重新啟動,General 會收到一則簡短的新功能說明。適用於有 glibc 2.28 以上與 systemd 的 Linux(包括開啟 systemd 的 WSL),以及 macOS 11 以上,x64 或 arm64。 - 從 2.1.0–2.1.11 升級,或在其他平台上: 請依升級指南的手動步驟操作。
- 從 2.2.0 或 2.2.1 升級: 在 General 傳
/update,或執行agend update,就會升到 2.2.5。執行中的 agent 會收到一次通知,告訴它新增了哪些工具。 - 升級進行時, 聊天會顯示每一步(下載、安裝、重新啟動),失敗時也會說明是哪一步失敗、原因。從 2.2 起,失敗的訊息還會附上更新紀錄的位置。
在瀏覽器和 agent 聊天
Section titled “在瀏覽器和 agent 聊天”
- 用一次性登入碼登入。 在 General 傳
/web。選 💻 AgEnD 電腦,可在執行 AgEnD 的那台電腦上登入;選 🌐 其他裝置,則透過臨時公開連結,從手機或另一台電腦登入。登入碼只能用一次,五分鐘內有效。連結不再帶任何密碼。 - 和頻道是同一段對話。 在網頁上寫的訊息,送到 agent 的方式和 Telegram 或 Discord 訊息完全一樣。fleet 頻道的聊天平台上也看得到;2.2.5 起,ClassicBot 聊天室也會同步(設
web_echo: false可讓某個聊天室不同步)。重新整理頁面或 fleet 重新啟動後,對話紀錄都還在。 - 完整的聊天功能。 支援 Markdown、表格和程式碼標色。可以傳任何類型的檔案,預設每個 50 MB、每則訊息合計 100 MB(
web.upload_max_file_mb/web.upload_max_total_mb);圖片和影音直接在頁面上預覽。看得到訊息送到哪一步、agent 正在處理,也有 Stop 按鈕可以中止。agent 提供的回覆按鈕和投票會照樣顯示,提及(mention)也和 Discord、Telegram 上的樣子一致。 - HTML 預覽。 agent 送來網頁時,可以在對話旁邊的面板打開。預覽預設關閉,開啟一次後,就會套用到所有已登入的裝置,但公開連結例外。預覽會在獨立隔開的網址上執行。
- 手機也好用。 滑動開關側邊欄,有淺色和深色主題,也支援鍵盤與螢幕報讀器。
- 切換聊天立即完成(2.2.5)。 最近開過的 12 個聊天(手機上 6 個)會立刻回到你離開時的位置;聊天載入時,畫面上的內容也不會跳動。
- 暫停的 agent 會被喚醒(2.2.5)。 傳訊息給已暫停的 agent,會先喚醒它再送達。喚醒失敗時,聊天會說明原因,保留你寫的內容,並提供重試傳送。
- 不需要聊天平台也能用。 fleet 可以只靠網頁 dashboard 運作。在瀏覽器裡就能設定:輸入 bot token、邀請 Discord bot。AgEnD 已經在跑一個連線時,再新增的連線不必重新啟動就會生效。
詳見網頁 dashboard 指南,或網站上的網頁使用說明。
讓 dashboard 有你的樣子(2.2.5)
Section titled “讓 dashboard 有你的樣子(2.2.5)”
- Agent 的主題。 agent 可以替自己的聊天設定外觀:淺色與深色的配色、強調色、對話框、字型、背景圖、自己的頭像,以及工作中的標籤。已登入的管理員可以從聊天的 ⋯ 選單鎖定或重設它。
- 身分卡。 每個 agent 都可以有頭像、橫幅、一句簡介與自我介紹,顯示在它的詳細資料頁、View,並收合在聊天裡。你也可以在 View 的編輯個人資料設定任何欄位自己的版本,以你的為準。
- 識別色。 替每個 agent 選一個顏色(⋯ → 顏色…),並選擇顯示在哪裡:名稱、旁邊的色條,或頭像外圈。
- 小工具。 agent 可以在聊天標題下方和詳細資料頁放一個小面板:數字、進度條、簡短清單、走勢線。由 dashboard 用自己的元件繪製,不會執行 agent 的 HTML 或程式。
- 環境效果。 agent 可以替自己的聊天加上飄落的花瓣、雪花、上升的燈籠、閃爍的符號,或在你點擊處散開的星星。dashboard 會把它畫在訊息後方,也不會攔截你的點擊。
- 你自己的自訂 CSS 與 mod。 設定 → 網頁外觀可以放一份只套用在你自己畫面上的樣式表,先試用再決定是否保留。mod 是承載整套外觀的單一檔案:會先讓你看到裡面的全部內容,再選要套用哪些部分。
- 直接請 General 幫忙。 General 可以在聊天中替你修改設定 → 網頁外觀。
詳見網頁 dashboard 指南的網頁外觀部分。
等你處理的事,集中在一個清單
Section titled “等你處理的事,集中在一個清單”
等你處理(Needs you)會集中列出所有 bot 的提示、權限請求、登入、當掉的 agent,以及無法確認的投遞。它在 General 是一則即時更新的訊息,在網頁 app 裡是一個頁面。你在任何地方處理過的事(Discord、Telegram 或網頁),都會從每個清單上消失。詳見等你處理。
訪客,以及在瀏覽器背後替你背書的帳號(2.2.5)
Section titled “訪客,以及在瀏覽器背後替你背書的帳號(2.2.5)”
- 訪客登入(預設關閉;設定 → 網頁 → 訪客)。不是 fleet 管理員的人可以用自己的 Discord 或 Telegram 帳號登入,只看得到他們在聊天中本來就能用的 agent。每次訪客登入都會在 General 通知,而且訪客只能聊天:不能下指令,也看不到 Fleet 與設定。
- agent 會照做你從網頁提出的請求。 用
/web登入碼登入的管理員,從網頁送出的訊息就是本人。agent 會回答,並替你做一般的工作:問問題、查資料、分析,以及它自己範圍內的修改。 - 其他的,請授權這個瀏覽器。 需要本人點頭的動作,例如發布,或超出 agent 自己工作範圍的破壞性操作,要有你的帳號背書:按訊息框下方的授權這個瀏覽器,再到 Discord 或 Telegram 的私訊確認那張卡片;或直接在 Discord、Telegram 上回覆。
詳見訪客網頁登入與 agent 看到的是誰。
不只一個 Claude 帳號
Section titled “不只一個 Claude 帳號”
- Claude Code 的多組登入(credential profile)。 和 Codex、kiro-cli 一樣,instance 可以用
backend_options.claude-code.credential_profile改用另一個 claude.ai 帳號。在聊天裡用/login claude-code <profile>讓這個 profile 登入。用量會每個 profile 各列一行;把 agent 換到別的 profile 時,對話會保留。詳見 credential profiles。 - 在聊天裡換 agent 的 CLI。
/backend會把 instance 換到另一個 backend,再讓你選模型和 effort,只需重新啟動一次。 - 用選的,不用猜(2.2.5)。
/backend與新增 agent 對話框會列出每個 backend,並說明哪些無法在這台主機上執行。網頁設定裡每個 backend 與模型欄位都是清單,列的是該 agent 帳號提供的選項;/model也會列出那個帳號的模型。
看得到 fleet 在做什麼
Section titled “看得到 fleet 在做什麼”
- 用量。 用量面板(◔)會顯示每個訂閱的剩餘額度,寬螢幕時放在右側。
- Fleet → 用量(2.2.5)。 依 agent、backend、模型、profile 或 team 顯示每個 agent 的 token、請求數與依牌價換算的 API 等值(不是實際花費),附每日趨勢、日曆熱度圖與 CSV 下載。
-
紀錄分頁(需手動開啟,
web.log_tab: true)。逐步顯示 instance 的提示、回覆和工具呼叫,秘密值會遮蔽,支援 Claude Code 和 Codex。 -
Fleet 頁面。 可以在網頁上編輯排程和團隊。組織圖顯示誰負責什麼(2.2.5 起是可以平移縮放的畫布,並顯示 agent 之間的即時流量),快取頁面顯示每個 agent 的 prompt 快取多久失效一次,每個 instance 也都有自己的詳細資料頁。
-
跟得上變化的側欄(2.2.5)。 每個 agent 會顯示它最後一次回覆的時間,agent 依 team 分組,篩選時你正在看的那個會留在最上面,清單最後還有新增 agent。手機上有四個分頁:聊天、等你處理、Fleet 與設定。
AgEnD 自帶 Node
Section titled “AgEnD 自帶 Node”在 Linux(glibc 2.28 以上)和 macOS 11 以上的 x64 或 arm64 上,AgEnD 會安裝並使用自己的 Node 22.23.3,不管 PATH 上是哪個 Node,你都不必自己升級 Node。其他環境需要 Node 22.14 以上。詳見升級指南。
在實際的主機上都能順利升級
Section titled “在實際的主機上都能順利升級”- macOS: 從 agent 自己的面板啟動的更新能夠完成,不會再讓 fleet 停在一半。
- Linux,以 root 執行、使用系統 unit 的 fleet: 更新現在會把 unit 指向新版本,fleet 真的會跑 2.2。
- 沒有使用者 session bus、或使用自訂
AGEND_HOME的主機: 服務都會正確更新並重新啟動。 - Telegram 上看得到更新完成(2.2.5)。 更新訊息不再停在「啟動中… N/M」,會走到「✅ AgEnD 已更新」。
- 從 2.2 起,安裝被拒絕時會說明原因。 由 2.2 或更新版本執行的更新,聊天會顯示 AgEnD 自己的原因,而不是只有 npm 的「code 1」。從 2.1.12 升級的那一次仍由 2.1.12 的更新程式執行。
- 登入可以撤銷。 改用一次性登入碼與伺服器端 session,網址裡不再帶 token。
/web revoke會讓所有瀏覽器登出。 - 敏感的設定變更改為提案。 由 fleet 管理員在聊天中確認,或在主機上執行
agend settings confirm <id>。 - ClassicBot 需要核准。 ClassicBot 的允許清單留空時,不再對所有人開放:新的聊天室會先請 General 核准。
已移除與不支援
Section titled “已移除與不支援”gemini-clibackend 已移除(自 2.1.12 起)。請改用backend: antigravity:同樣是 Google 登入,透過 agy 執行。- 不支援: musl Linux(例如 Alpine)、沒有 systemd 的 Linux,以及原生 Windows(請改用開啟 systemd 的 WSL)。AgEnD 在這些環境上也許還能安裝,但沒有經過測試。升級指南有列出處理方式。
所有變更請見變更紀錄。