注册配置治理 Agent 管理

一、操作场景

通过北极星注册中心的 Agent 管理能力，你可以将遵循 A2A 协议的 Agent 服务以命名空间为隔离单元统一注册，标准化存储 AgentCard 元数据。

二、名词定义

三、前提条件

·已创建北极星实例，且实例版本支持 AI Registry 能力。

·已创建用于注册 Agent 的命名空间。

·已部署遵循 A2A 协议的 Agent 服务，并可提供服务的完整访问 URL。

五、步骤1：进入 Agent 管理页面

1. 登录 TSF 控制台，进入 Polaris（北极星）实例页面。

2. 单击目标实例名称，进入实例管理页面。

3. 在左侧导航栏，单击 AI 注册中心 > Agent 管理，进入 Agent 列表页面。

六、步骤2：新建 Agent

1. 在 Agent 列表页面，单击新建，进入新建 Agent 弹窗。

2. 在新建 Agent 弹窗中，根据页面提示，按需填写 Agent 的基本信息。

3. 单击提交，完成 Agent 注册。

七、步骤3：查看 Agent 基本信息

1. 在 Agent 列表中，单击目标 Agent 名称，进入 Agent 详情页。

2. 在详情页顶部的基本信息模块可以查看以下内容：Agent 名称、命名空间、支持能力、A2A 协议版本、创建时间、描述、服务 ID、Agent URL、修改时间。

八、步骤4：管理 Agent 服务实例

Agent 详情页默认展示 Agent 服务实例页签。

九、新建服务实例

1. 在 Agent 服务实例页签，单击工具栏左侧的新建。

2. 在弹出的窗口中，根据页面提示按需填写实例 IP、端口、权重、协议、版本等信息。

3. 单击提交，完成实例注册。

十、筛选服务实例（可选）

1. 单击工具栏右侧的搜索框。

2. 在右侧搜索框选择过滤属性，可选项包括：实例 IP、协议、版本、健康状态、隔离状态、标签键。

3. 输入过滤条件，列表实时刷新。

十一、其他操作（可选）

·选中实例后，单击 删除 可移除实例。

·单击 ⟳ 图标可刷新列表。

·实例行内的 操作 列提供 编辑 与 删除。

十二、步骤5：挂载与管理 Skill

1. 在 Agent 列表中，单击目标 Agent 名称，进入 Agent 详情页。

2. 在 Agent 详情页，单击 Skill 挂载页签，查看已挂载的 Skill 列表。

3. 单击挂载 Skill，打开挂载 Skill 窗口。

4. 在挂载 Skill 窗口中，从我的 Skill （在线）或 SkillHub 分组中选择需挂载的 Skill。

5. 确认选择后，单击提交完成挂载。

6. （可选）如需解除挂载，在 Skill 列表的操作列单击解挂。

注意：只能挂载当前用户创建的在线 Skill，或 SkillHub 中的公共 Skill。Skill 下线后系统不会强制解挂，但会在列表中标注异常状态。

十三、步骤6：配置权限管理

1. 在 Agent 列表中，单击目标 Agent 名称，进入 Agent 详情页，单击权限管理页签。

2. 在用户模块可以查看已授权用户列表，主账号会标注主账号。如需调整，可以单击右上角的编辑，按需授权用户。

3. 在用户组模块可以查看已授权用户组，如需调整，可以单击右上角的编辑，按需授权用户组。无数据时该区块展示暂无用户组。

注意：说明：

注意：授予权限的用户或用户组具有该服务的读写权限，所有用户具有读权限。

十四、步骤7：查看 AgentCard

1. 在 Agent 列表中，单击目标 Agent 右侧操作列的 AgentCard，在 AgentCard 弹窗中可以查看 A2A 标准的 AgentCard JSON 内容。

2. 如需复制，单击复制即可。

AgentCard 包含以下结构（仅供参考）：

{ "name": "test", "description": "", "url": "https://research-agentexample.com/a2a", "version": "1.0.0", "capabilities": { "streaming": true }, "defaultInputModes": [ "text/plain" ], "defaultOutputModes": [ "text/plain" ], "skills": [], "metadata": { "namespace": "Polaris", "agent-url": "https://research-agentexample.com/a2a" }}

十六、编辑 Agent

1. 在 Agent 列表中，单击目标 Agent 右侧操作列的编辑，打开编辑 Agent 弹窗。

2. 修改需要变更的字段。命名空间与 Agent 名称字段置灰，不可修改。

3. 单击提交，保存修改。

十七、删除 Agent

1. 在 Agent 列表中，单击目标 Agent 右侧操作列的删除。

2. 在弹出的二次确认对话框中，确认无误后，单击删除，即可完成删除。

十九、Agent 基本信息

20、Agent 服务实例

21、Skill 挂载列表

22、监控增强

在可观测性 > 注册配置监控 > 注册中心指标（命名空间）页面的服务类型筛选下拉选中新增 Agent 服务选项，选中后各项指标按 Agent 服务维度过滤：