Vercel Agent 先交计划再动手:生产环境权限按计划整体审批,只读基线自动放行
核心概要
Vercel Agent 处理生产环境问题时,先以只读权限自动调查,再提交一份写明要做哪些任务、需要哪些权限的计划,用户一次性审批后它才获得超出只读基线的权限。权限由 Vercel 授权系统中的命名能力(scope)定义,计划请求超出只读基线或包含受支持的外部操作时整体等待审批;运行时在选用已批准凭据前会确认计划处于活动状态,Vercel API 再按该凭据的权限逐次校验请求。
Vercel Agent 处理生产环境问题时,先以只读权限自动调查,再提交一份写明要做哪些任务、需要哪些权限的计划,用户一次性审批后它才获得超出只读基线的权限。权限由 Vercel 授权系统中的命名能力(scope)定义,计划请求超出只读基线或包含受支持的外部操作时整体等待审批;运行时在选用已批准凭据前会确认计划处于活动状态,Vercel API 再按该凭据的权限逐次校验请求。
权限以 Vercel 授权系统认可的命名能力(scope)表示,计划把用户想要的结果、智能体提出的任务、任务所需权限以及执行这些限制的凭据与 API 校验连在一起。 只读基线目前包含所有以 read: 开头的已注册 scope;请求超出该基线或包含受支持外部操作(例如在 GitHub 开 pull request)的计划需要审批,且整个计划连同其中的只读任务一起等待。 每个存储的计划记录任务与进度,请求的 scope 附在各任务上,任务描述说明为何需要该权限,scope 在计划层面合并;较短的只读查询可以不建计划直接运行,较长的调查则建立只读计划以便用户跟踪进度。
审批通过后,系统按只读基线加上获批权限准备令牌,运行时在选用该凭据前确认计划仍处于活动状态,凭据仍受其 scope、团队、用户自身权限和有效期的约束。 Vercel Agent 以 Vercel App 形式运行,用户授权它在团队内代表自己行动,该授权受用户已有权限限制,因此批准计划不能授予用户本人没有的访问权。 Vercel OAuth 服务把该授权换成带具体 scope 的短有效期令牌,Vercel API 在每次请求时校验令牌;若智能体尝试令牌权限之外的操作,API 会拒绝该请求,即使模型认为该操作对完成任务是必要的。
这套机制面向在 Vercel 团队内代表用户操作生产资源的 Vercel Agent,覆盖计划校验、审批、令牌准备与恢复执行等环节;只读基线目前包含所有以 read: 开头的已注册 scope,其他系统可能需要更窄的基线。
只读操作仍可能暴露敏感信息,因此自动批准不等于工作无害;scope 选择是在信息不完整时做出的,可能请求过少导致任务受阻,也可能请求过多授予超出需要的权限;被拒绝的操作可能源于缺少 scope、资源不对或本应保持阻断,需要区分。计划与令牌共用定义后,注册表拉取带来延迟和服务依赖,系统缓存目录并用该副本检查已存储的计划,直到目录随注册表变更刷新。