前言¶
DeepSeek Harness (DSH) 採用插件化架構,通過插件擴展智能體的工具集。當智能體需要調用業務系統的 API 時,通常需要編寫額外的調用邏輯。dsh-autocount-cloud 插件爲此提供了一套現成的工具,使 DSH 能夠直接與 AutoCount Cloud 的連接器交互。
插件介紹¶
該插件爲 DSH 添加了四個工具,用於與 AutoCount Cloud API 端點通信。
- 所有者:Mac Soft Sdn Bhd - ricky@macsoft.my
- 許可證:MIT
- 核心能力:調用 AutoCount Cloud 連接器命令。
核心功能¶
插件提供了以下四個工具:
-
autocount_command_schema
讀取 AutoCount Cloud 的單個命令架構。 -
autocount_submit_command
將命令提交到連接器隊列。 -
autocount_get_command
通過命令 ID 讀取命令狀態或結果。 -
autocount_run_command
提交命令並輪詢,直到命令完成、失敗或超時。
安裝與啓用¶
在終端中執行以下命令以安裝插件:
dsh plugin --profile web add github:teckyuen/dsh-autocount-cloud
安裝完成後,重啓 DeepSeek Harness 進程以加載插件。
配置¶
在啓動 DSH 之前,需配置以下環境變量以連接到 AutoCount Cloud:
AUTOCOUNT_CLOUD_URL=https://api.autocount.cloud
AUTOCOUNT_API_KEY=ak_xxx
AUTOCOUNT_CONNECTOR_ID=your-connector-id
AUTOCOUNT_COMPANY_ID=your-company-id
請勿將這些包含 API 密鑰的配置項提交到代碼倉庫。
典型用法¶
在 DSH 中調用工具時,可以傳入 JSON 格式的參數。
示例 1:讀取債務人數據
{
"type": "read-debtors",
"payload": {
"limit": 10
}
}
示例 2:檢查寫入前的 Payload
{
"commandType": "create-cash-sale"
}
安全與注意事項¶
- 該插件僅調用 AutoCount Cloud API 端點。它本身不包含 AutoCount 憑據、客戶數據或直接 SQL 訪問權限。
- 對於寫入命令,最終是否允許保存數據由 AutoCount 連接器和 AutoCount SDK 決定,插件僅負責提交請求。
- 請確保在安裝前檢查插件的源碼與許可證。
總結¶
dsh-autocount-cloud 提供了標準化的方式,讓 DeepSeek Harness 能夠通過 DSH 工具集操作 AutoCount Cloud。通過 autocount_run_command 等工具,開發者可以快速構建涉及會計系統交互的智能體應用。
GitHub 倉庫:https://github.com/teckyuen/dsh-autocount-cloud