Agent Forge 使用說明書

一、產品簡介

Agent Forge（Agents 工坊）是一個多代理（Multi-Agent）協同與編排平台。

簡單來說，您可以在這裡：

建立 AI 代理（Agent），為每個代理設定角色、性格和工作節奏。
將多個代理組成看板，讓它們分工協作完成任務。
將不同看板組成一個看板群組，以實現不同的業務場景。
用戰情室觀察代理的工作進度和互動過程。

說明： 頁面上實際可見的功能會根據您的角色、看板群組權限和選單權限而不同。如果本手冊提到的選單沒有出現在您的頁面，通常代表您目前的角色或權限無法使用該功能，請向組織管理員確認。

開始前請準備：

系統網址：向管理員索取（或直接向我司相關人員索取）。
邀請碼：我司統一發放。
瀏覽器：常用瀏覽器如 360 極速、Google 均可。
確認角色：向管理員或我司相關人員確認是管理員還是普通成員。

使用邀請碼註冊

路徑： 開啟系統網址 →「註冊」頁

點擊進入註冊頁面，依序填寫以下資訊：

欄位	填寫要求
手機號碼	支援以下格式，輸入時不用加空格或短橫線：大陸（11 位數字，1 開頭，如 13800138000）台灣（09 開頭，共 10 位，如 0912345678）日本（070/080/090 開頭，共 11 位，如 09012345678）其他國家/地區（加 + 號開頭，含國碼，如 +886912345678）
邀請碼	向管理員取得，填寫失效則需重新索取
企業名稱	您所在公司或組織的名稱
電子郵件	有效的電子郵件地址，用於接收通知
密碼	≥10 字元，必含大寫、小寫、數字、特殊符號各 1 個
確認密碼	再次輸入與上方一致的密碼

點擊「註冊並登入」按鈕。
系統跳轉至資料頁：輸入名稱（自訂）、時區（建議選擇上海），點擊「儲存資料」，完成註冊。

說明： 註冊成功後，頁面會自動跳轉至戰情室。

異常處理：

邀請碼無效：向管理員重新索取新的邀請碼。
手機號碼已註冊：該手機號碼已有帳戶，請直接登入或更換手機號碼註冊。

提示“手機號碼或密碼錯誤”：檢查手機號碼是否正確，或確認是否已註冊。
提示“電子郵件或密碼錯誤”：檢查電子郵件是否正確，或確認是否已註冊。
忘記密碼：點擊「忘記密碼」，輸入註冊手機號碼，會跳轉至新密碼輸入頁面，輸入新的密碼後點擊「重設密碼」即可重設。

三、角色與權限

系統的組織角色分為兩種：

角色	主要能力
管理員（admin）	管理組織成員、設定模型、建立看板群組和看板、建立 Agent
成員（member）	使用已設定好的看板群組和 Agent，主要在戰情室操作

除了組織角色，管理員還能設定兩種權限：

選單權限：決定成員可以看到哪些功能入口。
看板群組權限：決定成員可以讀取或編輯哪些看板群組。

說明： 因此，同樣是成員（member），不同帳戶看到的選單與資料也可能不同。

四、快速開始

在 Agents 工坊中，不同角色要做的事完全不同：

如果您是一般使用者，看板群組、Agent 都由管理員預先設定好，您只需要關注戰情室和檔案即可。請依照以下步驟開始。

一般使用者：從戰情室開始

第 1 步：登入系統

路徑： 在瀏覽器網址列輸入系統網址

開啟管理員提供的系統網址，使用已註冊的帳號、密碼完成登入。登入後預設進入戰情室頁面。

第 2 步：戰情室操作

戰情室是您與 Agent 溝通的主要場所。頁面從上到下依序為：

頂部導覽列：語言切換、使用者選單
標籤列：切換「時序協作矩陣」和「動態儀表板」
看板群組選擇：下拉選單選擇業務場景
時序協作矩陣（泳道圖）：顯示 Agent 之間的訊息流向
訊息區：顯示完整對話內容和 Agent 回覆
底部輸入區：附加檔案、輸入訊息、傳送

說明： 完整的頁面版面配置示意和各區域詳細功能，請參見第五章 5.1 戰情室。

第 3 步：選擇業務場景

路徑： 戰情室頁面頂部右上角 → 看板群組下拉選單

在頁面頂部的看板群組選單中，選擇與您目前需求相符的看板群組，即為業務場景。

每個看板群組對應一個業務場景，例如：

急單與排程
AIoT 裝置異常監控
能源與碳排管理
智慧售服
供應鏈與採購
AOI 品質管理
產銷協同
接單到出貨 OTD

切換看板群組後，時序協作矩陣、訊息區和動態儀表板都會切換到該看板群組的內容。

