Azure SRE 代理中的自訂代理

客製化代理人是你隨時調用的專業代理人。 輸入 /agent 聊天，選擇你的專家，然後提出你的問題。 這個流程讓你能接觸到資料庫專家處理 SQL 問題，以及安全稽核員進行威脅調查。

不同於技能 (永遠可用)，自訂 Agent 需要明確調用。 此要求將專業範圍限定於特定任務。

Agent Canvas 的截圖顯示自訂代理連接到觸發器和工具。

自訂代理程式的運作方式

在聊天中使用 slash 指令呼叫自訂代理 /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

主要特性包括：

  • system_prompt：專家角色與指示。
  • handoff_description：策劃者在決定委派時所看到的。
  • tools：可用能力。
  • enable_skills：當你使用這個屬性時，客製化代理人可以動態存取技能。

小提示

技能是自動產生的。 你的經紀人在相關時會使用這些資料。 客製化代理具明確性 的——當你需要針對性的專業知識時，你可以使用 /agent 來調用它們。

為什麼要使用客製化代理

客製化代理讓您能將領域專業知識、工具與知識打包，供再利用。 與其讓主要代理人處理所有事務，不如委派給專家。

考慮資料庫問題：沒有自訂代理，你的主代理會嘗試通用的故障排除。 有了「Database Expert」自訂代理，你可以獲得專注的 SQL 專長、資料庫專屬的 runbook 以及專為查詢分析調整的工具。

自訂代理也能實現 交接鏈。 您的事件分流客服人員會將問題分類，交給適當的領域專家，由他們調查，然後交接給通知路由器。 每個步驟都是專門的。

建立自訂代理

在 Builder > Agent Canvas 中建立自訂代理。

  1. 請在 Azure 入口網站中找到您的 Azure SRE 代理程式。

  2. 選擇 Agent Canvas 標籤。

  3. 選取 ，創建。

  4. 選擇 客製化代理人。

  5. 請提供以下設定的數值：

    房產 價值
    名稱 輸入一個描述性名稱為你的自訂代理。
    操作說明 提供明確且客製化的指示，定義客製代理人應如何行為。
    交接說明 請說明其他自訂代理程式應將處理轉移到此自訂代理程式的情境及其原因。
    自訂工具（選用） 選擇一個或多個客製化工具供客服人員在運作期間使用。
    內建工具（選用） 選擇任何你希望自訂代理能存取的內建系統工具。
    交接代理（選用） 指定該自訂代理完成任務後，應由哪位自訂代理接手處理。

    你可以選擇啟用 知識庫 功能。 此選項允許您上傳檔案，讓您的客製化代理人在回答查詢時可作為參考資料。

知識庫管理

透過上傳文件、跑程手冊及程序指南，提升您的客製代理人的知識。

你可以添加到代理的檔案範例：

  • 架構或系統設計：說明系統元件與資料流的圖表與文件。
  • 故障排除指南：逐步說明，協助診斷並解決常見或反覆出現的問題。
  • 運行手冊與標準作業程序（SOP）：詳細的例行作業、維護與事件回應工作流程。
  • 事故報告與事後檢討：記錄過去停電，包括根本原因分析及經驗教訓。
  • 發布說明與變更日誌：產品或服務更新摘要，包括新功能、錯誤修正及變更。

支援的檔案類型

操作程序以 Markdown （.md） 或文字.txt（） 格式呈現。

檔案管理工作流程

  1. 請前往 設定 > 知識庫 > 檔案 標籤。
  2. 上傳檔案時，可以拖放檔案或瀏覽選取檔案（每個檔案最多 50 MB）。
  3. 透過添加標籤和描述來組織內容，以提升搜尋效率。
  4. 透過設定哪些自訂代理可以存取特定知識來源，來啟用自訂代理存取權限。
  5. 透過追蹤客服人員如何利用上傳的知識來監控使用情況。

備註

你的客製化代理會自動索引並讓你上傳的檔案可搜尋。 系統支援每個自訂代理實例最多 1,000 個檔案。

Agent Canvas 檢視

在 Builder>Agent Canvas 中建立自訂代理。 可使用下列檢視：

View Purpose
畫布視圖 視覺化圖表，展示自訂代理、工具與觸發連接
資料表檢視 所有具備快速存取功能的客製化代理列表
測試遊樂場 互動式測試環境

