DSH adopts a plugin-based architecture. In scenarios that require connecting to the Tencent IMA Copilot knowledge base, invoking external services directly or running resident processes adds operational complexity. dsh-ima-copilot is a native plugin. It encapsulates IMA’s knowledge base Q&A capability as the ima_ask tool, allowing the Agent to retrieve answers directly through semantic search.

Plugin Positioning

This is a community plugin maintained by onclaw-dev and categorized as an online tool. It belongs to the DeepSeek Harness ecosystem and has no affiliation with or endorsement from Tencent IMA or the official DeepSeek teams.

Core Features

  • Native Tool Integration: Uses the native ima_ask tool to query one or more IMA knowledge bases.
  • Reference Information Return: Returns the answer body along with reference information such as document IDs, titles, and knowledge base names.
  • Web Configuration Management: Maintains authentication information and knowledge base IDs through the Web settings page. Updates take effect without restarting DSH.
  • Request Control: Provides timeout, concurrency limits, transient failure retries, and request cancellation handling.
  • Secure Credential Handling: Credentials are read and written only through the DSH Credentials API and are not displayed back on the Web page.

Installation and Enablement

Run the following commands in a terminal to install the plugin and start the Web profile:

dsh plugin --profile web add dsh-ima-copilot
dsh web

After installation, restart the Web profile. You can confirm that the plugin has been loaded using the following command:

dsh --profile web --dump-config

Typical Usage

After installation and configuration, the Agent can call the ima_ask tool directly.

Parameters

Parameter Required Description
question Yes A non-empty question to ask the IMA knowledge base
knowledgeBaseId No The target knowledge base ID. If a single knowledge base is configured, the plugin selects it automatically; if multiple knowledge bases are configured, the corresponding ID must be provided

Response

The response includes the answer body and a list of referenced documents:

{
  "answer": "回答正文",
  "references": [
    {
      "id": "资料 ID",
      "title": "资料标题",
      "knowledgeBase": "知识库名称"
    }
  ]
}

Notes

  • API Stability: The IMA Web API is not a publicly stable API. If upstream fields, authentication, or response formats change, the plugin may need to be updated accordingly.
  • Credential Validation: Online validation of real credentials is not performed.
  • No Conversation History: Each call reads the latest credentials, creates a one-time IMA session, and releases resources after completion. Therefore, no cross-call conversation history is retained.
  • Default Policy: The default request timeout is 300 seconds, transient failures are retried up to 3 times, and the concurrency limit is 1.
  • Compliance: Users are responsible for ensuring that the use of accounts, knowledge base content, and authentication information complies with the relevant service terms.

Summary

Through dsh-ima-copilot, the DSH Agent can directly leverage IMA’s knowledge base capabilities without introducing additional dependencies or running child processes. The project is hosted on GitHub, where you can view the version compatibility matrix and source code.