文档中心

AgentKit

请输入

管理凭据

绑定与解绑 Agent

凭据与目标 Agent 绑定后，Agent 才能在运行时引用该凭据访问外部服务。通过绑定和解绑操作，可以控制凭据的使用范围：绑定用于授权 Agent 使用凭据；解绑用于在 Agent 下线、权限调整或删除凭据前撤销授权。

建议遵循最小授权原则，仅绑定确有业务需求的 Agent。解绑前，请确认 Agent 已停止使用该凭据或已切换至其他凭据，避免影响正在运行的出站调用。

注意

仅 API Key 和 OAuth 连接类型的凭据支持绑定 Agent。火山云角色凭据通过身份来源和角色分配规则控制使用范围，不支持绑定 Agent。

适用场景

操作	场景
绑定 Agent	将新建凭据授权给目标 Agent API Key 或 OAuth 连接凭据创建完成后，如果需要指定 Agent 使用该凭据访问外部服务，可以执行绑定操作。绑定成功后，Agent 才能在运行时引用该凭据。调整凭据的授权范围当业务范围、调用链路或权限要求发生变化时，可以通过新增绑定或解除绑定，重新控制哪些 Agent 可以使用该凭据。
解绑 Agent	Agent 下线或不再访问目标服务当 Agent 已下线，或不再需要访问凭据对应的第三方服务时，应及时解除绑定，减少不必要的凭据授权范围。删除凭据前清理绑定关系如果凭据已绑定 Agent，删除前需要先解除全部绑定关系。清理完成后，再根据页面提示删除凭据，避免影响仍在运行的 Agent 调用。

前提条件

若需将凭据绑定到 Agent，请确保已提前创建目标 Agent，并确认其运行状态正常。具体操作请参见创建运行时。

操作步骤

绑定 Agent

绑定 Agent 用于授予指定 Agent 使用当前凭据的权限。绑定关系关联目标 Agent 的唯一标识。完成绑定后，该 Agent 可在运行过程中按照凭据配置取用密钥或令牌，访问对应的第三方 API 或下游服务。

说明

建议遵循最小授权原则，仅将凭据绑定到确有访问需求的 Agent。

解绑 Agent

解绑 Agent 用于撤销选定 Agent 对当前凭据的使用授权。解绑完成后，该 Agent 将无法再引用此凭据，所有依赖该凭据的第三方 API、下游服务调用均可能失败，请谨慎执行。

注意

解绑只会阻止 Agent 后续通过平台取用该凭据，不会自动撤销或立即清除业务进程中已经取得的凭证。解绑前已被获取的密钥、令牌或临时凭证，是否仍能继续使用，取决于凭证自身有效期、业务缓存机制以及第三方服务或云平台的撤销规则。了解更多

后续步骤

解绑完成后，建议通过智能体运行时的在线测试发起一次受控调用，验证目标 Agent 已无法继续通过原绑定关系取用凭据。了解更多

最近更新时间：2026.10.23 16:53:59

这个页面对您有帮助吗？

有用

无用