通过在线测试可以直接验证技能或技能空间的实际运行效果。支持通过自然语言多轮对话或上传文件的方式发起调试，用于核验任务配置是否正常生效，整体设置是否符合业务诉求。支持以单个技能为维度进行调试，或以技能空间为维度测试空间内所有技能的组合调用效果。

注意

在线测试技能的功能正在邀测中。如需体验，请联系客户经理申请。

## 为什么进行在线测试在线测试提供运行态验证能力，帮助开发者重点确认以下问题： * **加载与调用验证**：确认技能或技能空间是否可被正常加载与调用。 * **任务稳定性验证**：验证在指定模型与环境配置下，是否能够稳定完成典型任务。 * **路由能力验证**：在多技能场景下，确认系统是否能够正确选择并调用合适的能力。 * **全链路验证**：核验附件上传、文件生成、文件修改和结果下载链路是否符合预期。 ## 使用场景 * **验证单个技能的可用性** 快速确认该技能是否能够正常理解输入、进入预期执行路径并返回有效结果。 * **验证技能空间的协同效果** 当业务场景需依赖多个技能协同完成时，可通过在线测试验证技能组合是否完整、协同是否合理，以及系统是否能够围绕用户目标完成端到端任务。 * **开展典型案例走查** 上线前可使用典型问题模拟真实用户输入，检查关键路径是否稳定，并提前发现提示词设计不清、输入边界不明确或输出结构不稳定等问题。 * **验证附件、文件处理与生成结果** 如果技能涉及图片理解、文件读取、文件生成或文件修改，可通过在线测试验证附件上传、任务执行与文件下载的完整链路。 * **执行问题复现与回归测试** 当问题修复后，可通过新对话重新执行相同用例，验证修复是否生效，并确认最新版本是否引入新的副作用。 ## 使用限制在线测试功能仅面向**自定义创建的技能**（包含从平台预置技能克隆生成的技能）开放。平台原生预置技能属于系统内置能力，不支持使用在线测试功能。 ## 前提条件 * **已准备测试对象** * **以单个技能为维度测试**：已完成目标技能创建，且其状态为**可用，** 详情参见 [手动创建技能](https://www.volcengine.com/docs/86681/2137204) 或 [通过 Vibe 创建技能](https://docs.volcengine.com/docs/agentkit/EditSkillsFile?lang=zh)。 * **以单个技能空间维度测试**：已完成目标 [技能空间创建](https://docs.volcengine.com/docs/agentkit/Skills_space?lang=zh) 及相关技能创建，且该空间内至少包含一个技能。若创建技能时未将其加入空间，可参见 [添加/移除技能](https://docs.volcengine.com/docs/agentkit/Adding_and_Removing_Skills?lang=zh)‌ 完成添加。 * **已完成方舟 API Key 创建** API Key 为访问模型服务的鉴权凭证，用于支撑技能与智能体的任务运行，首次使用在线测试功能前，需完成方舟 API Key 的创建，详情请参见 [管理 API Key](https://docs.volcengine.com/docs/ark/manage-api-keys?lang=zh)。 * **已准备 MCP 服务（可选）** 若需要调用 MCP 服务来获取外部工具或系统能力，请提前准备可用的 MCP 服务。如暂无可用 MCP 服务，请进入 MCP 服务页面完成 [MCP 服务创建](https://docs.volcengine.com/docs/agentkit/MCP_services?lang=zh)。 ## 对单个技能发起在线测试针对指定技能发起独立测试，快速验证能力实现、输入约束和输出结构是否满足预期。 ### 步骤一：进入目标技能在线测试页面 1. 登录 [AgentKit 控制台](https://console.volcengine.com/agentkit)。 2. 在左侧导航树，选择“技能”。 3. 单击目标技能名称，并在页面右上角，单击“在线测试”按钮，进入在线测试页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e347a64499fc8803821164262a0d0596.png) ### 步骤二：配置**模型与运行参数（可选）** 当需要**切换模型**、**调整 API Key**、调用外部 **MCP 服务**，或为技能配置敏感凭证、服务地址、功能开关等运行参数时，可进行本步设置，否则跳过本步骤。 * **配置模型** 系统会默认选中一个模型，您可按需更换模型，适配不同的推理能力需求。 > 可根据任务复杂度、响应速度、输出风格等业务诉求选择合适模型，模型和选型推荐请参见 [模型广场](https://console.volcengine.com/ark/region:ark+cn-beijing/model?groupType=ModelGroups&vendor=Bytedance&view=DEFAULT_VIEW)。

说明

模型将按 Token 用量计费，费用详情请参见模型服务计费说明。

