云原生智能网关 Skill 管理

一、功能说明

Skill 是 Agent 的原子能力单元，用于描述“这个 Agent 能做什么”。对外它对应 A2A 协议 AgentCard 中的 AgentSkill 对象（id/name/description/tags/examples），对内是 AI 网关侧一条可复用的能力配置记录。同一个 Skill 可被多个 Agent API 复用，修改一次即可同步生效。

二、名词定义

三、前提条件

·已创建 AI 网关实例，且实例状态为运行中。

·若需将 Skill 挂载到 Agent 并通过 A2A 协议对外暴露，网关数据面版本需 ≥ 3.9.6。

·若使用 ZIP 包方式创建 Skill，需提前准备包含 SKILL.md 的压缩包。

四、创建 Skill

1. 登录 AI 网关控制台。

2. 在左侧导航栏选择实例列表，单击目标 AI 网关实例 ID 进入实例详情页。

3. 单击左侧 Skill 管理后，单击新建 Skill。

4. 在新建 Skill 弹窗中配置基础信息：

5. （可选）在 Skill 文件区域上传 ZIP 包：

6. 单击确定创建，列表中出现新建的 Skill。

五、查看 Skill 详情

1. 在 Skill 管理列表中单击目标 Skill 左侧的详情进入详情页。

2. 详情页包含以下页签：

六、Skill 状态流转

1. 进入“Skill 管理”，选择目标 Skill

2. 支持的状态流转：

七、操作场景二：版本管理与回滚

1. 每次编辑并保存在线 Skill 的名称/标签/示例/描述后，原内容自动归档为“历史版本”，编辑内容成为新的“当前版本”

2. 进入 Skill 详情页“版本历史”，可查看当前版本与历史版本（最多 2 项，当前版本置顶）

3. 单击回滚将当前版本与历史版本互换：历史版本立即成为当前版本并生效，原当前版本转为历史版本，无需额外发布操作

4. 仅存在 1 个版本（无历史版本）时，回滚按钮不可用

注意：说明：

注意：Skill 内容变更后，若该 Skill 已被 Agent API 关联，变更会异步同步至所有关联的 Agent API（约 5 分钟内完成），同步状态可在同步任务记录中查看，失败可手动重试。

八、操作场景三：Agent 关联 Skill

·新建 Agent 服务时支持关联 Skill，Agent 关联 Skill 选择器仅展示“在线”状态的 Skill（不要求已发布至 SkillHub）

·已关联 Skill 状态变化时的提示：

注意：说明：