Arcade.dev 让 Agent 按每个用户自己的权限行事
调用 API 最容易,难的是 Agent 用谁的令牌、能做什么,令牌又由谁保管。
要点速览
- Arcade 位于 Agent 与外部系统之间,让 Agent 以用户本人的身份行事,而不是通过共享账号。
- 权限通过客户现有的 OAuth 流程和身份提供方来执行,凭据从不经过模型。
- 要用好它,先学 OAuth 2.0 和 scope 设计,再学 SDK。
每个 Agent 演示都能发邮件。麻烦在于客户追问:这封邮件是用谁的权限发出去的?如果答案是“环境配置文件里的一个共享令牌”,和安全团队的会议通常就到此为止了。
Arcade.dev 正是为这一刻而生。其官网称这款产品是面向企业 AI 智能体的动作运行时(actions runtime),位于 Agent 与它接触的每个系统之间。核心承诺是委托授权(delegated authorization):Agent 以用户的身份行事,绝不超出已授予的 scope。
对前线部署工程师(FDE)来说,这不是基础设施层面的细节。它往往决定了一个 Agent 能接入真实数据走进生产环境,还是永远留在沙箱里。
共享令牌是一笔安全债
Arcade 在 2025 年 3 月的融资公告里把问题说得很直白:系统要求个人身份认证,所以 Agent 无法代表用户行事。部分创始团队成员此前在 Okta 做认证,他们把 Agent 的问题看作身份问题,也就不奇怪了。
常见的捷径是建一个权限很宽的服务账号,让 Agent 替所有人使用。这样能跑通,但日志里每个操作都只有同一个身份,Agent 还能接触到下达指令的人本无权查看的数据。
单一共享令牌
- Agent 带着一个宽权限账号的权限
- 日志看不出到底是谁下达的指令
- 泄露一个令牌,就泄露了整个系统的访问权
委托授权
- Agent 带着用户本人的权限
- 每个工具只使用已授予的 scope
- 用户自己登录,令牌单独管理
Arcade 在 Agent 和 Gmail 之间做了什么?
Arcade 的文档称,它负责处理 OAuth,并管理每个用户的令牌、API 密钥和密钥信息。权限通过客户已有的 OAuth 流程和身份提供方来执行,无需另建一套平行的授权系统。
核心概念是 scope。按照文档的说法,scope 是用户允许另一方(这里就是 Agent)代表自己做的事;每个工具都需要特定的 scope,例如 gmail.send。如果用户还没有授权,Arcade 会请用户为该工具授权,并编排整个 OAuth 2.0 流程。
在覆盖范围上,官网宣称有 8,000 多个受权限控制的工具,另外还支持你自己构建或自带的 MCP 服务器。这个数字来自厂商,与其相信总数,不如逐一核实客户需要的具体工具。
追踪一次请求
假设你部署一个 Agent 来支持销售团队。一位员工,就叫她 Lan,输入:“今天上午演示结束后,给客户发一封感谢邮件。”Agent 决定调用 Gmail 发送工具,这个工具需要 gmail.send scope。
第一次使用时,Lan 还没有授予该权限,于是 Arcade 请她授权。借助 Arcade 与 Anthropic 为 MCP 引入的 URL elicitation 机制,服务器可以在 Lan 的浏览器中打开一个安全的登录页面,由她直接用 Google 账号登录。据 SiliconANGLE 报道,这一流程确保凭据数据从不经过模型本身。
此后,邮件从 Lan 的邮箱发出,且只在 gmail.send scope 范围内。如果同事使用同一个 Agent,必须授予自己的权限。Agent 不会因为曾经代 Lan 发过邮件,就能读取她的邮箱。
Arcade 解决不了什么?
委托授权回答的是“Agent 被允许做什么”,而不是“Agent 做得对不对”。一个持有有效 gmail.send scope 的 Agent,仍然可能把错误的内容发给正确的收件人。评测,以及敏感操作前的确认步骤,依然是你的工作。
由于 Arcade 依赖客户的 OAuth 和身份提供方,部署质量取决于这些基础设施。如果客户内部还没有约定谁可以授予什么权限,工具不会替你坐下来和身份团队理清楚。为每个工具设计最小 scope,也仍是一项需要你负责的技术决策。
三个可能毁掉设计的错误
第一,图方便申请宽泛的 scope。如果工具只需要发邮件,你却申请了完整的邮箱访问权限,委托授权的好处就白白丢了。维护一张小表:每个工具一行,旁边写上能完成任务的最窄 scope。
第二,让令牌泄露到不该出现的地方。登录流程也许能让凭据远离模型,但你的代码仍可能在调试时不小心把令牌打印到调试日志,或粘贴进提示词。交付之前,在日志和提示词历史里搜一遍任何看起来像令牌的内容。
第三,为了让演示快一点而退回共享账号。那个演示会成为客户记住的版本,等安全团队介入时,你得把一切重新解释一遍。
打开 SDK 之前要学什么
把 OAuth 2.0 学透:授权码流程、scope,以及令牌如何刷新。然后学足够的 MCP,弄懂工具如何描述、如何调用。有了这两块基础,Arcade 就是一层便利工具,而不是黑盒。
从职业发展看,这项技能值得在简历上单独写一行。与其写“构建了集成 Gmail 的 Agent”,不如写“为 Agent 设计按用户授权,每个工具使用最小 scope,模型上下文中不含任何凭据”。
如果某个 FDE 岗位描述提到身份、OAuth 或安全评审,就把它当作面试提问的起点:他们的 Agent 接触哪些系统,用的是谁的权限?
下次见客户时,别先讲 Agent 能做什么。先讲 Agent 将以谁的权限行事,因为这是安全团队会问的第一个问题。
这篇文章对你有帮助吗?
感谢你的反馈!