技能安全扫描
技能安全扫描用于在 Skill 使用、签名或交付前,对 Skill 包进行风险检测,帮助识别异常文件、风险依赖或不合规内容。本文介绍如何在 VeriAgent 中上传 Skill 技能包并创建安全扫描任务,完成后你可以查看扫描进度、扫描报告和风险结论,为后续技能签名提供依据。
安全扫描完成后,可继续进入技能签名流程。
前置条件
开始前,请确认你已满足以下条件:
- 已拥有 VeriAgent 平台账号。
- 已具备 Skill 管理相关操作权限。
- 已准备好需要扫描的 Skill 技能压缩包。
- 已确认 Skill 的基础信息,例如技能名称、版本号、分类和说明。
注意:请上传需要进行安全扫描的 Skill 包。扫描对象是 Skill 包,不是 Agent。
创建安全扫描任务
若要对 Skill 发起安全扫描,请按照以下步骤操作:
- 登录 VeriAgent 控制台。
- 在左侧导航栏中,选择 技能管理 > 安全扫描。
- 进入 上传技能包 页面后,填写或上传以下信息:
| 字段 | 说明 | 示例 |
|---|---|---|
| 技能名称 | 当前 Skill 的名称,用于在任务列表、报告和后续签名流程中识别该 Skill。 | 文档生成助手 |
| 版本号 | 当前 Skill 包的版本信息。建议与实际发布版本保持一致。 | 1.0.0 |
| 分类 | 当前 Skill 所属类型,便于后续筛选和管理。 | 办公效率 |
| 技能压缩包 | 需要进行安全扫描的 Skill 包文件。 | skill-package.zip |
| 说明 | Skill 的补充说明,可填写主要功能、对外依赖、运行说明等信息。 | 用于根据输入内容生成结构化文档。 |
说明:说明 字段可用于补充 Skill 的主要功能、对外依赖和运行说明,便于后续识别、复核和管理。
- 确认信息无误后,单击 创建扫描任务。
- 返回扫描任务列表,查看当前任务的状态和处理进度。
查看扫描报告
扫描完成后,你可以进入扫描报告页面查看检测结果、风险结论和报告摘要。
- 在 技能管理 > 安全扫描 的任务列表中,找到目标 Skill。
- 打开对应任务,进入 扫描报告 页面。
- 查看页面顶部的核心结果,包括:
- 报告编号
- 任务 ID
- 生成时间
- 等级
- 综合评分
- 在扫描进度区域查看当前处理结果和完成情况。
- 在报告详情区域查看本次扫描的主要内容,包括:
- Skill 基本信息
- 综合结论
- 意图分析
- 如需留存扫描结果,可在页面中执行以下操作:
- 下载扫描报告
- 下载技能包
- 返回列表
注意:如扫描结果存在风险,请先根据报告内容完成确认或修复,再进入后续技能签名流程。
验证结果
完成操作后,你可以通过以下方式确认安全扫描任务是否创建或完成:
- 返回 VeriAgent 控制台。
- 进入 技能管理 > 安全扫描。
- 在任务列表中查看目标 Skill 是否已生成扫描任务。
- 当任务状态为 已完成 时,打开扫描报告,确认可以查看报告编号、任务 ID、生成时间、等级、综合评分及报告详情。
| 状态 | 说明 |
|---|---|
| 待处理 | 扫描任务已创建,等待系统处理。 |
| 进行中 | 系统正在处理该 Skill 包,请等待扫描完成。 |
| 已完成 | 系统已生成扫描结果,可查看或下载扫描报告。 |
| 失败 | 当前任务未正常完成,请根据页面提示检查 Skill 包或重新发起扫描。 |
下一步
安全扫描完成且结果符合要求后,你可以继续执行技能签名操作。技能签名完成后,系统会生成对应的签名记录和证书信息,便于后续验签、上架和追溯。