小貼士： 不確定選哪個？看板群組名稱通常直接反映業務場景，選擇名稱最貼近您需求的即可。如果清單為空，請聯絡管理員確認您擁有對應看板群組的權限。

第 4 步：與 Agent 溝通

在底部輸入框輸入您的需求或問題，然後傳送：

直接提問：用自然語言描述您的需求，例如「幫我檢查今天的庫存異常」。
@指定 Agent：輸入 @ 後選擇要通知的 Agent，類似群聊 @提及，確保對應代理收到訊息。
傳送附件：點擊「附加檔案」按鈕上傳檔案，Agent 可以讀取並處理附件內容。

點擊「傳送」後，訊息會出現在訊息區，Agent 開始處理。

第 5 步：查看 Agent 回覆

傳送訊息後，Agent 會自動處理並回覆：

時序協作矩陣：箭頭線顯示 Agent 之間的訊息流向，您可以看到哪個 Agent 正在回應、回應了什麼。
訊息區：顯示完整的對話內容，包括 Agent 的文字回覆。每條 Agent 訊息旁有「硬中斷」按鈕（中斷該 Agent 目前工作）和「收藏」按鈕（收藏該對話）。
動態儀表板：點擊頂部「動態儀表板」標籤切換。當 Agent 產生圖表、指標或狀態卡時，會自動在儀表板區域展示。

小貼士： 您可以輸入“請在動態儀表板幫我產生一份訂單分析圖表”來讓 Agent 產生視覺化圖表。

第 6 步：持續跟進與介入

在任務執行過程中，您可以隨時：

觀察進度：透過時序協作矩陣即時了解各 Agent 的工作進展和協作狀態。
補充指示：在輸入框繼續傳送訊息，補充需求細節或調整方向。
篩選訊息：點擊工具列「只看收藏」僅顯示已收藏的訊息。
中斷對話：點擊「停止全部」中斷所有正在產生的回覆。
調整文字大小：點擊「調整文字大小」可放大或縮小訊息區的文字大小。

小貼士： 戰情室適合在關鍵任務執行期間持續關注。您不需要時時刻刻盯著頁面，Agent 會自動完成分配到的任務。需要時回來看結果即可。

管理員：系統設定

如果您是管理員，需要依照以下順序完成 7 步設定，一般使用者才能正常使用戰情室：

建議依照以下順序操作，方便逐步關聯。

第 1 步：設定模型（模型維護）

路徑： 左側導覽 → 管理 → 模型維護

模型設定：在「模型設定」區域，點擊「新增模型」。
在彈出視窗中選擇供應商、模型 ID 協定以及「API Key」，點擊「新增模型」。

第 2 步：設定組織（設定成員及成員權限）

路徑： 左側導覽 → 管理 → 組織

點擊「新增成員」按鈕進入新增頁面。
輸入成員手機號碼，選擇角色，設定選單權限、看板權限。
點擊「儲存」。

成員清單中會顯示已新增的成員。

注意： 清單頁的「管理權限」可移除成員，移除成員前，請確認其負責的任務與權限已轉交。

第 3 步：建立看板

路徑： 左側導覽 → 協作資源 → 看板

點擊「新增看板」。
填寫：看板名稱（必填）、選擇看板群組（選填，可稍後關聯）、描述（必填）。
點擊「儲存」。

看板清單中會出現新建的看板和看板群組（需設定），可進行編輯或刪除。

引導式功能使用（Growth、Business 和 Enterprise 三個版本有此功能，Foundation 版本無此功能）

引導功能是系統預設的設定精靈，透過問答方式協助您快速完成看板的注入規則設定。引導會自動寫入注入規則（Injection Rules），無需手動逐項填寫。

路徑： 看板清單 → 對應看板的「編輯」按鈕 →「開始引導」按鈕

操作步驟：

在看板清單中，點擊對應看板的「編輯」按鈕，進入編輯頁面。
在頁面頂部提示列右側，點擊「開始引導」按鈕。
系統彈出引導對話框，根據填寫的看板描述自動產生問題（如：該看板處理什麼類型的內容）。
選擇最符合您業務需求的選項，點擊「下一步」。
依序回答所有問題至引導完成。
系統自動將引導結果寫入該看板的注入規則。
引導完成後，注入規則中顯示設定結果，Agent 將按照引導設定的規則工作。

說明： 不同看板的問題會根據其描述自動產生。引導結果寫入注入規則後，您仍可在注入規則中手動調整。如需重新設定，可再次點擊「開始引導」。

第 4 步：建立看板群組並關聯看板

路徑： 左側導覽 → 協作資源 → 看板群組

點擊「新增看板群組」。
填寫：看板群組名稱（必填）、描述（選填）、看板（選填，關聯第 3 步建立的看板）。
點擊「儲存」。

