技能工具¶
Skill（技能）是一份可重複使用的「做事指引」，用文字（Markdown）寫成。把常用的規範或步驟寫成 Skill，再掛到 Agent 上，需要時 Agent 才會載入來看——平常不佔用對話空間。
適合用來放：固定的回覆語氣規範、某類任務的處理步驟、品牌用語守則等。
運作方式（兩段式）¶
- 平常只看目錄：Agent 一開始只知道「有哪些 Skill、各自在講什麼」（名稱＋描述），不會讀全文。
- 需要時才載入：當 Agent 判斷某個 Skill 派得上用場，才把它的完整內容讀進來，然後照著做。
這樣即使你準備了很多 Skill，也不會一次塞爆對話、影響效能。
設定步驟¶
- 建立 Skill 資源：寫好名稱、描述與內容（Markdown）。見 Skill 資源。
-
掛到 Agent：在 Agent 設定的「自訂工具」中，新增一個「技能」（Skill）工具，選擇要用的 Skill 資源。
-
開啟內建的技能工具：到「內建工具」區塊把「技能」勾選起來。這是 Skill 生效的必要開關。
一定要開內建的「技能」工具
只把 Skill 掛進自訂工具還不夠。必須同時在「內建工具」勾選「技能」，Agent 才能載入 Skill 內容。沒開的話，掛上的 Skill 會被直接忽略。詳見 內建工具。
關鍵欄位（建立 Skill 資源時）¶
下表是建立 Skill 資源頁面（Skill 資源）的欄位，不是 Agent 設定裡「新增技能工具」對話框的欄位：
| 欄位 | 必填 | 說明 |
|---|---|---|
| Skill name（名稱） | 是 | 好辨識的名稱，不可空白。 |
| Description（描述） | 否（強烈建議） | 說明「什麼時候該用這個 Skill」。Agent 靠它決定要不要載入。 |
| 內容（Markdown） | 是 | 實際的指引內容，最多 100,000 字元。 |
別把兩處欄位搞混
在 Agent 設定的「自訂工具」新增「技能」工具時，那個對話框另有自己的名稱／技能／描述欄位（名稱相近但不是同一處）。上表只描述 Skill 資源的欄位。
描述決定會不會被用到
描述要寫成「使用時機」，例如「回覆客訴時使用」「審查文件時使用」，比只寫主題更有效。
限制¶
| 項目 | 上限 |
|---|---|
| 每個 Agent 可掛的 Skill 數量 | 20（超過的會被靜默忽略，不會報錯） |
| 單一 Skill 內容長度 | 100,000 字元 |
實際效果¶
設定好之後，當使用者的問題符合某個 Skill 的用途，Agent 會先載入該 Skill 的完整內容，再照著指引回覆。下圖是一個掛了「測試技能」的 Agent，使用者要求做測試時，Agent 自動載入並依指引回答：
點開「顯示思考過程」會看到可展開的卡片，依序顯示：
- 使用
LoadSkillContentTool查詢相關資訊：Agent 決定載入哪個 Skill（顯示 Skill ID）。 - 接收
LoadSkillContentTool的查詢結果：載入回來的 Skill 完整內容（名稱與指引）。 - 最後 Agent 依照載入的指引作答。
這正是「平常只看目錄、需要時才載入」的兩段式運作：Skill 內容只在被判斷需要時才讀進對話。
沒載入？檢查兩個開關
若 Agent 沒有載入 Skill，多半是漏了必要設定：確認已在「自訂工具」掛上該 Skill，且在「內建工具」勾選了「技能」。描述寫得越貼近「使用時機」，Agent 越容易在對的時機載入。