文档中心

AgentKit

请输入

智能体身份管理

新建 Agent 身份

Agent 身份（AEI）是 Agent 资产的稳定授权身份，与 Agent 资产一一对应绑定，是 Agent 后台出站调用时申请权限的唯一主体。本文介绍手动新建 Agent 身份的操作步骤与参数配置，以及身份池的管理操作。

适用场景

一般情况下，您不需要手动新建 Agent 身份。在 AgentKit 上每创建一个 Agent，系统会自动在默认身份池（名称为 default，描述为 default pool）里注册一个 Agent 身份，Agent 删除时 Agent 身份一并清理。本文主要适用于查看/排障已有 Agent 身份和由外部平台通过 API 显式注册 Agent 身份的场景。

Agent 身份主要能力如下：

为智能体、应用或服务创建独立身份。

查询和维护工作负载身份信息。

在工作负载停用后清理对应身份。

作为访问令牌中工作负载身份信息的主体。

操作步骤

AgentKit 有如下两种创建 Agent 身份的方法。

方式一：创建 Agent 时自动注册（推荐）

方式二：控制台手动创建

在 AgentKit 控制台创建并发布一个 Agent。了解更多

系统在默认身份池（default）下自动注册对应的 WorkloadIdentity，无需额外操作。

Agent 发布时，引用工具的授权会翻译为 WorkloadIdentity 的权限策略，重复发布不重复建身份，换版本不换 WorkloadIdentity。

验证结果

在身份池详情页的“Agent 身份”区域列表中可以看到新身份，类别（Agent / Tool），创建来源、TRN 等。TRN 可作为 Cedar 策略里的 Principal 使用。

最近更新时间：2026.10.26 17:42:29

这个页面对您有帮助吗？

有用

无用

参数	说明
身份名称	根据界面提示的命名规则，自定义设置 Agent 身份名称。名称须账户内唯一，在集成链路中与 Agent 资产一一对应。
身份类型	智能体身份类型： Agent：业务智能体，在系统里是“请求发起方 / 调用方”。 Tool：被注册的工具身份，在系统里是“被调用方 / 资源提供方”。
OAuth2 回调地址	单击“添加回调地址”按钮，添加用于资源 OAuth2 授权完成后的回调地址。当该 Agent 身份需要访问受 OAuth2 保护的外部资源（比如调用某个第三方服务、需要用户登录授权的 API）时，用户授权后，授权服务器会将浏览器重定向回此处填写的 URL 地址，并在该地址上带上授权码（authorization code）。Agent 再用这个授权码去换 access_token，闭环整个 OAuth 授权流程。注意该回调地址必须和您在授权服务器（IdP / 第三方应用后台）里登记的回调地址完全一致（协议、域名、端口、路径都要对得上），否则授权服务器会直接报错拒绝。可以添加多个回调地址，用于区分开发 / 测试 / 生产环境，或多个前端入口。
元数据	单击“添加元数据”按钮，给该 Agent 身份附加的自定义键值对标签 / 属性。一个键存在多个值时，请使用英文逗号（,）分隔，例如env=prod,test。