扣子主账号和子账号的 API 密钥权限该怎么分配,子账号能不能只调用不发布?

扣子的 API 密钥权限由子账号在空间里的角色决定,不是给密钥单独配权限:主账号负责分配角色和发布权限,各子账号在自己的身份下签发令牌,调用只在该角色的能力范围内生效。把主账号令牌分给多人共用,等于放弃审计与最小权限,不适合对外生产环境。

扣子的 API 密钥不能由主账号统一生成后“分配”给子账号使用,正确做法是主账号只分配空间角色,各子账号在自己的账号下签发令牌,实际调用权限等于该子账号的角色权限与令牌自身范围两者的交集。这条规则对团队空间和对外提供服务的智能体都成立,但个人空间下没有成员可分配,不适用。 令牌挂在人身上而不是挂在智能体上,这是整套权限设计的前提。扣子的访问令牌归属于签发它的那个账号,调用时平台识别的是“谁在调”,而不是“调的是哪个 Bot”。所以主账号生成一把令牌交给三个人用,事后看到的所有调用都指向主账号本人,出了问题无法定位到具体的人,也没法只收回其中一个人的权限。 角色分层是第一道闸门,主账号该做的是把人放进合适的角色里,而不是去调密钥开关。团队空间通常区分所有者、管理员和普通成员几类身份,所有者管成员与空间设置,管理员管资源和发布,普通成员只能在自己被授权的范围内编辑或使用;具体角色名称与可操作项以平台当前版本为准。角色定完,子账号能签发多强的令牌就已经被框住了。 子账号签发令牌时要按最小权限收窄范围,而不是默认全选。同一岗位往往只需要调用已发布智能体的对话接口,不需要读取知识库原文、不需要修改工作流、更不需要管理成员。让每个子账号只申请当前任务真正用到的那几项能力,令牌泄露时损失面才是可控的,这也是后面做轮换和追责的基础。 编辑权限和发布权限必须拆开,这是主子账号分配里最容易被忽略的一条。能改提示词、能调知识库的人,不一定应该有权把智能体发布到对外渠道;对外发布意味着真实用户会进来,涉及品牌口径和内容合规,通常收在管理员或所有者手里。把“内容维护”和“渠道上线”分成两个角色,事故率会明显下降。 同一子账号在不同环境要签发不同令牌,测试与生产不要共用一把。测试期令牌可能被写进本地脚本、贴进调试工具,泄露概率天然更高;生产令牌只放在服务端环境变量里,从不进代码仓库。这样轮换时也能分批做:先换测试令牌验证流程,再换生产令牌,避免一次操作把所有调用打断。 审计和计量都跟着令牌走,这决定了密钥该怎么切分。调用日志记录的是令牌对应的账号,谁在什么时候调了多少次、失败率多少,都能落到具体的人或服务账号上。如果所有业务共用主账号一把钥匙,用量上涨时无法判断是客服接待量增加还是某个脚本在刷接口,成本归因和异常排查都会变得很被动。 外包、实习和临时协作场景,应该临时开子账号而不是共享主账号令牌。给外包开一个只含调用权限的成员身份,项目结束当天停用该账号并让其令牌失效,权限随人走、随人停。反过来,把主账号令牌发给外部人员,等于把整个空间的资源和成员管理暴露出去,且无法在项目结束后精准回收。 最常见的错误是把令牌写进前端页面或低代码客户端。浏览器里能看到的密钥等于公开的密钥,任何人打开开发者工具就能取走并冒用。对外提供智能体服务时,令牌只能保存在服务端,由后端代理转发请求,前端只与自己的后端通信;这条边界对小程序、网页客服挂件和第三方平台集成都一样适用。 三人以内的小团队可以只开一个开发者子账号,但对外提供服务的生产调用仍应单独建一个只负责调用的子账号。人数增加后再按岗位继续拆分:内容运营管提示词与知识库,研发管接口联调,客服主管看会话质量,各自持令牌、各自可停用。主账号长期只做成员管理和发布审批,不参与日常调用,是这套分配方式最稳的形态。这样即使某把令牌泄露,影响范围也限于一个岗位、一个环境。