# Arcade.dev 让 Agent 按每个用户自己的权限行事

> 调用 API 最容易，难的是 Agent 用谁的令牌、能做什么，令牌又由谁保管。

原文: https://fdetimes.net/zh/tools/arcade-dev-delegated-authorization-agents/

每个 Agent 演示都能发邮件。麻烦在于客户追问：这封邮件是用谁的权限发出去的？如果答案是“环境配置文件里的一个共享令牌”，和安全团队的会议通常就到此为止了。

Arcade.dev 正是为这一刻而生。其官网称这款产品是面向企业 AI 智能体的动作运行时（actions runtime），位于 Agent 与它接触的每个系统之间。核心承诺是委托授权（delegated authorization）：Agent 以用户的身份行事，绝不超出已授予的 scope。

对前线部署工程师（FDE）来说，这不是基础设施层面的细节。它往往决定了一个 Agent 能接入真实数据走进生产环境，还是永远留在沙箱里。

## 共享令牌是一笔安全债

Arcade 在 2025 年 3 月的融资公告里把问题说得很直白：系统要求个人身份认证，所以 Agent 无法代表用户行事。部分创始团队成员此前在 Okta 做认证，他们把 Agent 的问题看作身份问题，也就不奇怪了。

常见的捷径是建一个权限很宽的服务账号，让 Agent 替所有人使用。这样能跑通，但日志里每个操作都只有同一个身份，Agent 还能接触到下达指令的人本无权查看的数据。

## 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 发过邮件，就能读取她的邮箱。

**要点:** Agent 应当借用用户的权限，而不应拥有属于自己的权限。

## 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 将以谁的权限行事，因为这是安全团队会问的第一个问题。

**本周动手试试:**

- 挑一个你正在做的 Agent，列出它调用的每个工具以及各自需要的最小 scope，例如用 gmail.send，而不是完整的邮箱访问权限。
- 在纸上重画一遍 OAuth 2.0 授权码流程，标出令牌存放在哪里，以及哪些地方绝不能让模型看到它。
- 阅读 Arcade 文档中的认证部分，写下部署前你会向客户身份团队提出的三个问题。

## 信源

- [Arcade: The Actions Runtime for Enterprise AI Agents](https://www.arcade.dev)

- [Arcade Docs](https://docs.arcade.dev/home)

- [How Arcade helps with Agent Authorization (About Arcade)](https://docs.arcade.dev/home/auth/how-arcade-helps)

- [AI Agent Auth: A Security Breakthrough (Arcade.dev Raises $12M)](https://www.arcade.dev/blog/arcade-dev-raises-12m-to-solve-the-biggest-security-challenge-in-ai-agents)

- [Arcade.dev and Anthropic advance MCP with new secure authorization flow](https://siliconangle.com/2025/11/25/arcade-dev-anthropic-advance-mcp-new-secure-authorization-flow/)
