dsh-maf：Microsoft Agent Framework (MAF) 的 DeepSeek Harness 插件

前言¶

DeepSeek Harness (DSH) 採用了「一切皆插件」的理念。Microsoft Agent Framework (MAF) 是微軟當前的企業級 agent 編排框架（基於 Semantic Kernel，v1.0 已發佈），核心能力在於 YAML 聲明式的 agents 與 workflows。目前 MAF 沒有內置的 DSH 適配。

dsh-maf 插件填補了這一空白，它通過原生 dsh 工具鏈，爲開發者提供了一套工具，用於驗證、運行和搭建 MAF 的 declarative agents 與 workflows。

核心功能¶

插件提供了以下五個核心工具：

maf_status：檢查 MAF 包版本與環境狀態。
maf_validate：校驗 declarative agent YAML 文件（通過 AgentFactory 解析）。
maf_run_agent：運行 declarative agent（基於 YAML 定義和 prompt）。
maf_run_workflow：運行 declarative workflow sample（通過 main.py 執行）。
maf_scaffold：生成 agent 或 workflow 的 YAML 模板。

前置要求¶

在使用前，需要安裝 MAF 相關的 Python 依賴：

pip install agent-framework agent-framework-declarative python-dotenv

Agent YAML 文件中的 model.id 通常引用環境變量（例如 =Env.OPENAI_CHAT_MODEL_ID），運行前需配置好 .env 文件或系統環境變量，填入 provider 密鑰。

安裝與啓用¶

該插件通過 Cordis patch 的方式集成。在 profile 的 cordis.patch.yml 中添加以下配置：

- insert:
    - id: maf
      name: './src/index.js'
      config:
        pythonCmd: python
        enginePath: scripts/maf.py

然後執行安裝命令：

pnpm dsh web --patch ./dsh-maf/cordis.patch.yml

配置項¶

在 cordis.patch.yml 的 config 節點下，可調整以下參數：

pythonCmd：Python 解釋器路徑，默認爲 python。
enginePath：引擎腳本路徑，默認爲 scripts/maf.py。
timeoutMs：單次調用超時時間（毫秒），默認爲 180000（3 分鐘）。

典型用法¶

安裝完成後，可以在 DSH 中直接調用工具。例如，檢查環境並校驗 YAML 文件：

maf_status
maf_validate ./agents/Assistant.yaml

已知限制¶

maf_run_agent 和 maf_run_workflow 會消耗配置的 provider API 額度。
declarative agents API 官方標註爲 experimental，接口可能隨版本變動。
輸出原樣返回，包含模型生成的內容。

結語¶

dsh-maf 讓開發者能夠利用 DSH 的工作流能力，直接管理 MAF 的聲明式定義。該插件由 WODE25500 維護，採用 MIT 許可證。