前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。對於需要操作雲資源的場景，直接調用 Azure CLI 往往面臨輸出格式非結構化、命令參數繁瑣的問題。wode25500/dsh-az 插件旨在解決這一痛點，它通過封裝 Azure CLI 提供原生工具，讓模型能夠直接讀取結構化數據，並執行 Azure 資源的查詢、展示與部署。

是什麼¶

dsh-az 是一個獨立社區項目，由 WODE25500 維護。它並非 Azure 官方工具，而是基於開源的 Azure/azure-cli（MIT 許可證）構建的 DSH 插件。該插件延續了微軟系生態的主題，爲 DSH 智能體提供了一套管理 Azure 資源的標準化工具鏈。

核心功能¶

插件提供了 7 個原生工具，覆蓋了資源管理的核心場景：

1. az_status：查詢當前狀態。
2. az_subscriptions：管理訂閱信息。
3. az_resource_query：查詢資源。
4. az_show：展示特定資源詳情。
5. az_activity_log：診斷 Azure 活動日誌。
6. az_group_create：創建資源組。
7. az_deploy：部署 Bicep 與 ARM JSON 模板。

除此之外，插件具備以下特性：
* 結構化數據輸出：所有查詢工具均強制使用 --output json，模型可以直接解析返回的 JSON 結構，無需編寫正則或解析邏輯。
* 安全確認機制：對於寫操作（如 group create 和 deploy），插件會顯式請求確認，防止誤操作。
* 模板支持：原生支持 Bicep 和 ARM JSON 模板的部署。

安裝與啓用¶

安裝時，需要在 DSH 的配置中插入一個 ID 爲 az 的工具。該工具指向插件的入口文件，並需配置 Azure CLI 的路徑和訂閱 ID。

- insert:
    - id: az
      name: './src/index.js'
      config:
        azPath: az
        subscription: <your-sub-id>

說明：
* azPath：指定本地 az 命令的路徑。
* subscription：指定操作的默認訂閱 ID。

典型用法¶

基於上述安裝，智能體可以通過以下步驟進行操作：

1. 查詢與展示：使用 az_status 查看全局狀態，或使用 az_resource_query 與 az_show 獲取具體資源的結構化數據。
2. 訂閱管理：調用 az_subscriptions 查看可用訂閱列表。
3. 資源組創建：使用 az_group_create 創建新的資源組（需確認）。
4. 模板部署：使用 az_deploy 上傳並執行 Bicep 或 ARM JSON 模板（需確認）。
5. 日誌診斷：利用 az_activity_log 檢查 Azure 的操作日誌。

適用場景與注意¶

• 適用場景：適合需要在 DeepSeek Harness 環境中自動化管理 Azure 資源的開發者，特別是需要頻繁進行模板部署或資源審計的場景。
• 注意事項：
  • 這是獨立社區項目，非官方出品，使用前建議檢查源碼與許可證。
  • 由於插件以當前 DSH 進程的權限運行，請確保環境安全。
  • 執行寫操作時，務必關注顯式確認的提示，避免意外修改生產環境。

結尾¶

dsh-az 通過將 Azure CLI 封裝爲 DSH 原生工具，降低了智能體操作雲平臺的門檻。它專注於提供結構化數據和安全的部署流程，是 Azure 用戶在 DSH 生態中管理資源的實用工具。更多細節與源碼，請訪問項目主頁。