DeepSeek Harness

DeepSeek Harness 是 DeepSeek AI 开发的一套用来构建、运行和扩展智能体的应用框架，采用一切皆插件的架构。本文介绍如何配置方舟 Agent Plan 到 DeepSeek Harness 中使用。

一、前提条件#

您已按需订阅 Agent Plan 套餐。如未，请访问开通管理-Agent Plan 页面订阅套餐。
您已安装 Node.js（建议使用 LTS 版本）。

二、配置 DeepSeek Harness#

您可以按下面任一方式在 DeepSeek Harness 中接入方舟 Agent Plan。自动化助手 通过 ArkCLI Helper 引导完成工具配置；通过 Web UI 手动配置 通过 DeepSeek Harness Web UI 逐项填写；通过 Ark 插件配置 借助方舟官方插件自动完成 provider 添加，只需填入 API Key。

方式 1：自动化助手（推荐）#

ArkCLI Helper 是一个编码工具助手，支持快速配置选择的工具接入 Agent Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。

安装 Ark CLI。

1
2
3
4
5# 1. 通过 NPM 安装
npm install -g @volcengine/ark-cli@latest

# 2. 验证安装
arkcli --version

登录 Ark CLI。
Bash
```
1arkcli auth login
```
根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：
1. 选择项目（Project）：可按需选择，或默认选择账号全部资源。
2. 选择消费模式（Type）：选择 agent-plan。
其中：
- <ARK_API_KEY>：运行 ArkCLI Helper 时填写的 Agent Plan 专属 API Key。
运行 ArkCLI Helper，根据界面提示完成 DeepSeek Harness 的配置。
1. 在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。
  运行过程中会提示填写 Agent Plan 专属 API Key；如需在本地环境变量中管理，可使用 ARK_API_KEY 作为变量名。
2. 选择要配置的 Plan profile：agent-plan_cn-beijing_personal (Agent Plan)。
3. 选择默认 model：按需选择。
4. 选择要配置的 AI Agent：DeepSeek Harness。
  当前支持的 Harness 包括：豆包搜索、专业数据集、Agent 记忆（OpenViking）、AI Native 应用开发底座，根据界面提示按需选择配置或者跳过。

完成上述操作后，将自动完成 DeepSeek Harness 的基础配置，并按选择结果自动安装对应的 Harness 工具，无需手动安装。

方式 2：通过 Web UI 手动配置#

启动 DeepSeek Harness。
1. 在终端执行以下命令启动 DeepSeek Harness 的 Web UI。
  bash
```
1npx @deepseek-ai/dsh web
```
2. 在浏览器打开命令输出的访问地址。默认地址为 http://127.0.0.1:3080/。
在 DeepSeek Harness Web UI 中，单击左下角设置。
在左侧导航栏单击模型，根据界面信息进行配置。
- 方式一：配置 DeepSeek 卡片
  在 DeepSeek 卡片，选择自定义设置，按下面信息填写并保存。
  - API 密钥：填写 Agent Plan 专属 API Key。
  - API 地址：https://ark.cn-beijing.volces.com/api/plan/v3
  - 添加模型：按需添加套餐支持的文本生成模型，模型列表参见支持模型及 Harness。
- 方式二：添加自定义提供方
  单击添加自定义提供方，按下面信息填写完成提供方的创建。
  - Provider ID：自定义设置，后续如需重命名则需要添加新的提供方，并删除旧的提供方。
  - 显式名称：自定义设置。
  - API 地址、API 协议：支持的 API 地址、API 协议及对应关系如下，不要配置错误。

API 协议	API 地址
openai-completions	`https://ark.cn-beijing.volces.com/api/plan/v3`
openai-responses	`https://ark.cn-beijing.volces.com/api/plan/v3`
anthropic-messages	`https://ark.cn-beijing.volces.com/api/plan`

    - **API 密钥**：填写 Agent Plan [专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentPlan)。
    - **添加模型**：按需添加套餐支持的**文本生成模型**，模型列表参见 [支持模型及 Harness](/docs/agent-plan-personal-plan-overview#3d801f5f)。

(可选) 如果需要给模型配置支持图片输入，则需要在配置文件中进行配置。

在模型配置页面，单击打开配置文件，路径$DSH_HOME/settings.yaml。

在支持的模型配置部分加上 input: [text, image]，配置示例如下。

1
2
3
4
5
6
7
8
9
10
11llm-pi-ai:
  providers:
    ark-plan:
      displayName: ark-plan
      apiKeyEnv: ARK_PLAN_API_KEY
      api: openai-responses
      baseURL: https://ark.cn-beijing.volces.com/api/plan/v3
      models:
        - id: doubao-seed-2.1-pro
          name: doubao-seed-2.1-pro
          input: [text, image]

方式 3：通过 Ark 插件配置#

方舟提供以下官方 Ark Plan 和后付费模型插件，自动为 DeepSeek Harness 配置方舟 Agent Plan、Harness(专业数据集、豆包搜索、Agent 记忆等)与后付费模型 provider，安装后可以自动完成 DeepSeek Harness 与方舟服务的对接，免去手动填写 API 地址、API Key 等步骤：

启动 DeepSeek Harness。
1. 在终端执行以下命令启动 DeepSeek Harness 的 Web UI。
  bash
```
1npx @deepseek-ai/dsh web
```
2. 在浏览器打开命令输出的访问地址。默认地址为 http://127.0.0.1:3080/。

在对话框中输入以下 Prompt，让 Agent 帮你完成安装ark-plan-api 插件。

1帮我安装下面的插件：curl -fsSL -o dsh-ark-plugin-install.sh "https://lf3-static.bytednsdoc.com/obj/eden-cn/ylwslo-yrh/ljhwZthlaukjlkulzlp/ark-cli-outer-resource/dsh-ark-plugin-install.sh" && bash dsh-ark-plugin-install.sh --plugin-name ark-plan-api

ark-plan-api 插件安装后会在 设置 > 模型 页面自动添加 Agent Plan、Coding Plan 以及后付费的模型 provider，用户可输入自己的 Agent Plan 专属 API Key。回到对话页，在输入框右下角的模型下拉菜单中选择 Ark Agent Plan 下的模型即可开始使用。