文档中心

AgentKit

请输入

管理凭据

轮换密钥

轮换密钥用于更新 AgentKit 中已托管的 API Key。当原密钥即将过期、疑似泄露或需要按照安全策略定期更新时，可以执行密钥轮换。轮换后，AgentKit 将立即使用新值替换旧值，旧值不会保留，也无法恢复。凭据原有的 Agent 绑定关系不受影响，后续出站调用将使用新的 API Key。

推荐场景

使用限制

不同凭据类型对于密钥轮换能力的支持存在差异：

凭据类型	是否支持更换密钥	说明
API Key	支持	密钥轮换完成后，新 API Key 将立即覆盖替换旧值；该凭据已有的 Agent 绑定关系保持不变，不会受密钥轮换操作影响。
OAuth 连接	部分支持	除提供商类型为用户池的 OAuth 连接外，其余类型提供商均支持轮换客户端密钥。轮换生效后，后续发起的 OAuth 授权流程、令牌获取请求将统一使用新的客户端密钥。
火山云角色	不支持	火山云角色凭据不依赖 API Key 或 OAuth 客户端密钥，不存在密钥载体，因此不支持密钥轮换功能。

前提条件

确认新 API Key 具备 Agent 调用目标服务所需的接口权限和调用额度，并与当前业务环境一致，例如测试环境或生产环境，避免因权限不足、额度受限或环境不匹配导致调用失败。

确认第三方服务是否配置了 IP 白名单、来源域名、网络出口、地域或其他认证限制。如果存在相关限制，请提前将 AgentKit 使用的出口信息加入允许范围。了解更多

操作步骤