何時使用客製代理

下表幫助你判斷何時由客製代理人擔任合適選擇：

案例 使用自訂代理？ 為什麼
需要深厚的領域專業知識 是的 套件 SQL 專業知識、網路知識、安全最佳實務
多步驟工作流程 是的 事件分流、部署驗證、備份驗證
專用工具組 是的 資料庫專用工具、成本優化工具
簡單的單一運算 No 用技能來做簡單且可重複的動作
唯讀查詢 No 主代理可以無需委派即可處理

欲了解完整的客製化代理設定，請參閱 事件回應 以了解回應自動化。

自訂 Agent 交接

當主要 Agent 交接給自訂 Agent 時，它們會共用單一交談內容。 接收的報關代理會看到：

  • 完整對話紀錄：所有先前訊息、工具呼叫及結果。
  • 子工作推斷：交接要求此自訂 Agent 完成的內容。
  • 使用者的原始問題：會在整個交接鏈中保留。

備註

自訂 Agent 不會取得「全新空白狀態」。它們會延續相同的交談對話串。 此方法可啟用交接鏈，讓每位專家都能在前一個 Agent 的工作基礎上接續處理。

完成工作後，客製化代理會交接給下一位代理或將控制權交還給編排者。 對話的脈絡在整個鏈條中不斷累積。

自訂代理模式

下表說明常見的自訂代理模式：

樣式 Examples 應用案例
領域專家 VM 專家、AKS 專家、網路專家 在一項技術上有深厚的專業知識（所有虛擬機問題、Kubernetes 故障排除、VNet/NSG/負載平衡器）
任務專家 日誌分析器、成本優化器、安全掃描器 專注於特定任務（解析日誌、尋找節省、識別漏洞）
工作流程執行器 事件分流、部署驗證器、備份驗證器 多步驟程序（事件分類、部署後檢查、備份完整性測試）

比較技術、自定義代理和知識文件

下表比較了每種可擴展性概念：

Feature Skills 自訂代理程式 知識檔案
Access 自動 /agent 命令 透過 KB 查詢工具
工具 可附加 有工具 沒有工具
內容 使用執行緒上下文 共享執行緒上下文 僅供參考
最適合用於 程序 領域專家 運行手冊、文檔

請參考以下指引來選擇正確的方法：

  • 技能：全隊程序，可選擇執行（AKS 故障排除指南 + Azure CLI）
  • 自訂代理：按需調用的範圍專家（PostgreSQL 專家）
  • 知識檔案：參考內容以提供上下文（架構文件）

將自訂代理連接到觸發器

事件或排程任務可自動觸發自訂代理程式。 畫布檢視會以視覺化方式顯示這些連結：觸發器會以連結自訂代理的節點出現，工具會與其父自訂代理分組，狀態徽章則顯示啟用或非啟用狀態。

關於設定細節，請參閱事件 回應 以連結自訂代理與事件，或排 程任務 以支援持續自動化。

自訂代理模式

每個自訂代理都依據模式運行，以控制其自主權的程度。 為每個回應計畫或排程任務設定模式。

模式 說明
檢閱 提出行動建議，等待批准
自治 未經人類同意的行為

根據風險選擇模式：

  • 有什麼成本優化建議嗎？ 使用 審查 （需人工核准）。
  • 經過充分測試的自動化？ 使用 自主 （用於受信任的操作）。

為每個回應計畫或排程任務設定模式。 不要在自訂代理的 YAML 定義中設定模式。 更多資訊請參見 「運行模式」。

測試與開發客製化代理

部署前先在 測試遊樂場 測試自訂代理程式。 進入 Builder>Agent Canvas ，從檢視切換中選擇 測試遊樂場 。 分割畫面的佈局讓你在左側編輯指令，並在右側即時聊天中測試，並透過 AI 評估來評分你的設定。

對於 VS Code 使用者，SRE Agent MCP 伺服器擴充功能允許你在編輯器中編輯自訂代理 YAML，並將變更同步到你的代理程式。

Agent Playground 的截圖，搭配分割畫面編輯器和聊天測試面板。

完整詳情請參閱 特工遊樂場。

相關內容

資源 說明
技能 可重複使用的業務員程序與工具
發送通知 將調查結果傳送到 Teams、Outlook 等平台
用你的工具聊天 透過 Teams、webhook 等平台與你的客服互動
  • Last updated on