內建工具¶

內建工具是平台已經做好、不必另外準備資源、開關即可使用的能力。在 Agent 設定的「內建工具」區塊勾選即可。預設全部關閉，需要哪個就勾哪個。

內建工具清單，每一列是一個工具的勾選框、名稱與說明

可用的內建工具¶

工具	能做什麼
瀏覽器（Browser）	自動操作瀏覽器，瀏覽並操作網頁。
程式碼（Code）	執行程式碼片段做運算或資料處理（可選執行環境，見下方）。
向使用者提問（Ask User Question）	暫停並向使用者提出後續問題，取得補充資訊後再繼續。
任務（Task）	在對話中建立、更新、追蹤任務，協助處理多步驟工作。
技能（Skill）	載入掛在 Agent 上的 Skill 內容。掛了 Skill 就一定要開這個，否則 Skill 不會生效。詳見技能工具。
讀取網址（Read URL）	直接擷取並讀取一個網址的內容。
讀取檔案（Read File）	讀取工作空間內的檔案。
Glob	依照檔名或路徑模式在工作空間中尋找檔案。
Grep	在工作空間檔案內容中搜尋文字或正規表示式。
寫入檔案（Write File）	寫入工作空間內的檔案。
Bash（管理員限定）	在沙箱中執行 shell 指令。此工具僅管理員可見、可開啟；對一般使用者是整列完全不出現（不是變成灰色），所以在清單裡找不到它是正常的。

你的清單只有 10 項是正常的

上表列了 11 項，但一般使用者打開「內建工具」只會看到 10 項——「Bash」僅管理員可見。上方的截圖就是一般使用者看到的樣子（10 項、沒有 Bash）。數目對不上不是你漏設定，也不用去找。

管理員請注意：Bash 在實機清單裡是第 1 列、不是最後一列（上表為了先講一般使用者看得到的十項，才把它排在最後）。

「工作空間」與「沙箱」是什麼

有幾個工具的說明會提到這兩個詞：

工作空間（Workspace）：Agent 在這段對話中專用的一個暫存資料夾。Agent 讀寫檔案、你上傳的附件、它自己產生的檔案都放這裡；不同對話互不相通，也不是你電腦上的資料夾。
沙箱（Sandbox）：一個與外界隔離的執行環境，用來跑程式碼或指令。跑在裡面的東西動不到平台其他資料，就算出錯也只影響那一次執行。

「讀取檔案」、「寫入檔案」、「Glob」、「Grep」、「程式碼」、「瀏覽器」都在這個工作空間／沙箱環境中執行，若環境未啟用對應能力就會用不了。怎麼分辨：

也就是說「勾了卻好像沒作用」有兩種完全不同的原因，先點開「顯示思考過程」看有沒有卡片，再決定要找管理員還是調整 Agent 提示詞。

多數內建工具只有一個「勾選／取消」，沒有其他設定。只有「程式碼」、「瀏覽器」、「Bash」這三個勾選後還可以再調參數——但這些欄位不會直接長在清單裡，要另外開一個小視窗填。操作方式三者相同（該列的選單裡只有「編輯」一項，沒有別的選項）：

先在清單裡把該工具勾選起來——勾選之後，那一列才會多出下面兩個東西（沒勾就都沒有）。
把滑鼠移到那一列上，該列最右端才會浮出操作選單（滑鼠移開就消失，和與 Agent 對話裡「前往聊天」那顆鈕一樣）。點它，選「編輯」，跳出該工具的設定視窗，填好後按「儲存」回到清單。
該列最左端會多一個展開箭頭，點開就能看到目前設好的值，不必再進視窗確認。

「編輯程式碼」對話框，只有一個「執行環境」下拉欄位（值為 AgentCore 程式碼直譯器），右上角有放棄與儲存按鈕

上圖是「程式碼」的編輯視窗（標題為「編輯程式碼」）。「瀏覽器」與「Bash」的視窗長得一樣，只是裡面的欄位不同。

勾了卻沒看到新欄位，是正常的

這三個工具不會在勾選後就地冒出新欄位——清單那一列的外觀幾乎沒變化。要調參數請照上面的步驟開「編輯」視窗；其餘工具（讀取網址、任務、Glob…）本來就沒有任何可調參數，勾選即可用。

「程式碼」的編輯視窗裡有一個「執行環境」（Runtime）下拉選項，兩擇一（下拉打開後每個選項都附一段說明）：

「執行環境」下拉展開，由上而下為「安全模式」與「AgentCore 程式碼直譯器」，各附一段說明文字

選項	說明
安全模式（Safe Mode）	受限制的 Python 沙箱，只允許基本語法與內建函式，禁止網路請求、系統指令、檔案存取等高風險操作。適合資料清洗、格式轉換等常見處理，安全穩定但功能受限。
AgentCore 程式碼直譯器	透過 AgentCore 代管的程式碼直譯器執行（預設值）。畫面上「安全模式」排在它上面。

「瀏覽器」的編輯視窗裡有兩個可調整的欄位：

欄位	預設	說明
瀏覽器最長逾時秒數	120	每個瀏覽器指令的最長執行秒數，範圍 1–3600。
瀏覽器最大輸出字元數	30000	瀏覽器指令輸出的最大字元數，範圍 1–1000000。

「Bash」的編輯視窗裡有三個可調整的欄位（此工具僅管理員可見）：