通用介面元件¶
平台許多頁面共用同一組操作元件——同樣的編輯器工具列、同樣的存檔按鈕、同樣的清單圖示。這頁把這些「到處都會看到」的按鈕與圖示集中說明一次。
編輯器工具列¶
只要欄位是多行文字、程式碼或 JSON（例如 Agent 提示詞、樣板內容、變數的 JSON 值、程式碼任務、LLM 訊息等），輸入框右上角就有一排工具列（一直顯示，不必把滑鼠移上去）。這類欄位左側也會有行號。
哪些要 hover、哪些不用
這排編輯器工具列是一直顯示的；但欄位標籤右側那組「JSONPath」／「JSON」開關剛好相反，平常隱藏、滑鼠移到欄位上才浮現（見任務通用設定 — 欄位的輸入方式切換）。看到別頁寫「把滑鼠移上去」指的都是後者。
| 按鈕 | 作用 |
|---|---|
| 自動換行 | 切換過長的文字是否自動折行顯示。只影響畫面呈現，不會改動內容。再按一次（圖示變為 ）可關閉。 |
| 複製 | 把目前欄位內容複製到剪貼簿，方便貼到別處備份或重複使用。 |
| 下載 | 把目前欄位內容存成檔案下載。欄位沒有內容時無法點選。 |
| 在對話方塊中編輯 | 開啟一個放大的編輯視窗，內容較長時編輯更舒適（見下圖）。 |
點 「在對話方塊中編輯」後會跳出放大視窗，右上角的 可關閉並帶回剛才的編輯結果：
兩個情境限定的按鈕
- 改寫：只出現在提示詞類欄位（Agent 提示詞、LLM 系統提示詞等），可請 AI 依草稿產生更完整的提示詞。多數欄位要先有內容才能按；「Agent 提示詞」是例外，空白時這顆鈕會改成「產生」，直接依 Agent 的名稱與描述生成一版。用法見 用「改寫」讓 AI 幫你優化提示詞。
- 以純文字檢視：只出現在部分物件／JSON 欄位，可在「表單檢視」與「純文字檢視」之間切換。
表單頁首：放棄與儲存¶
建立或編輯任何資源、Agent、任務時，表單右上角固定有兩顆按鈕：
| 按鈕 | 作用 |
|---|---|
| 放棄 | 捨棄這次的變更並離開。若有未儲存的修改，瀏覽器會再次跳出確認，避免誤刪。 |
| 儲存 | 儲存目前表單內容。必填欄位（標示 *）未填妥時無法儲存，畫面會在對應欄位顯示提示。 |
資源挑選欄位的編輯圖示¶
當某個欄位要你「選一個既有資源」（例如 Agent 的「大型語言模型」、工具的「連結器」、檢索工具的「知識庫」），欄位右側會有一個 圖示。點它會跳出該資源類型的挑選清單，從中選取後填回欄位。清單裡可搜尋、可看到每個資源的狀態與最後更新時間。
點欄位本身也會開啟同一個挑選清單，不必非得瞄準那顆鉛筆。欄位已經有值時，右側會多出一顆下拉箭頭，按它開的也是同一個挑選清單（不是一般下拉選單）。這些欄位一律是唯讀的，直接打字打不進去。
點下去後會跳出挑選清單，可用上方搜尋框找資源，每一列會顯示資源的「類型」「狀態」與「最後更新」時間；選好一列後按右上角「儲存」即填回欄位。
選取請點該列的其他欄位，不要點「名稱」
每一列的「名稱」那一格是一個連結：點下去不會選取這一列，而是在新的瀏覽器分頁開啟那個資源自己的詳細頁（原本的表單還在，切回原分頁即可繼續）。想要選取這一列，請點該列的其他任一格（或列前面的圓鈕／勾選框），再按對話框右上角的「儲存」。想先確認某個資源的內容再決定要不要用它時，這個連結反而很方便。
選不動的那幾列
有些清單會把不能用的資源停用：那一列前面的圓鈕會變灰、整列選不動，但列上的文字顏色不變，不留意看不太出來。把滑鼠移到變灰的圓鈕上會說明原因（例如載入器的「知識庫」清單會停用已被其他載入器接走的知識庫，提示「知識庫已被其他載入器使用。」）。所以清單裡選得動的就是可以用的。
表格的新增列按鈕¶
需要逐列填寫的設定（例如 LLM 任務的「對話」訊息、API／Lambda 工具的「輸入結構」、資料集的「欄位」），會以表格呈現，表格下方有一顆紫色的 按鈕。每一列通常可再用 編輯、 刪除。
點紫色的 按鈕後，會跳出該列的設定小視窗讓你填寫各欄位，按右上角「儲存」即新增一列回表格（部分表格則是直接在表格內新增一列填寫）。
「標籤」欄位：給資源分類¶
「標籤」是你自己貼給某個項目的分類小標，例如把所有客服相關的資源都貼上 客服。貼過之後，清單頁就能用標籤把同一群項目一次篩出來，不必靠名字硬記，也不必把用途硬塞進名稱裡。
哪裡會看到它： Agent、工作流程，以及每一種資源（大型語言模型、知識庫、載入器、連結器、變數…）的建立與編輯表單都有這個欄位，位置在表單上半部的基本欄位裡，不在「進階設定」之類的摺疊區塊中。確切排在哪一欄各表單不同：多數資源表單就在「名稱」的下一欄，欄位較多的表單（資料集、技能、Lambda 函式）把它放在最後一欄，Agent 表單則排在「描述」與「Agent 提示詞」之間——每一頁的欄位表都會寫清楚該表單的實際順序。建立完成後，該項目詳細頁的「一般」頁籤也會多一列「標籤」，把目前貼了哪些標籤以 chip（小標籤）呈現；沒貼過就顯示 -。
怎麼填： 在欄位裡直接打字，按 Enter 就會把它變成一個 chip；要移除某個標籤，點該 chip 右側的 即可。打字時欄位下方會浮出一個下拉，但裡面只有你正在打的那串字——點它跟按 Enter 是一樣的效果。這個欄位不會列出別人已經用過的標籤讓你挑，一律自己輸入，所以團隊最好先講好統一寫法（例如都寫 客服，不要一半寫 客服、一半寫 customer-service），否則篩選時會漏掉。
欄位名稱右側的 提示寫的是：
新增標籤以分類資源，方便日後搜尋與篩選。最多 50 個標籤，每個標籤最多 128 個字元。
| 項目 | 規則 |
|---|---|
| 必填 | 否。完全不貼標籤也能儲存。 |
| 數量上限 | 50 個。超過時欄位下方會出現紅字「此欄位必須小於或等於 50 個項目」，而且無法儲存。 |
| 單個標籤長度 | 1–128 個字元。只要有任一個標籤超過 128 字元，欄位下方就出現紅字「此欄位中的每個項目都必須介於 1 到 128 個字元之間」，同樣無法儲存。超長的那個標籤還是會被加成 chip，不會被擋在欄位外，所以要自己點它的 刪掉，紅字才會消失。 |
| 可以用中文嗎 | 可以。中文、英文、數字都可以，標籤中間也允許空格（例如「財務 報表」會成為一個標籤，不會被切成兩個）。頭尾多餘的空白會自動去掉，只打空白再按 Enter 不會產生標籤。 |
這和 Agent 工具設定裡的「標籤」不是同一件事
Agent 自訂工具的進階設定裡另有一個同名的「標籤」欄位（見檢索工具、搜尋引擎工具、Lambda 函式工具）。那個是給外部程式辨識「這次呼叫的是哪個工具」用的技術標記，和這裡的分類標籤沒有關係，兩邊各填各的、互不影響。
用標籤篩清單： Agents、工作流程與每一個資源子清單的搜尋框都可以改用「標籤」當篩選欄位：點搜尋框，在下拉選單選「標籤」，接著選比對方式，最後輸入要找的標籤文字並按 Enter。比對方式有「等於」、「不等於」、「包含」三種，所以完全相符或只要包含都做得到，由你自己選——要精準只看貼了 客服 的項目就用「等於」；只記得標籤裡有「客服」兩個字就用「包含」。搜尋列的完整操作見清單頁的共用操作。
側邊欄與畫面外框¶
登入後，畫面左側固定是側邊欄（導覽選單），上方橫條只顯示你目前所在位置的麵包屑（例如「Agents」），沒有其他按鈕。側邊欄由上而下最多分成四段（依你的權限增減），段與段之間用一條細分隔線隔開。畫面上只有分隔線、沒有段落標題，下表的段落名稱是本手冊為了說明而加的：
| 段落 | 項目 |
|---|---|
| 開新對話 | 新的對話（最上方那條有漸層底色的項目） |
| 建立與管理你的成果 | Agents、工作流程、工作流程樣板（僅管理員可見）、資源 |
| 平台管理（僅管理員可見） | 群組、使用者、身分驗證、應用程式 API 金鑰、用量 |
| 探索與試玩 | 案例、遊樂場 |
最上方的「新的對話」是 Copilot 的入口：點它會進入一個對話畫面，用白話描述你想要的功能，由 Copilot 幫你把 Agent 設定好。這一項所有使用者都看得到，不限管理員；已經在 Copilot 畫面時再點它，等於把目前這段對話丟掉、重新開始一段新的。
看不到某些項目是正常的
側邊欄的項目會依你的權限與這套平台的部署方式增減：「工作流程樣板」與整段管理項目（群組、使用者、身分驗證、應用程式 API 金鑰、用量）只有管理員看得到，所以一般使用者的側邊欄會像上圖一樣少了這些；「案例」「遊樂場」等試玩入口在部分部署環境也不會出現。找不到某一項不代表壞掉，若確實需要用到，請找你的管理員確認權限。
收合成窄軌 (rail)： 點側邊欄右上角的 「切換側欄」，側邊欄會收成一條只有圖示的窄軌，把寬度讓給內容區；把滑鼠移到任一圖示上會浮出該項目的名稱（最上面那顆 浮出的是「新的對話」）。要展開回來，把滑鼠移到窄軌上——最上方的圖章會換成 按鈕，點它即可。收合只在目前這個畫面有效，重新載入頁面後會回到展開狀態，不會被記成偏好設定。
最底部是你的頭像與帳號名稱，點它會展開選單，裡面有帳戶、主題（淺色／深色）、語言（English／正體中文／日本語）、說明與登出。「說明」再往右展開還有一項顯示目前的平台版號（例如「版本 v1.0.25」），點它會把版號複製到剪貼簿（畫面不會出現任何「已複製」提示，選單只是關閉，請自己貼到別處確認），回報問題時很方便。完整項目說明見帳戶概覽 — 怎麼進入。
登入後畫面沒有頁尾
未登入的登入頁底部左邊是版權列，右下角另有「服務條款」與「隱私權政策」兩個連結（兩者是分開的兩塊，不在同一條列上）；登入之後這些都不再出現。若你的環境有提供這兩份文件，登入後改從頭像選單的「說明」進入；部分部署環境不提供，此時「說明」裡可能只剩下版號那一項。
清單頁的共用操作¶
多數清單頁（Agents、工作流程，以及各個資源子清單如大型語言模型、知識庫…）都長得一樣：內容區是搜尋列加一張資料表。
「資源」首頁是分類目錄頁，不是清單頁
從側邊欄進入「資源」時，看到的不是這種清單表格，而是一頁分類目錄（分割器、連結器、大型語言模型、知識庫…），上方只有一個搜尋框與檢視切換鈕，沒有「全部」篩選／重新整理／新增按鈕。要點進某一類（例如「大型語言模型」）後，才會看到下面說的這套共用清單外框。目錄頁的兩種檢視方式見資源概覽 — 實際目錄頁長相。
搜尋列：
| 元件 | 作用 |
|---|---|
| 搜尋 | 輸入關鍵字後按 Enter 才會篩選（詳見下方警告）。套用後關鍵字會變成搜尋框裡一顆可關閉的小方塊，點方塊上的 移除這一個條件，點搜尋框右側的 一次清掉全部條件。 |
| 搜尋框右側的 | 切換要搜尋哪一個欄位。可選欄位隨清單而異，例如 Agents 與工作流程是「名稱」「ID」「標籤」「狀態」、大型語言模型是「名稱」「ID」「類型」「模型」「標籤」「狀態」、群組是「名稱」「描述」「角色 ARN」「優先順序」。選到部分欄位時，同一個搜尋框會接著讓你選比對方式（「等於」「不等於」「包含」），用來決定關鍵字要完全相符還是只要包含即可——不是在搜尋框旁邊另外多一個下拉。Agents、工作流程與每一個資源子清單都可以用「標籤」篩選，用法見「標籤」欄位。 |
| 「全部」篩選 | 下拉選單，只有兩個選項：「全部」顯示所有項目，「常用」只顯示你已加入我的最愛（ 已填滿）的項目。這不是狀態篩選——要只看某個狀態，請把上面的搜尋欄位切換成「狀態」。 |
| 重新整理 | 重新載入清單，取得最新狀態。 |
| 新增 | 建立一個新項目，進入該類型的建立畫面或選單。這是一顆只有 ＋ 圖示、沒有文字的紫色圓鈕，畫面上看不到「新增」或「建立」這幾個字；本手冊在管理區各頁一律稱它「建立」，指的都是這一顆。 |
打完字一定要按 Enter，清單才會篩選
只把關鍵字打進搜尋框、不按 Enter 的話清單完全不會變——實測在 Agents 清單打「客服」等了 6 秒，10 筆還是 10 筆、網址也沒變；按 Enter 之後才篩成 2 筆、網址帶上 ?q=客服。這一點很容易被誤判成「搜尋壞了」。用欄位＋比對方式的條件也一樣要按 Enter。
條件套用後會寫進網址，所以重新載入或把網址傳給別人，都會回到同一組篩選結果，可以直接存成書籤。
每一列： 最左邊的 我的最愛一直都在；「前往」與 更多平時不顯示，把滑鼠移到那一列上才會浮出在列的右側（因此上圖裡看不到）。
| 圖示 | 作用 |
|---|---|
| 我的最愛 | 把這個項目加入／移出「我的最愛」，方便之後快速找到。已加入時圖示會填滿。 |
| 前往（如「前往聊天」） | 直接跳到該項目最常用的下一步（Agent 是前往聊天）。 |
| 更多 | 開啟該列的操作選單，常見項目如下圖：編輯、複製、檢視用量分析、刪除（不同類型項目選項略有差異）。 |
清單底部的分頁控制： 表格一次只顯示一頁，預設每頁 10 筆。清單底部右側由左到右是 上一頁、目前頁碼、 下一頁，再往右是「每頁筆數：」下拉（可選 10、20、50、100，部分清單另有 200）。
清單看起來「只有 10 筆」通常是分頁，不是資料不見了
項目超過 10 個時，第 11 個之後不會出現在第一頁。找不到某個項目時，先確認三件事：翻到下一頁、把「每頁筆數」調大、或直接用搜尋框找。管理區的使用者、群組與金鑰清單特別容易踩到這點。
部分清單（例如群組詳細頁的「資源建立」分頁）用詞略有不同，寫成「每頁項目：」並在旁邊顯示「41 條中的 1~10 條」這樣的總筆數提示，作用完全一樣；這種清單的分頁列還多兩顆 第一頁與 最後頁。
詳細頁的卡片收合¶
點進任何項目的詳細頁後，多數資訊卡片（如「詳細資料」）右上角都有一個（）收合鈕（少數卡片沒有，例如執行結果頁的「目次」與「執行」卡片）。點它可把整張卡片收起來、只留標題，方便在資料很多時聚焦在你要看的區塊；再點一次（）展開。詳細頁標題旁同樣有（）我的最愛可切換收藏。
ARN 欄位的「複製」與「開啟連結」¶
許多詳細頁會顯示一串以 arn:aws:... 開頭的 ARN (Amazon Resource Name)。ARN 是 AWS 給每個資源或每次執行的唯一識別字串，可想成一張「收據編號」，用來精準指認某個對象。你會在不同頁面看到名稱不同、但長相一致的 ARN 欄位，常見有三種（下方圖中的 ARN 值皆為示意）：
-
執行結果頁的「執行 ARN」：指「某一次工作流程執行」這個事件。
-
工作流程詳細頁的「狀態機器 ARN」：指「這條工作流程本身」。
-
Lambda 函式詳細頁的「Lambda ARN」：指「一個 Lambda 函式」這個資源。
不論哪一種，欄位旁通常都有兩個按鈕：
| 按鈕 | 作用 |
|---|---|
| 複製 | 把這串 ARN 複製到剪貼簿。這是一般使用者最常用的按鈕——複製後可貼到其他步驟（例如 查看工作流程執行 的「執行 ARN」欄）使用。 |
| 開啟連結 | 在新分頁開啟 AWS 管理主控台 (AWS Console) 中對應這個 ARN 的頁面（如 Step Functions 的執行詳情、Lambda 函式頁）。 |
「開啟連結」是給握有底層 AWS 帳號的人用的，一般使用者通常會看到錯誤頁
連到的是平台底層那個 AWS 帳號的主控台，不是你自己的 AWS 帳號。一般 LangForge 使用者在那個 AWS 帳號沒有登入權限，點下去多半會落到 AWS 登入頁、「存取被拒 (Access Denied)」或一個錯誤頁面——這是正常現象，不代表平台或你的設定有問題。
這個按鈕主要是給負責維運、實際持有底層 AWS 帳號存取權的管理員快速跳轉用的。一般使用者不需要點它：
- 想拿這串 ARN 去別的步驟用 → 按 複製即可。
- 想看某次執行跑得如何 → 直接用平台自己的畫面（執行結果頁的「歷史」「執行流程圖」「串流輸出」分頁），完全不必進 AWS 主控台。