內建工具¶

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

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

可用的內建工具¶

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

可用工具會因環境而異

上表為一般環境會看到的內建工具。實際清單可能因你的平台版本或環境設定而略有不同（例如部分需要容器／沙箱環境的工具）。「讀取檔案」、「寫入檔案」、「Glob」、「Grep」、「程式碼」、「瀏覽器」都在 Agent 的工作空間／沙箱環境中執行，若環境未啟用對應能力可能無法使用——不確定請洽管理員。

多數內建工具只有一個「勾選／取消」。少數勾選後會多出可調整的選項：

勾選「程式碼」後，會多出一個「執行環境」（Runtime）下拉選項，兩擇一：

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

勾選「瀏覽器」後，會多出兩個可調整的欄位：

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

勾選「Bash」後，會多出三個可調整的欄位（此工具僅管理員可見）：