分代理是你隨時可調用的專業代理。 輸入 /agent 聊天,選擇你的專家,然後提出你的問題。 例如,你可以調用資料庫專家來處理 SQL 問題,或請資安稽核員進行威脅調查。
與技能(技能總是可用)不同,子代理人需要明確的召喚。 此要求將專業範圍限定於特定任務。
次代理的運作方式
在聊天中使用斜線指令呼叫子代理 /agent 。 次級代理人能接收完整的對話脈絡,並以專注的專業態度工作。
以下範例展示了一個基本的子代理人定義:
name: database_expert
system_prompt: |
You are a database specialist. Analyze query performance,
diagnose connection issues, and recommend optimizations.
handoff_description: Handles SQL and database troubleshooting
tools:
- execute_kusto_query
- azure_cli
connectors:
- azure_sql
enable_skills: true # Can use skills for additional expertise
agent_type: Review # ReadOnly | Review | Autonomous
主要特性包括:
-
system_prompt:專家角色與指示。 -
handoff_description:策劃者在決定委派時所看到的。 -
tools:可用能力。 -
enable_skills讓這個子代理能動態存取技能。 -
agent_type: 控制動作(唯讀、審查、自主)。
小提示
技能是自動產生的:你的代理人會在相關時使用。
子代理具有明確的功能:當您需要獲得專注的專業知識時,利用 /agent 啟動它們。
為什麼要用次代理
子代理可以讓你將領域的專業知識、工具和知識打包,供再利用。 與其讓主要代理人處理所有事務,不如委派給專家。
以資料庫問題為例:沒有子代理,你的主代理會嘗試通用的故障排除。 有了「資料庫專家」子代理,你可以獲得專精的 SQL 專長、資料庫專用的跑手冊,以及專為查詢分析調整的工具。
子代理也能啟用 切換鏈。 你的事件分流分級代理會將問題分類,並交接給適當的領域專家。 領域專家會進行調查,然後交接給通知路由器。 每個步驟都是專門的。
建立一個子代理人
在 Builder > Subagent Builder 中建立子代理人。
請在 Azure 入口網站中找到您的 Azure SRE 代理程式。
選擇 「分代理建構者 」標籤。
選取 ,創建。
選擇 副代理人。
請提供以下設定的數值:
房產 價值 名稱 請為您的子代理輸入具描述性的名稱。 操作說明 提供明確且客製化的指示,定義次級代理人應如何行為。 交接說明 說明其他子代理人應將處理轉移給該代理人的情況及其原因。 自訂工具(選用) 為子代理人在作業期間選擇一個或多個自訂工具。 內建工具(選用) 選擇任何你希望子代理能使用的任何內建系統工具。 交接代理(選用) 指定哪個子代理在完成任務後應接手處理。 你可以選擇啟用 知識庫 功能。 此選項允許您上傳檔案,供分代理在回答查詢時作為參考資料。
知識庫管理
透過上傳文件、執行手冊和程序指南,提升子代理人的知識。
你可以添加到代理的檔案範例:
- 架構或系統設計:說明系統元件與資料流的圖表與文件。
- 故障排除指南:逐步說明,協助診斷並解決常見或反覆出現的問題。
- 運行手冊與標準作業程序(SOP):詳細的例行作業、維護與事件回應工作流程。
- 事故報告與事後檢討:記錄過去停電,包括根本原因分析及經驗教訓。
- 發布說明與變更日誌:產品或服務更新摘要,包括新功能、錯誤修正及變更。
支援的檔案類型
操作程序以 Markdown (.md) 或文字.txt() 格式呈現。
檔案管理工作流程
- 請前往 設定 > 知識庫 > 檔案 標籤。
- 上傳檔案時,可以拖放檔案或瀏覽選取檔案(每個檔案最多 50 MB)。
- 透過添加標籤和描述來組織內容,以提升搜尋效率。
- 透過設定哪些子代理可以存取特定知識來源,來啟用子代理存取權限。
- 透過追蹤次代理如何利用上傳知識來監控使用情況。
備註
上傳的檔案會自動被索引,並由你的分代理可搜尋。 系統支援每個子代理實例最多 1,000 個檔案。
子 Agent 建立器檢視
在 Builder > Subagent 建置中建立子代理。 可使用下列檢視:
| View | Purpose |
|---|---|
| 畫布視圖 | 視覺圖示,展示子代理、工具與觸發連接 |
| 資料表檢視 | 所有子 Agent 的清單,並提供快速存取 |
| 測試遊樂場 | 互動式測試環境 |
何時使用次代理
下表幫助您判斷何時次級代理人是合適的選擇:
| 案例 | 使用子代理? | 為什麼 |
|---|---|---|
| 需要深厚的領域專業知識 | 是的 | 套件 SQL 專業知識、網路知識、安全最佳實務 |
| 多步驟工作流程 | 是的 | 事件分流、部署驗證、備份驗證 |
| 專用工具組 | 是的 | 資料庫專用工具、成本優化工具 |
| 簡單的單一運算 | No | 用技能來做簡單且可重複的動作 |
| 唯讀查詢 | No | 主代理可以無需委派即可處理 |
關於完整的子代理設定,請參見 事件回應 以了解回應自動化。
子代理交接
當您的主代理將工作轉交給從屬代理時,他們會共享同一個對話上下文。 接收子代理看到:
- 完整對話紀錄:所有先前訊息、工具呼叫及結果
- 子任務推理:交接要求這個子代理完成什麼
- 使用者最初的問題:整個交接鏈程都被保留
備註
子 Agent 不會獲得「全新開始」。它們會延續相同的交談執行緒。 此方法可啟用交接鏈,讓每位專家都能在前一個 Agent 的工作基礎上接續處理。
完成工作後,子代理人會交接給下一位代理人或將控制權交還給編排者。 對話的脈絡在整個鏈條中不斷累積。
次代理模式
下表描述了常見的次代理者模式:
| 樣式 | 範例子代理 | 應用案例 |
|---|---|---|
| 領域專家 | VM 專家、AKS 專家、網路專家 | 在一項技術上有深厚的專業知識(所有虛擬機問題、Kubernetes 故障排除、VNet/NSG/負載平衡器) |
| 任務專家 | 日誌分析器、成本優化器、安全掃描器 | 專注於特定任務(解析日誌、尋找節省、識別漏洞) |
| 工作流程執行器 | 事件分流、部署驗證器、備份驗證器 | 多步驟程序(事件分類、部署後檢查、備份完整性測試) |
比較技能、子代理與知識檔案
下表比較了每種可擴展性概念:
| Feature | Skills | 次代理 | 知識檔案 |
|---|---|---|---|
| Access | 自動 |
/agent 命令 |
透過 KB 查詢工具 |
| 工具 | 可附加 | 有工具 | 沒有工具 |
| 內容 | 使用執行緒上下文 | 共享執行緒上下文 | 僅供參考 |
| 最適合用於 | 程序 | 領域專家 | 運行手冊、文檔 |
請參考以下指引來選擇正確的方法:
- 技能:全隊程序,可選擇執行(AKS 故障排除指南 + Azure CLI)
- Subagent:按需調用的專業範疇專家(PostgreSQL 專家)
- 知識檔案:參考內容以提供上下文(架構文件)
將子代理連接到觸發器
事件或排程任務可自動觸發子代理。 畫布檢視以視覺方式顯示這些連結:觸發器以連結子代理的節點形式出現,工具與其父子代理分組,狀態徽章顯示活躍或非活躍狀態。
關於設定細節,請參閱事件回應以連結子代理與事件,或排定的任務以進行定期自動化。
次代理模式
每個子代理人可以根據你想要賦予的自主程度,以不同的模式運作。
| 模式 | 說明 |
|---|---|
| 唯讀 | 只能查詢和分析,不能做任何動作 |
| 檢閱 | 提出行動建議,等待批准 |
| 自治 | 未經人類同意的行為 |
根據子代理人的風險等級設定模式:
- 日誌分析? 唯讀(最安全)
- 有什麼成本優化建議嗎? 審查(需人工批准)
- 經過充分測試的自動化? 自主(用於受信任操作)
測試與開發子劑
部署前先在 測試遊樂場 測試子代理。 進入 Builder > Subagent 建置 器,從檢視切換中選擇 測試遊樂場 。 分割畫面的佈局讓你在左側編輯指令,並在右側即時聊天中測試,並透過 AI 評估來評分你的設定。
對於 VS Code 使用者,SRE Agent MCP 伺服器擴充功能允許你在編輯器中編輯子代理的 YAML,並將變更同步到你的代理程式。
完整詳情請參閱 特工遊樂場。