> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veadk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 Harness

harness 路径适合无需自定义代码的场景：智能体的模型、工具、知识库、记忆与提示词全部写在一个 `harness.yaml` 里，由 CLI 直接构建并部署为运行时。整个闭环只围绕一个文件展开——初始化、配置、部署、调用，再回到配置持续迭代。

> [!NOTE]
>
> 开始前请先配置凭证。`harness deploy` 属于控制面操作，需要 AK/SK；[SSO 登录](https://docs.veadk.xyz/productions/agentkit-cli/archives/0.50.8/zh/commands/auth.md)目前仅用于调用（`invoke`）已部署的运行时。凭证配置见[快速开始](https://docs.veadk.xyz/productions/agentkit-cli/archives/0.50.8/zh/quickstart.md)的「鉴权」一节。

> [!WARNING]
>
> `harness deploy` 会在云端构建镜像并创建或更新 Runtime，可能产生费用；更新已有 Runtime 还会改变其线上行为。部署前确认项目、地域、配置和凭证引用，并在业务低风险时段发布变更。

**1. 初始化 harness**

创建一个 harness 目录，其中包含 `harness.yaml` 与 `.env.example`。

```bash lines theme={null}
agentkit harness init my-harness
cd my-harness
```

**2. 配置智能体**

用 `harness set` 逐项写入字段。仅显式传入的标志会被修改，因此可以分多次补充配置。

```bash lines theme={null}
agentkit harness set \
  --name my-harness \
  --model-name doubao-seed-1-6-250615 \
  --system-prompt "你是一个简洁、乐于助人的智能体。" \
  --tools web_search
```

> [!TIP]
>
> 配置知识库、记忆等组件时，先设置其 `--<组件>-type`，再补充连接参数；传入空字符串 `""` 可禁用某个组件。不带任何标志运行 `agentkit harness set` 会列出当前字段。完整字段见[Harness](https://docs.veadk.xyz/productions/agentkit-cli/archives/0.50.8/zh/commands/harness.md)。

**3. 构建并部署**

根据 `harness.yaml` 在云端构建镜像，并创建或更新运行时。

```bash lines theme={null}
agentkit harness deploy --project default --region cn-beijing
```

**4. 调用运行时**

按名称调用刚部署的运行时，CLI 会自动解析端点与鉴权。调用属于数据面操作，两种凭证均可使用：AK/SK，或先经 `agentkit login` 完成 SSO 登录后得到的 STS 凭证。

```bash lines theme={null}
agentkit invoke my-harness -m "你好，介绍一下你自己"
```

**5. 迭代**

修改配置后重新部署即可发布新版本；运行时行为异常时，查看实例日志定位问题。

```bash lines theme={null}
agentkit harness set --name my-harness --system-prompt "更换后的指令。"
agentkit harness deploy
agentkit runtime logs my-harness --limit 200
```

不再需要该运行时时，将其删除以释放资源：

> [!WARNING]
>
> 删除 Runtime 不可恢复，并会停止线上调用。执行前确认名称、项目和地域，保留需要的配置、日志与业务数据。

```bash lines theme={null}
agentkit runtime delete my-harness -y
```

需要自定义逻辑、工具或多智能体编排时，改用[高代码智能体](https://docs.veadk.xyz/productions/agentkit-cli/archives/0.50.8/zh/workflows/high-code)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.