AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit用户指南身份与权限用户指南智能体身份管理智能体身份管理概述
复制全文
下载 pdf智能体身份管理概述
文档反馈
问问助手本文主要介绍 AgentKit 智能体身份管理的核心能力及可解决的问题，帮助您理解智能体身份池（WorkloadPool）和 Agent 身份（WorkloadIdentity）是什么、Agent 身份如何和凭据/策略/IAM 角色联动。
说明
本文适用对象：已开通 AgentKit、需要在生产环境运行 Agent 的管理员和平台集成工程师。
它解决什么问题
用户管理里管的是人/工具从哪登录 Agent，智能体身份管理管的是"Agent 本身"——Agent 在后台调用 MCP 工具、访问火山云资源、代表用户执行任务时，用什么身份自证、 执行哪些权限策略。
与给每个 Agent 配置长期 API Key 不同，AgentKit 智能体身份管理模块采用工作负载身份（WorkloadIdentity）模型，每个 Agent 在一个身份池里有一个稳定身份，运行时由身份池签发短时 Token，权限由访问策略控制，全程不落长期密钥。
三层概念
层级 | 是什么 | 生命周期 | 类比 |
智能体身份池 WorkloadPool | 令牌签发边界、JWKS / Issuer 边界，持签名密钥对，管理一组 Agent 身份。 | 长期，组织级。 | 类似一个"内部 IdP 项目"。 |
Agent 身份（WorkloadIdentity） | 和一个 Agent 资产 1:1 绑定的稳定授权身份，是 Cedar 策略里的 Principal。 | 长期，随 Agent 资产生命周期，自动生成的 WorkloadIdentity 在 Agent 删除后会被关联删除。 | 类似 Agent 的"工号"。 |
运行时临时身份 WorkloadIdentity | 每次会话 / 智能体运行时拿到的短期 Token（WIT / TIP）。 | 短期，随会话结束。 | 类似"临时门禁卡"。 |
注意事项与最佳实践
- 若默认池够用，则不建议建新池：智能体身份池池是企业级粗粒度边界，不是按 Agent、按业务线随便开。
- 不要为 Agent 添加长期 AK/SK：用身份池 + 短时 Token + 访问规则替代，密钥不落代码。
- 请勿外发 TRN：TRN 是资源定位符，请合理用到策略等场景，勿通过会话窗口、文件等方式外发。
- 请勿修改 OIDC 发现端点 URL：修改 OIDC 发现端点 URL 会让所有信任它的 IAM 角色 / 网关验签失败。
- 删 Agent 前确认身份列表：确认该 Agent 对应的 WorkloadIdentity 是否被其他的策略 / 凭据引用。
- 确认身份池类别：列表中“Tool”类身份是被注册的工具自己的身份，不是您的业务 Agent，配策略时注意 Principal 的选择。
最近更新时间：2026.10.12 17:21:17
这个页面对您有帮助吗？
有用
有用
无用
无用