通用介面元件¶

平台許多頁面共用同一組操作元件——同樣的編輯器工具列、同樣的存檔按鈕、同樣的清單圖示。這頁把這些「到處都會看到」的按鈕與圖示集中說明一次。

編輯器工具列¶

只要欄位是多行文字、程式碼或 JSON（例如 Agent 提示詞、樣板內容、變數的 JSON 值、程式碼任務、LLM 訊息等），輸入框右上角就有一排工具列（一直顯示，不必把滑鼠移上去）。這類欄位左側也會有行號。

點 「在對話方塊中編輯」後會跳出放大視窗，右上角的 可關閉並帶回剛才的編輯結果：

表單頁首：放棄與儲存¶

建立或編輯任何資源、Agent、任務時，表單右上角固定有兩顆按鈕：

資源挑選欄位的編輯圖示¶

當某個欄位需要「選一個既有資源」（例如 Agent 的「大型語言模型」、工具的「連結器」、檢索工具的「知識庫」），欄位右側會有一個 圖示。點它會跳出該資源類型的挑選清單，從中選取後填回欄位。清單裡可搜尋、可看到每個資源的狀態與最後更新時間。

點欄位本身也會開啟同一個挑選清單，不必非得瞄準那顆鉛筆。欄位已經有值時，右側會多出一顆下拉箭頭，按它開的也是同一個挑選清單（不是一般下拉選單）。這些欄位一律是唯讀的，直接打字打不進去。

點下去後會跳出挑選清單，可用上方搜尋框找資源，每一列會顯示資源的「類型」「狀態」與「最後更新」時間；選好一列後按右上角「儲存」即填回欄位。

表格的新增列按鈕¶

需要逐列填寫的設定（例如 LLM 任務的「對話」訊息、API／Lambda 工具的「輸入結構」、資料集的「欄位」），會以表格呈現，表格下方有一顆紫色的 按鈕。每一列通常可再用 編輯、 刪除。

點紫色的 按鈕後，會跳出該列的設定小視窗可填寫各欄位，按右上角「儲存」即新增一列回表格（部分表格則是直接在表格內新增一列填寫）。

金鑰欄位在編輯時要先按「重設」¶

凡是輸入密碼類機密的欄位（各種資源的「API 金鑰」、AWS 連結器的「AWS 私密存取金鑰」、MySQL 連結器的「資料庫密碼」…），建立時就是一個一般的輸入框，右側有一顆 可切換成明碼，確認自己有沒有打錯。

但編輯已經存好的資源時不一樣：那一格會變成一個唯讀的遮罩框（顯示一串固定的佔位字元，不隨你存的金鑰長度改變），旁邊多一顆「重設」按鈕。這代表兩件事：

• 已存的金鑰看不到了。 平台不會把存進去的機密再顯示出來，遮罩框裡那串東西不是你的金鑰。要確認金鑰還有效，用該資源自己的驗證鈕（例如搜尋引擎、大型語言模型、連結器），不要試著把它讀出來比對。
• 想換金鑰要先按「重設」。 直接在遮罩框上打字完全沒有反應（它是唯讀的）。按下「重設」後那一格才會換成一個空的輸入框，重新輸入新的金鑰再按「儲存」。

「標籤」欄位：給資源分類¶

「標籤」是自己貼給某個項目的分類小標，例如把所有客服相關的資源都貼上 客服。貼過之後，清單頁就能用標籤把同一群項目一次篩出來，不必靠名字硬記，也不必把用途硬塞進名稱裡。

哪裡會看到它： Agent、工作流程，以及每一種資源（大型語言模型、知識庫、載入器、連結器、變數…）的建立與編輯表單都有這個欄位，位置在表單上半部的基本欄位裡，不在「進階設定」之類的摺疊區塊中。確切排在哪一欄各表單不同：多數資源表單就在「名稱」的下一欄，欄位較多的表單（資料集、技能、Lambda 函式）把它放在最後一欄，Agent 表單則排在「描述」與「Agent 提示詞」之間——每一頁的欄位表都會寫清楚該表單的實際順序。建立完成後，該項目詳細頁的「一般」頁籤也會多一列「標籤」，把目前貼了哪些標籤以 chip（小標籤）呈現；沒貼過就顯示 -。

怎麼填： 在欄位裡直接打字，按 Enter 就會把它變成一個 chip；要移除某個標籤，點該 chip 右側的 即可。打字時欄位下方會浮出一個下拉，但裡面只有正在輸入的那串字——點它跟按 Enter 是一樣的效果。這個欄位不會列出別人已經用過的標籤可挑，一律自己輸入，所以團隊最好先講好統一寫法（例如都寫 客服，不要一半寫 客服、一半寫 customer-service），否則篩選時會漏掉。

欄位名稱右側的 提示寫的是：

新增標籤以分類資源，方便日後搜尋與篩選。最多 50 個標籤，每個標籤最多 128 個字元。

用標籤篩清單： Agents、工作流程與每一個資源子清單的搜尋框都可以改用「標籤」當篩選欄位：點搜尋框，在下拉選單選「標籤」，接著選比對方式，最後輸入要找的標籤文字並按 Enter。比對方式有「等於」、「不等於」、「包含」三種，所以完全相符或只要包含都做得到，由自己選——要精準只看貼了 客服 的項目就用「等於」；只記得標籤裡有「客服」兩個字就用「包含」。搜尋列的完整操作見清單頁的共用操作。

側邊欄與畫面外框¶