看板群組清單中會出現新建的看板群組，可進行編輯或刪除。

第 5 步：建立 Agent（代理工坊）

路徑： 左側導覽 → 管理 → 代理工坊

點擊「新增 Agent」。
填寫基本設定：Agent 名稱（必填）、角色（如 Generalist 通用型）、所屬看板（必填，選第 3 步建立的看板）、表情符號、溝通風格、間隔。
點擊「儲存」。

Agent 清單中會出現新建的 Agent，狀態顯示為「ONLINE（線上）」。

注意： Agent 顯示「provisioning」代表設定中，Agent 顯示「updating」代表更新中，長時間處於這兩種狀態時可聯絡管理員。

第 6 步：指派模型給 Agent

路徑： 左側導覽 → 管理 → 模型維護 → Agent 模型

在「Agent 模型」區域，選擇看板，依看板找到第 5 步建立的 Agent。
為其指定使用的模型（如 DeepSeek-V3）。

Agent 對應的模型欄會顯示已指派的模型名稱。可點擊「切換模型」進行切換。

第 7 步：驗證

路徑： 左側導覽 → 總覽 → 戰情室

在頁面頂部的看板群組下拉選單中，選擇第 4 步建立的看板群組。
確認 Agent 清單中顯示第 5 步建立的 Agent，且狀態為「線上」。
在底部輸入框輸入測試訊息（如「你好」），點擊「傳送」。
確認 Agent 有回覆。

訊息區會顯示 Agent 的回覆內容，時序協作矩陣中會出現訊息流。

小貼士： 完成以上 7 步後，一般使用者登入即可看到看板群組和 Agent，直接在戰情室開始使用。

五、總覽

總覽模組幫助您快速掌握平台整體的功能操作。

5.1 戰情室

以時序協作矩陣（泳道圖）形式展示同一個看板內多個代理之間的即時對話過程。

頁面從上到下依序為：

頂部導覽列：切換語言、使用者選單
標籤列：切換「時序協作矩陣」和「動態儀表板」
看板群組選擇：下拉選單選擇業務場景
時序協作矩陣（泳道圖）：顯示 Agent 之間的訊息流向
訊息區：顯示完整對話內容和 Agent 回覆
底部輸入區：附加檔案、輸入訊息、傳送

區域說明：

區域	功能說明
時序協作矩陣	以泳道圖形式展示 Agent 之間的訊息流向，每條泳道代表一個 Agent，箭頭線顯示訊息傳遞方向
動態儀表板	點擊頂部「動態儀表板」標籤切換。當 Agent 產生圖表、指標或狀態卡時，自動在此區域展示
訊息區	顯示完整的對話內容，包括 Agent 的文字回覆和附件。每條 Agent 訊息旁有「中斷該 Agent 目前工作」按鈕和「收藏該對話」按鈕
底部輸入區	包含「附加檔案」按鈕、訊息輸入框、「傳送」按鈕。輸入 @ 可提及指定 Agent
業務場景選擇	頁面頂部的下拉選單，切換不同看板群組。切換後，矩陣、訊息和儀表板都會切換到該看板群組的內容
訊息工具列	包含：「廣播」核取方塊、「停止全部」按鈕、「調整文字大小」按鈕、「只看收藏」按鈕

5.2 檔案

集中管理平台中上傳的檔案和附件。

路徑： 左側導覽 → 總覽 → 檔案

上傳檔案：將檔案拖曳到上傳區域，或點擊區域選擇檔案。

檔案會出現在檔案清單中，顯示檔名及檔案類型。

查找檔案：在搜尋框輸入檔名，或按「類型」「來源」篩選。

檔案清單會依篩選條件顯示符合的結果。

檔案清單：顯示所有已上傳的檔案，或戰情室 Agent 產生且需要下載的檔案。

說明： 戰情室對話也能加入附件。如果上傳失敗，先確認檔案大小與類型是否符合頁面顯示的限制。如果不符合，可點擊「上傳設定」，調整檔案大小和類型。

六、協作資源

協作資源模組包含看板群組和看板。

說明： 看板群組與看板是關聯關係：一個看板群組可關聯多個看板，一個看板也可屬於多個看板群組。建立時先建哪一方都可以，本手冊建議先建看板，方便建立看板群組時直接關聯。

6.1 看板群組

看板群組是任務的多步驟範本，定義了任務從開始到完成需要經過哪些環節，例如“接單→排產→生產→品檢→出貨，每步交給不同 Agent 處理”。

路徑： 左側導覽 → 協作資源 → 看板群組

建立看板群組：

點擊「新增看板群組」。
填寫以下資訊：名稱（必填）、描述（選填）、看板（選填，關聯看板）。
點擊「儲存」完成建立。
看板群組清單中會出現新建的看板群組。

6.2 看板

