跳轉到

Agent

這頁能幫你做什麼

Agent 是一個能對話、會自己決定要不要查資料或呼叫工具的 AI 助理。建好之後就能在平台各處重複使用：可以直接開聊天視窗跟它對話、被工作流程 (Workflow) 當成一個步驟呼叫，也可以被其他 Agent 當成子工具委派。Agent 的入口在左側最上層的「Agents」（與「資源」並列），不在「資源」清單裡。

舉例來說，你可以建一個「客服小幫手」Agent，接上公司的知識庫 (Knowledge Base) 回答客戶問題；或建一個「報告產生器」Agent，讓它在對話中幫你跑工作流程產出週報。

這一頁只講「Agent 的設定欄位」

本頁聚焦在建立 Agent 時，表單上每一個欄位該怎麼填。 Agent 的完整建立流程、各種工具 (Tool) 的逐項設定、實際對話操作等，請見：

Agent 的入口在最上層「Agents」，不在「資源」清單內

雖然 Agent 能像資源一樣在平台各處重複使用，但它在左側選單是與「資源 (Resources)」「工作流程 (Workflows)」並列的最上層項目「Agents」。「資源」清單頁裡沒有 Agent 這個分類。請到最上層的 Agents 區去建立與管理 Agent，不要在資源清單裡找。

開始前

需要先準備的資源

  • 大型語言模型 (LLM)：每個 Agent 至少要指定一個 LLM 資源當大腦，請先到 LLM 資源 建立。
  • （選用）工具會用到的資源：如果要讓 Agent 查知識庫、呼叫工作流程、掛技能 (Skill) 等，請先把對應資源建好，再回到這裡選用。

操作步驟

  1. 在左側最上層選單點「Agents」進入 Agent 清單頁，點建立入口（空清單時是有文字的建立按鈕；清單已有項目時是右上角無文字的「+」圖示）。完整建立流程見建立 Agent。

    Agent 建立表單

  2. 填寫「名稱」，並在「大型語言模型」選一個 LLM 資源。

  3. （選用）填寫「描述」與「Agent 提示詞」，定義這個 Agent 的角色與行為。
  4. （選用）展開「內建工具」「自訂工具」摺疊區塊，挑選要開啟的工具。
  5. （選用）展開「進階設定」調整模型切換、對話輪數與工具使用次數上限。
  6. （選用）展開「介面設定」自訂聊天視窗的標題、頭像與提示文字。
  7. 按「儲存」完成建立。

完整欄位說明

表單最上方是基本欄位，下方則是四個可展開的摺疊區塊（內建工具、自訂工具、進階設定、介面設定）。

基本欄位

欄位 必填 預設 說明
名稱 是 無 這個 Agent 的識別名稱。上限 64 字元，不能以 default 開頭。
大型語言模型 是 無 Agent 預設使用的 LLM 資源，等於它的大腦。從清單選一個你建好的 LLM。
描述 否 空白 當這個 Agent 被「其他 Agent」當成工具呼叫時，給對方 LLM 看的說明。上限 4096 字元。若呼叫端自己填了描述，會以呼叫端為準、此欄被忽略。一般單獨使用時可留空。
Agent 提示詞 否 空白 系統提示詞，用來定義 Agent 的角色、語氣與行為規則（例如「你是 Acme 公司的客服，回答要有禮貌並引用知識庫」）。支援 Jinja 範本語法。留空則使用模型預設行為。

「Agent 提示詞」欄位的工具列與「改寫」

把滑鼠移到「Agent 提示詞」輸入框，右上角會出現編輯器工具列（複製 、下載 、自動換行 、放大編輯 ），以及 「改寫」可請 AI 幫你優化提示詞。工具列說明見通用介面元件 — 編輯器工具列，改寫用法見 Agent 提示詞的改寫功能。

平台預先提供的一組工具，在「內建工具」區塊用勾選的方式啟用。全部預設關閉，要用哪個就勾哪個。部分工具（Bash、瀏覽器、程式碼）勾選後可在該列的選單再展開調整細項。

內建工具 預設 可調細項 說明
讀取網址 關閉 無 讓 Agent 直接擷取並讀取一個網址的內容。
技能 關閉 無 讓 Agent 載入「自訂工具」中所掛技能的內容。當你在自訂工具加入技能時，此項會自動被開啟。
向使用者提問 關閉 無 讓 Agent 在對話中途向使用者提出後續問題以補齊資訊。
任務 關閉 無 讓 Agent 透過內建任務工具建立、更新與追蹤任務。
讀取檔案 關閉 無 讓 Agent 讀取工作空間內的檔案。
寫入檔案 關閉 無 讓 Agent 寫入工作空間內的檔案。
Glob 關閉 無 讓 Agent 依檔名或路徑模式在工作區中尋找檔案。
Grep 關閉 無 讓 Agent 在工作區檔案內容中搜尋文字或正規表示式。
程式碼 關閉 執行環境 讓 Agent 執行程式碼片段。詳見下方「程式碼工具的執行環境」。
瀏覽器 關閉 瀏覽器最長逾時秒數、瀏覽器最大輸出字元數 讓 Agent 操作無頭瀏覽器瀏覽並操作網頁。詳見下方「Bash 與瀏覽器的細項」。
Bash 關閉 Bash 最長逾時秒數、Bash 最大輸出字元數、Bash 封鎖指令 讓 Agent 執行 shell 指令。僅管理員可見與設定。詳見下方「Bash 與瀏覽器的細項」。