1. 单击当前模型下拉列表。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0720dc478358060a2a5e127832729a27.png) 2. 选择目标模型即可完成切换。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_22f2d003cf042f3900c72acbb69bfac3.png) * **配置运行参数** 系统默认已选中一个 API Key。若需要更换 API Key，或是技能运行依赖其他模型凭证、外部工具及自定义运行参数，进行如下操作。 1. 单击![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c71d8a611394d73a1203b020ff14165e.png) 图标，参考下表配置相关运行参数。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_04a33c65fa033ca1a484af84e4337685.png) |**参数** |**说明** | |---|---| |API Key |系统默认已选择一个 API Key。单击 **API Key 下拉列表**按需切换为其他可用的火山方舟 API Key。

> API Key 是访问火山方舟模型服务的鉴权凭证，切换后技能将使用所选凭证发起模型请求。 | |MCP 服务 |单击 **MCP 服务下拉列表**，选择用于提供外部工具或系统能力的 MCP 服务。如暂无可用 MCP 服务，请进入 MCP 服务页面完成 [MCP 服务创建](https://docs.volcengine.com/docs/agentkit/MCP_services?lang=zh)。 | |环境变量 |根据控制台界面提示的变量输入要求，输入**变量名**和**变量值**，配置技能运行时依赖的参数，例如访问凭证、服务地址或功能开关。

> 将敏感信息通过环境变量外置管理，可减少在技能文件中硬编码导致的信息泄露风险。

注意

变量名称需与技能代码中读取的名称保持一致。

| 2. 单击“保存”按钮，完成操作。 ### 步骤三：发起在线测试 1. 选择以下任一方式发起调试： * **通过快捷提示词（推荐）** ：系统默认按照场景化预置对应测试提示词，**选中即可快速发起调试**，验证技能的实际运行效果，您可结合调试场景按需选用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a903ef6c8f781b8fa5d7862ec2324323.png) * **自定义描述需求**：在对话框中输入待调试的指令，发送消息后即可启动调试，支持输入任意业务指令开展灵活测试。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_adeeb1aa0838f4167462ac6ca9b9efc4.png)

说明

上传附件（可选）：如需补充业务背景或处理依据，可单击输入框下方的

图标，上传文档、图片等参考材料。待上传的参考文件需符合以下要求：

文件类型：当前仅支持 .doc、.docx、.ppt、.pptx、.pdf、.xlsx、.txt 文件类型。

文件大小：单个文件大小不超过 5 MB。

2. 查看任务执行过程与返回结果，核对输出内容、返回格式、业务逻辑等，判断是否符合业务预期。

注意

测试结果仅临时保存。若退出当前页面或新建对话，原有测试结果将无法再次查看。

* **结果符合预期**：技能可正常返回内容，输出结果、格式、业务逻辑均满足业务要求，可进行 [发布操作](https://docs.volcengine.com/docs/agentkit/Publishing_Skills?lang=zh)。 * **需要补充信息**：若系统识别到需求描述不明确，或缺少关键业务规则、配置参数和场景信息，将提示补充相关内容。根据页面指引选择或输入缺失信息后，系统将继续执行技能测试。可重复补充和调整，直至测试结果符合预期。 3. **新建对话（可选）** 如当前对话的生成结果不符合预期、需要放弃当前上下文并重新发起在线测试，请单击 **+ 新对话**按钮，开启独立会话。新建会话后，可参考上述操作重新进行在线测试。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6f181fda98ab2dead41a30aa803f32cc.png)

说明

测试结果仅临时保存，若新建对话，原有测试结果将无法再次查看。

## 对技能空间发起在线测试以技能**空间**为维度发起在线测试时，系统将基于空间内的全部技能执行任务，用于验证技能路由、协同执行及端到端任务完成效果。与单个技能测试不同，空间维度测试重点检查系统能否根据任务需求选择合适的技能，并完成多技能组合调用。

注意

仅当技能空间内已添加技能时，才可按空间维度执行在线测试。若当前空间内不存在技能，需添加技能后再进行在线测试。

1. 登录 [AgentKit 控制台](https://console.volcengine.com/agentkit)。 2. 在左侧导航树，选择“技能”。 3. 单击“技能空间”页签。 4. 在目标空间“操作”列，单击“在线测试”按钮，进入在线测试页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e32fb7a3494f533931088acce914bdde.png) 5. 按需配置模型和运行参数，查看任务执行过程和返回结果，确认技能路由、调用顺序、协同执行及最终输出是否符合预期。空间维度在线测试与单个技能在线测试基本一致，详情请参见 [对单个技能发起在线测试](https://docs.volcengine.com/docs/86681/2696509#x1EDbBAV)。