什么是密钥管理？Agent 的钥匙串

智能体替你调用各种服务，每次调用都要出示凭证——API 密钥、访问令牌、账号授权，它们就是 Agent 的钥匙。钥匙越多，丢一把的后果越重。密钥管理讲的就是这串钥匙怎么存、怎么用、怎么换，让智能体有钥匙可用，又不让钥匙散落一地。

钥匙串上挂着哪些东西

常见的凭证有几类：服务方的 API 密钥，用来调用外部接口；平台发的访问令牌，代表某个应用的授权；还有账号级的授权凭据，比如让 Agent 代收邮件的许可。扣子的插件配置里要填各家服务的密钥，DeepSeek 等模型服务的调用也需要各自的密钥，一个稍复杂的 Agent 挂着七八把钥匙很正常。

钥匙和权限是两码事：权限决定能做什么，钥匙是做这件事的凭证。权限最小化管的是给多宽，密钥管理管的是凭据本身的安全——别泄露、别硬编码、别一用到底。

密钥的范围限定也有讲究：大平台通常支持创建多个密钥、分别限定权限，这就为按需分发创造了条件。给查天气的插件配一把只能查天气的密钥，比配一把全功能密钥安全得多；就算泄露，损失也被锁在那一格。申请密钥时多花两分钟做范围限定，比事后补救省心太多。范围越细越好吗？也不是，够用即可，过细反而难维护。

生活类比：门卫手里的钥匙板

物业门卫墙上挂着一块钥匙板，每把钥匙有固定位置、编号和领用登记。谁借的、什么时候还，板上写得清楚。密钥管理就是这块板：集中存放、按需领取、用后归还、定期盘点。

钥匙板比方盖不住的细节在于：真钥匙难复制，密钥却是一串字符，看到即拿到。所以它的「保管」核心是别让它出现在不该出现的地方——聊天记录里、代码文件里、公开页面上，任何一处粘贴都是一次泄露。另外，密钥还有有效期这件事：长期不换的密钥，等于默认所有人都有时间慢慢找到它，定期轮换就是把泄露的窗口期切短。

日常保管的三条做法

• 集中存放：用平台提供的凭证管理功能，不在对话和文件里明文贴密钥。
• 按需分发：每个流程只配它用到的钥匙，别一把万能钥匙到处用。
• 定期轮换：密钥有使用期限，到期就换，弃用的及时吊销。
• 用前缀命名：每把密钥的名字写清用途，别用「新密钥2」。

自查三行：

• 你的密钥有没有出现在聊天窗口或共享文档里？
• 每个流程用的钥匙，能对应到具体用途吗？
• 有没有一把密钥从未换过？
• 每把密钥的名字能看出用途吗？

钥匙串管好了，自动化的地基才算打牢。

能力的货架，见插件生态；范围的边界，见权限最小化；用量的闸门，见执行预算；角色怎么分工，见多 Agent 的角色分工；Agent 之间怎么交接，见Agent 间通信。

说句实在话：密钥管理的全部要领，就是让每一把钥匙有名字、有位置、有期限。散落的钥匙，迟早变成事故的开端。先把名字补上，再谈别的。

关于密钥管理再多问三句

• 密钥贴给模型让它帮忙调试，有风险吗？：有。对话内容可能被留存，密钥一旦进了对话就该视为已泄露，正确做法是先吊销再换新。图方便的代价往往在几个月后才显现，但一显现就是大事。
• 写死在配置文件里方便多了，为什么不行？：文件会被复制、同步、进版本历史，泄露路径防不胜防。集中管理多花的是一次性功夫，换来的是长期可控。
• 密钥泄露了第一时间做什么？：立刻吊销并换新，再排查泄露路径和影响范围。先止损再溯源，顺序别颠倒。