文档中心

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 调用。