在這個教學中，你會建立一個自訂技能，為你的代理人加入領域知識和任務手冊。 技能是你的代理程式在相關時自動載入的模組化能力，例如排除特定服務故障或執行診斷程序。
在本教學課程中，您將瞭解如何：
- 在子代理建構器中創建技能
- 用 SKILL.md 寫技能指示
- 新增支援檔案與工具
- 在聊天室或遊樂場測試這項技能
- 編輯現有技能
預計時間：10分鐘
小提示
技能文件與知識文件共同作用。 一項 技能 會教你的代理人 如何 做某件事（程序、操作手冊、逐步指示）。 知識文件會教導你的代理人所需的知識（參考資料、架構文件、運行手冊）。 你也可以直接將參考文件附加到技能上作為輔助檔案。 關於知識上傳流程，請參見 「上傳知識文件」。
先決條件
開始之前，請確定您有下列必要條件：
- 一個在 Azure SRE 代理入口網站建立的代理程式。
- 清楚了解你想編碼的程序或領域知識。
導航至子代理構建器
打開子代理建構器，在那裡你可以創建和管理技能。
- 開啟 SRE代理入口。
- 選擇您的專員。
- 在左側導覽中選擇 建築師 。
- 選擇 分代理建構器。
開始技能創建
從工具列開始技能創建流程。
- 在工具列中選擇 「建立 」下拉選單。
- 選擇 技能。
技能創建對話框以兩欄格式開啟。 其中一側是表單欄位，而另一側則顯示 SKILL.md 的程式碼編輯器。
請輸入名稱與描述
提供一個名稱和描述，幫助代理人決定何時使用這項技能。
| 領域 | 範例值 |
|---|---|
| 名稱 | high-cpu-troubleshooting |
| 說明 | 「容器應用程式高 CPU 警報的故障排除程序。 檢查上游相依性、連線池及近期部署。」 |
名字必須在你的技能中獨一無二。 描述會出現在技能列表中，幫助特工決定何時使用此技能。
小提示
在描述文字旁選擇 「編輯 」以切換到編輯模式。 完成時，請選取儲存。
撰寫技能指令
中央編輯器顯示 SKILL.md，包含技能指示。 檔案以預設範本開始。
---
name:
description:
---
<!-- Add your skill instructions here -->
YAML 前置項目（name， description， tools）與左側表單欄位保持同步。 請在前言下方用 Markdown 寫下你的指示：
---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
- kusto_query
---
## When to use this skill
Use this skill when you receive a high CPU alert on any container app.
## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings
## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.
新增支援檔案
一側的檔案區段會顯示檔案瀏覽器。 除了預設 SKILL.md的 之外，你可以新增參考資料、範本和範例查詢。
- 選擇 新的檔案 圖示來新增檔案。
- 選擇 新的資料夾 圖示來將檔案組織成目錄。
- 將資料夾拖曳到投放區，或選擇 「上傳資料夾 」連結，即可上傳整個資料夾結構。
在瀏覽器中選擇任一檔案，在程式碼編輯器中編輯。 編輯器支援 Markdown、JSON、YAML、KQL、Python 及 shell 腳本的語法高亮顯示。
選擇工具
可選擇性地附加執行時技能使用的工具。
- 在工具區塊選擇「選擇工具」。
- 瀏覽或搜尋工具。 可依類型篩選（自訂工具、MCP 工具）或依名稱搜尋。
- 檢查這個技能需要的工具（例如，
kusto_query或azure_resource_health）。 - 關閉面板。
已選取的工具會顯示為可移除的藥丸標籤。 這些工具在技能啟動時會動態啟用。
備註
技能新增的工具會在技能啟動時動態開放。 為了更一致的行為，建議直接在子代理上設定工具。
要建立自訂工具，請參見 「建立 Kusto 工具 」或 「建立 Python 工具」。 欲了解更多工具資訊，請參閱工具。
創造技能
選擇 「建立 」以儲存你的技能。
你的技能會出現在子代理人建構器的 技能 標籤中。 代理人現在能在遇到相關情況時自動使用該技能。
測試技能
主代理預設可以使用技能，所以你可以直接在聊天中測試，不用先創建子代理。
在新聊天室測試
用新的聊天串確認代理人是否啟動了你的技能。
- 在側邊欄選擇 「新聊天串 」。
- 輸入一個應該會觸發你技能的提示。 例如：「我們的容器應用程式顯示 CPU 很高，可以調查一下嗎？」
- 確認代理人是否啟動了技能，並遵循你定義的程序。
操場測驗
利用 Playground 透過子代理測試這項技能。
- 建立一個子代理人 並指派這個技能給它。
- 在子 Agent 建立器工具列上，選取測試遊樂場檢視切換。
- 選擇子代理，輸入測試提示詞，並確認它正確使用該技能。
欲了解更多資訊，請參閱 代理遊樂場。
編輯技能
你可以修改現有技能，更新其說明、工具或支援檔案。
在 技能 標籤中，選擇技能名稱，或選擇後選擇 編輯。
編輯對話方塊開啟時，會預先填入所有目前值。 更改你需要的欄位：
要改變什麼 更新位置 當代理人使用它時 說明 與 SKILL.md 說明 應遵循的程序 SKILL.md 編輯器中的內容 有哪些工具可用 工具> 選擇工具 參考資料 檔案> 新增、編輯或移除檔案 選取 [儲存]。
撰寫有效技能的秘訣
請依照以下指引，培養經紀人能有效運用的技能。
- 要明確說明何時使用。 代理人會閱讀描述和指示以判斷相關性。
- 包含逐步的操作步驟。 編號步驟為客服人員提供明確的操作手冊。
- 說明預期輸出。 告訴客服人員結果應該採用什麼格式。
- 新增參考資料。 上傳查詢範本、設定基準線或已知良好值作為支援檔案。
- 分配相關工具。 如果技能需要像 Kusto 查詢或 Azure 動作這類特定工具，就加進去。