前言¶
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