文档中心

AgentKit

技能

在线测试技能

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

支持以单个技能为维度进行调试，或以技能空间为维度测试空间内所有技能的组合调用效果。

为什么进行在线测试

在线测试提供运行态验证能力，帮助开发者重点确认以下问题：

加载与调用验证：确认技能或技能空间是否可被正常加载与调用。

任务稳定性验证：验证在指定模型与环境配置下，是否能够稳定完成典型任务。

路由能力验证：在多技能场景下，确认系统是否能够正确选择并调用合适的能力。

全链路验证：核验附件上传、文件生成、文件修改和结果下载链路是否符合预期。

使用场景

验证单个技能的可用性

快速确认该技能是否能够正常理解输入、进入预期执行路径并返回有效结果。

验证技能空间的协同效果

当业务场景需依赖多个技能协同完成时，可通过在线测试验证技能组合是否完整、协同是否合理，以及系统是否能够围绕用户目标完成端到端任务。

开展典型案例走查

上线前可使用典型问题模拟真实用户输入，检查关键路径是否稳定，并提前发现提示词设计不清、输入边界不明确或输出结构不稳定等问题。

验证附件、文件处理与生成结果

如果技能涉及图片理解、文件读取、文件生成或文件修改，可通过在线测试验证附件上传、任务执行与文件下载的完整链路。

执行问题复现与回归测试

当问题修复后，可通过新对话重新执行相同用例，验证修复是否生效，并确认最新版本是否引入新的副作用。

使用限制

在线测试功能仅面向自定义创建的技能（包含从平台预置技能克隆生成的技能）开放。平台原生预置技能属于系统内置能力，不支持使用在线测试功能。

前提条件

已准备测试对象

以单个技能为维度测试：已完成目标技能创建，且其状态为可用，详情参见手动创建技能或通过 Vibe 创建技能。

以单个技能空间维度测试：已完成目标技能空间创建及相关技能创建，且该空间内至少包含一个技能。若创建技能时未将其加入空间，可参见添加/移除技能‌ 完成添加。

已完成方舟 API Key 创建

API Key 为访问模型服务的鉴权凭证，用于支撑技能与智能体的任务运行，首次使用在线测试功能前，需完成方舟 API Key 的创建，详情请参见管理 API Key。

已准备 MCP 服务（可选）

若需要调用 MCP 服务来获取外部工具或系统能力，请提前准备可用的 MCP 服务。如暂无可用 MCP 服务，请进入 MCP 服务页面完成 MCP 服务创建。

对单个技能发起在线测试

针对指定技能发起独立测试，快速验证能力实现、输入约束和输出结构是否满足预期。

步骤一：进入目标技能在线测试页面

在左侧导航树，选择“技能”。

单击目标技能名称，并在页面右上角，单击“在线测试”按钮，进入在线测试页面。

步骤二：配置模型与运行参数（可选）

当需要切换模型、调整 API Key、调用外部 MCP 服务，或为技能配置敏感凭证、服务地址、功能开关等运行参数时，可进行本步设置，否则跳过本步骤。

配置模型

系统会默认选中一个模型，您可按需更换模型，适配不同的推理能力需求。

可根据任务复杂度、响应速度、输出风格等业务诉求选择合适模型，模型和选型推荐请参见模型广场。

说明

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

单击当前模型下拉列表。

选择目标模型即可完成切换。

配置运行参数

系统默认已选中一个 API Key。若需要更换 API Key，或是技能运行依赖其他模型凭证、外部工具及自定义运行参数，进行如下操作。

单击图标，参考下表配置相关运行参数。

参数	说明
API Key	系统默认已选择一个 API Key。单击 API Key 下拉列表按需切换为其他可用的火山方舟 API Key。 API Key 是访问火山方舟模型服务的鉴权凭证，切换后技能将使用所选凭证发起模型请求。
MCP 服务	单击 MCP 服务下拉列表，选择用于提供外部工具或系统能力的 MCP 服务。如暂无可用 MCP 服务，请进入 MCP 服务页面完成 MCP 服务创建。
环境变量	根据控制台界面提示的变量输入要求，输入变量名和变量值，配置技能运行时依赖的参数，例如访问凭证、服务地址或功能开关。将敏感信息通过环境变量外置管理，可减少在技能文件中硬编码导致的信息泄露风险。注意变量名称需与技能代码中读取的名称保持一致。