操作场景
AI Agent 在企业内部快速落地后，Agent 服务地址散落各处、消费方硬编码调用、元数据无标准存储，导致服务发现困难且无法复用已有微服务治理能力。
通过北极星注册中心的 Agent 管理能力，您可以将遵循 A2A 协议的 Agent 服务以命名空间为隔离单元统一注册，标准化存储 AgentCard 元数据。
名词定义
名词 | 定义 |
Agent | 遵循 A2A 协议的智能体服务，对外暴露 AgentCard 与任务接口 |
AgentCard | A2A 协议标准元数据，包含服务名称、版本、URL、能力声明、Skill 列表等 |
A2A | Agent-to-Agent 协议，定义 Agent 间通信的标准格式 |
Skill | 北极星 Skill 管理模块中已注册的原子能力单元，可挂载到 Agent |
服务实例 | Agent 服务的单个运行节点，含 IP:Port、健康状态、权重等属性 |
命名空间 | 北极星租户隔离单元，Agent 注册在指定命名空间下 |
前提条件
已创建北极星实例，且实例版本支持 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"}}
步骤8：编辑与删除 Agent（可选）
编辑 Agent
1. 在 Agent 列表中，单击目标 Agent 右侧操作列的编辑，打开编辑 Agent 弹窗。
2. 修改需要变更的字段。命名空间与 Agent 名称字段置灰，不可修改。
3. 单击提交，保存修改。
删除 Agent
1. 在 Agent 列表中，单击目标 Agent 右侧操作列的删除。
2. 在弹出的二次确认对话框中，确认无误后，单击删除，即可完成删除。
参数说明
Agent 基本信息
字段名 | 说明 | 约束 |
Agent 名称 | Agent 的显示名称 | 不超过 64 字符，命名空间内唯一，创建后不可修改 |
命名空间 | Agent 所属的命名空间 | 租户隔离单元 |
Agent ID | 系统生成的唯一标识 | 格式为 随机字符串 |
Agent URL | Agent 服务的完整 URL | 同一命名空间内不校验唯一性，允许灰度多实例使用同一 URL |
A2A 协议版本 | Agent 遵循的 A2A 协议版本 | 默认 1.0 |
版本 | Agent 版本号 | 遵循 SemVer 格式 |
支持能力 | Agent 的能力声明 | 含流式响应、推送通知等 |
描述 | Agent 的描述信息 | 不超过 512 字符 |
创建时间 / 修改时间 | 创建与最近修改的时间 | 系统记录 |
Agent 服务实例
字段名 | 说明 | 取值 |
实例 IP | 服务节点 IP | — |
端口 | 监听端口 | — |
权重 | 路由权重 | [0，100] |
协议 | 实例通信协议 | HTTP / HTTPS |
版本 | 实例版本号 | — |
健康状态 | 实例健康检查结果 | 健康 / 异常 |
隔离状态 | 是否被手动隔离 | 已隔离 / 未隔离 |
地域/可用区/机房 | 实例的部署位置 | — |
创建时间 / 修改时间 | 时间戳 | — |
操作 | 行内操作 | 编辑 / 删除 |
Skill 挂载列表
字段名 | 说明 |
Skill 名称/ID | 已挂载 Skill 的名称与标识 |
版本 | Skill 的版本 |
Tags | Skill 的分类标签 |
inputModes | Skill 支持的输入模式 |
outputModes | Skill 支持的输出模式 |
状态 | 在线 / 已离线 / 已删除 |
操作 | 解挂 |
监控增强
在可观测性 > 注册配置监控 > 注册中心指标（命名空间）页面的服务类型筛选下拉选中新增 Agent 服务选项，选中后各项指标按 Agent 服务维度过滤：
指标名称 | 说明 |
总服务数（个） | 命名空间下 Agent 服务总数 |
正常服务数（个） | 健康实例数 ≥ 1 的 Agent 服务数 |
离线服务数（个） | 健康实例数为 0 的 Agent 服务数 |
异常服务数（个） | 存在异常实例的 Agent 服务数 |
总服务实例数（个） | 所有 Agent 服务实例总数 |
健康服务实例数（个） | 健康状态的实例数 |
异常服务实例数（个） | 异常状态的实例数 |
隔离服务实例数（个） | 被手动隔离的实例数 |
异常服务实例比例（%） | 异常实例数 / 总实例数 |
