文档中心

AgentKit

请输入

智能体身份管理

新建 Agent 身份

本文主要介绍新建 Agent 身份（WorkloadIdentity）的操作步骤、详细的参数配置等。

适用场景

一般情况下，您不需要手动新建 Agent 身份。在 AgentKit 上每创建一个 Agent，系统会自动在默认身份池里注册一个 Agent 身份，Agent 删除时 Agent 身份一并清理。本模块主要用于查看、排障和做 Agent 身份高级集成。

Agent 身份主要能力如下：

操作步骤

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

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

方式二：控制台手动创建

验证结果

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

最近更新时间：2026.10.12 17:21:17

这个页面对您有帮助吗？

有用

无用

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