Bash 與瀏覽器會實際執行程式碼

Bash 與瀏覽器工具會在環境中執行指令或操作網頁，請只對信任的 Agent 開啟。Bash 可用「Bash 封鎖指令」擋掉不希望被執行的危險指令。

Bash 與瀏覽器的細項

欄位 適用工具 必填 預設 範圍 說明
Bash 最長逾時秒數 Bash 是 120 1–3600 單一指令最久跑多久，超過就中止。
Bash 最大輸出字元數 Bash 是 30000 最小 1 指令輸出最多保留多少字元，超過會截斷。
Bash 封鎖指令 Bash 否 空（無封鎖） — 一份不允許執行的指令清單，用來擋掉危險操作。
瀏覽器最長逾時秒數 瀏覽器 是 120 1–3600 單次瀏覽器操作的逾時秒數。
瀏覽器最大輸出字元數 瀏覽器 是 30000 1–1000000 瀏覽器回傳內容最多保留多少字元。

程式碼工具的執行環境

程式碼工具勾選後，可在「執行環境」二選一：

執行環境 預設 說明
AgentCore 程式碼直譯器 是（預設） 使用 AgentCore 程式碼直譯器執行程式碼。
安全模式 否 在受限制的 Python 沙箱中執行，僅允許基本語法與內建函式，禁止網路請求、系統指令與檔案存取等高風險操作。適合資料清洗、格式轉換等常見處理，較安全穩定但功能受限。

自訂工具（摺疊區塊：自訂工具）

「自訂工具」區塊讓你把外部資源接成 Agent 可呼叫的工具，可選的類型包含：檢索、搜尋引擎、MCP 伺服器、工作流程、技能、Lambda、API、HTTP、Agent（子 Agent）、Athena、OpenSearch、MySQL。

每一種類型的欄位較多、各自不同，完整逐項設定請見 工具總覽 與其下的各分頁：

掛技能的方式另見 技能工具 與本系列的 Skill 資源。

進階設定（摺疊區塊：進階設定）

欄位 必填 預設 範圍 說明
啟用大型語言模型切換 否（開關） 關閉 開／關 開啟後，使用者在對話時可自行切換不同的 LLM。關閉時 Agent 固定使用上方選的「大型語言模型」。
可切換的大型語言模型 開關開啟時為必填 無 — 開啟切換後才會出現，挑選使用者可切換的 LLM 清單。上方選的預設 LLM 一定會在清單內且不能移除。
最大對話輪數 是 10 1–100 單一工作階段最多可累積幾輪對話。達到上限後新對話會被拒絕，舊訊息不會被刪掉；要繼續請開新工作階段。
最大工具使用次數 是 30 1–200 單輪對話內 Agent 最多可呼叫工具幾次。設太低可能在複雜任務中途停手，設太高會增加耗時與成本。

介面設定（摺疊區塊：介面設定）

這一區設定的是「聊天視窗的外觀與引導文字」，不影響 Agent 的推理能力。

欄位 必填 預設 說明
標題 否 無 聊天開始時顯示的標題。上限 64 字元。
描述 否 無 聊天開始時顯示的描述（歡迎語），支援 Markdown 語法。
輸入框提示文字 否 無 聊天輸入框內的灰字提示（例如「輸入你的問題…」）。上限 32 字元。
頭像 否 機器人圖示 上傳一張圖當 Agent 在聊天時的頭像，會取代預設的聊天圖示。

實際範例

建立一個最小可動的客服 Agent：

  1. 名稱：customer-support-agent
  2. 大型語言模型：選一個你建好的 LLM 資源。
  3. Agent 提示詞：你是 Acme 公司的客服助理，請依知識庫內容準確、有禮貌地回答問題。
  4. 自訂工具：加入一個「檢索」工具，指向你的支援知識庫（設定方式見 檢索工具）。
  5. 介面設定：標題填「客服小幫手」、輸入框提示文字填「有什麼可以幫您的嗎？」。
  6. 儲存後即可開聊天視窗測試。

預期結果：使用者提問時，Agent 會先查知識庫再作答；對話視窗會顯示你設定的標題與提示文字。

下一步