登入後，畫面左側固定是側邊欄（導覽選單），上方橫條只顯示目前所在位置的麵包屑（例如「Agents」），沒有其他按鈕。側邊欄由上而下最多分成四段（依該帳號的權限增減），段與段之間用一條細分隔線隔開。畫面上只有分隔線、沒有段落標題，下表的段落名稱是本手冊為了說明而加的：

最上方的「與 Copilot 協作」（）是 Copilot 的入口：點它不會換頁，而是在側邊欄右側展開一個 Copilot 對話面板（同時側邊欄會自動收合成窄軌，把寬度讓給面板與內容區），用白話描述要做的事，由 Copilot 幫忙建立與修改 Agent、工作流程與資源。這一項一般情況下所有使用者都看得到，不限管理員；但某些環境會把 Copilot 限定為只有管理員可用，此時非管理員完全看不到這一項（見 Copilot）。面板開著時這一項會維持選取狀態。面板本身的用法見 Copilot。

收合成窄軌 (rail)： 點側邊欄右上角的 「切換側欄」，側邊欄會收成一條只有圖示的窄軌，把寬度讓給內容區；把滑鼠移到任一圖示上會浮出該項目的名稱（最上面那顆 浮出的是「與 Copilot 協作」）。開啟 Copilot 面板時側邊欄也會自動收合成窄軌（關掉面板後不會自動展開回來）。要展開回來，把滑鼠移到窄軌上——最上方的圖章會換成 按鈕，點它即可。收合只在目前這個畫面有效，重新載入頁面後會回到展開狀態，不會被記成偏好設定。

最底部是頭像與帳號名稱，點它會展開選單，裡面有帳戶、主題（淺色／深色）、語言（English／正體中文；部分環境另有 日本語，是否出現依部署設定而定）、說明與登出。「說明」再往右展開還有一項顯示目前的平台版號（例如「版本 v1.0.25」），點它會把版號複製到剪貼簿（畫面不會出現任何「已複製」提示，選單只是關閉，請自己貼到別處確認），回報問題時很方便。完整項目說明見帳戶概覽 — 怎麼進入。

清單頁的共用操作¶

多數清單頁（Agents、工作流程，以及各個資源子清單如大型語言模型、知識庫…）都長得一樣：內容區是搜尋列加一張資料表。

搜尋列：

每一列： 最左邊的 我的最愛一直都在；「前往」與 更多平時不顯示，把滑鼠移到那一列上才會浮出在列的右側（因此上圖裡看不到）。

清單底部的分頁控制： 表格一次只顯示一頁，預設每頁 10 筆。清單底部右側由左到右是 上一頁、目前頁碼、 下一頁，再往右是「每頁筆數：」下拉（可選 10、20、50、100，部分清單另有 200）。

詳細頁的卡片收合¶

點進任何項目的詳細頁後，多數資訊卡片（如「詳細資料」）右上角都有一個（）收合鈕（少數卡片沒有，例如執行結果頁的「目次」與「執行」卡片）。點它可把整張卡片收起來、只留標題，方便在資料很多時聚焦在要看的區塊；再點一次（）展開。詳細頁標題旁同樣有（）我的最愛可切換收藏。

詳細頁的「日誌」頁籤¶

Agent、工作流程與每一種資源的詳細頁，最後面可能多一個「日誌」頁籤：它列出這個項目被「建立、更新、刪除」的紀錄，出了問題想回頭查「是誰在什麼時候動過它」時就看這裡。

這個頁籤不是每個環境、每個項目都有，看不到不代表壞掉：

• 部署要啟用日誌功能才會出現（預設不啟用）。整個平台都找不到這個頁籤時，代表這套環境沒有開啟，需要的話請聯絡系統管理者。
• 這個頁籤有自己的權限檢查，開得進某個項目的詳細頁不代表就看得到它的日誌：同一個帳號通常在自己（或所屬群組）建立與被授權的項目看得到，在平台內建的預設項目（如 default-llm）看不到——某些有、某些沒有是正常的。
• 也因為它是「有開才出現」的頁籤，本手冊各詳細頁列出的頁籤（例如「一般」「依賴資源」「被依賴資源」）都不含它——在啟用日誌的環境裡，實際畫面會比手冊多這一個頁籤。

畫面組成：

紀錄由新到舊一次載入一批，還有更舊的紀錄時列表底部會出現「載入更多」按鈕。套了篩選卻顯示「沒有符合條件的日誌」時，若下方仍有「載入更多」，代表較舊的紀錄還沒掃完——提示文字「紀錄由新到舊掃描，較舊的符合項目需要再次載入。」就是這個意思，多按幾次「載入更多」即可。

幾種空畫面的意思：

ARN 欄位的「複製」與「開啟連結」¶

許多詳細頁會顯示一串以 arn:aws:... 開頭的 ARN (Amazon Resource Name)。ARN 是 AWS 給每個資源或每次執行的唯一識別字串，可想成一張「收據編號」，用來精準指認某個對象。會在不同頁面看到名稱不同、但長相一致的 ARN 欄位，常見有三種：

• 執行結果頁的「執行 ARN」：指「某一次工作流程執行」這個事件。

  

• 工作流程詳細頁的「狀態機器 ARN」：指「這條工作流程本身」。

  

• Lambda 函式詳細頁的「Lambda ARN」：指「一個 Lambda 函式」這個資源。

  

不論哪一種，欄位旁通常都有兩個按鈕：