看板可將不同的代理組織在一起進行協作。

路徑： 左側導覽 → 協作資源 → 看板

建立看板：

點擊「新增看板」。
填寫以下資訊：看板名稱（必填）、選擇看板群組（選填）、描述（必填）。
點擊「儲存」。
看板清單中會出現新建的看板。

引導式功能使用（Growth、Business 和 Enterprise 三個版本有此功能，Foundation 版本無此功能）

引導功能是系統預設的設定精靈，透過問答方式協助您快速完成看板的注入規則設定。引導會自動寫入注入規則（Injection Rules），無需手動逐項填寫。

路徑： 看板清單 → 對應看板的「編輯」按鈕 →「開始引導」按鈕

操作步驟：

在看板清單中，點擊對應看板的「編輯」按鈕，進入編輯頁面。
在頁面頂部提示列右側，點擊「開始引導」按鈕。
系統彈出引導對話框，根據填寫的看板描述自動產生問題（如：該看板處理什麼類型的內容）。
選擇最符合您業務需求的選項，點擊「下一步」。
依序回答所有問題至引導完成。
系統自動將引導結果寫入該看板的注入規則。
引導完成後，注入規則中顯示設定結果，Agent 將按照引導設定的規則工作。

七、管理

管理模組負責平台的基本設定，包括組織、代理和模型。

7.1 組織

路徑： 左側導覽 → 管理 → 組織

管理目前組織的成員、權限和基本資訊。

成員數、看板數、待處理數。
成員清單：顯示組織內所有成員。

7.2 代理工坊

路徑： 左側導覽 → 管理 → 代理工坊

代理工坊是建立和管理 AI 代理的核心頁面。

建立代理：

點擊「新增 Agent」。
填寫基本設定：Agent 名稱（必填）、角色（如 Generalist 通用型）、所屬看板（必填）、表情符號、溝通風格、間隔。
點擊「儲存」。
Agent 清單中會出現新建的 Agent。

7.3 模型維護

路徑： 左側導覽 → 管理 → 模型維護

設定大型語言模型供應商相關內容。僅支援管理員維護操作，成員僅有檢視權限。

模型設定：在「模型設定」區域，點擊「新增模型」。
在彈出視窗中選擇供應商、模型 ID 協定以及「API Key」，點擊「新增模型」。
在「Agent 模型」區域，為代理指定使用的模型，Agent 對應的模型欄會顯示已指派的模型名稱。

八、帳戶與偏好

使用者選單

點擊右上角的使用者圖示，可以前往首頁、設定、官方文件或登出。

帳戶設定

注意： 刪除帳戶可能影響只有您一位成員的個人組織。操作前請仔細閱讀確認訊息。

忘記密碼

在登入頁點擊「忘記密碼」，依頁面提示設定新密碼。如果頁面沒有提供重設功能，請聯絡管理員協助。

語言與主題

語言：可從頁面上的語言選單切換簡體中文、繁體中文、英文或日文。
主題：左側選單下方可切換明亮與深色外觀。

九、常見問題

看不到某個選單

確認目前組織是否正確（從頂部組織選單查看）。
確認您的角色（管理員 / 成員）。
請管理員檢查您的選單權限及看板群組權限。

看不到看板群組或 Agent

確認已切換到正確的組織。
確認您擁有對應看板群組的讀取權限。
Agent 只會出現在所屬組織與看板群組的範圍內。

Agent 沒有回覆

確認 Agent 顯示為可用狀態（ONLINE）。
確認任務或訊息已傳送到正確的看板群組 / 看板。
確認 Agent 所屬的看板群組和目前操作的看板群組一致。
稍後待即時連線恢復後再檢查。
若持續發生，請將 Agent 名稱、看板群組名稱與發生時間提供給管理員。

戰情室沒有自動更新

確認目前選擇的看板。
等待系統重新連線。
重新載入頁面。
若重新載入後才出現訊息，請將發生時間與環境網址提供給管理員。

上傳失敗

查看頁面顯示的檔案大小與類型限制。
重新選擇檔案後再試一次。
若仍失敗，請將檔名、大小與頁面錯誤訊息提供給管理員。

戰情室代理顯示「離線」

請依下列步驟依序排除：

在訊息區傳送訊息喚醒，例如“@all 測試連通性，請回覆 ok”。
確認供應商 API Key 有效且餘額充足。
如仍無法上線，嘗試在模型維護頁面點擊「重啟 Gateway」。

需要進一步協助

聯絡管理員時，請提供以下資訊，以便快速定位問題：

發生時間與時區
所在頁面
組織、看板群組、看板或 Agent 名稱
頁面顯示的錯誤提示
可安全分享的操作步驟

回饋： 如果本說明未涵蓋您的問題，請在平台內聯絡管理員或提交回饋。