act 声明来区分智能体的请求与用户本人的请求。
智能体访问功能包含在每个套餐中,无需额外付费。
工作原理
- AI 代理请求代表您应用中的某个人执行操作,并列出所需的权限范围。
- 该用户在您应用的托管审批页面或您自己的同意页面上登录,可以看到代理的名称、它是否已通过验证,以及它请求的内容。
- 用户可以缩小请求范围(减少权限范围、缩短会话时长、仅选择部分组织),然后批准请求。如果您的设置要求,批准时还需使用新的通行密钥。
- 代理收到一个一次性授权码,并用它换取自己的令牌。其访问令牌的有效期最长为 5 分钟,与用户的访问令牌相同。
- 代理发往您后端的每个请求都携带一个令牌,该令牌中的
act声明会标明代理本身以及用户批准的权限范围。
启用并选择规则
智能体访问功能在新应用中默认关闭。 请前往 Authentication > Agent access 将其开启,然后点击 Edit settings:
用户只能在批准页面上关闭您提供的任何权限范围,不能开启。
更改适用于新的批准:已有的活跃智能体会话将保留用户批准的内容。
仅由本人批准智能体请求(
agent_humans_only)只能由您的 Didit 组织的所有者或管理员更改,且该人员须先在其自己的控制台账户中设置通行密钥。
该设置可证明批准人使用了自己的身份验证器并完成了用户验证,且验证在五分钟内完成并与该请求绑定;它并不能检测一般意义上的自动化操作。
如需搭建您自己的同意页面,相关接口调用请参阅使用通行密钥进行智能体批准。
添加到你的应用
支持该功能的代理会自行将用户引导至你的批准页面。 你的应用需要完成两件事: 让用户查看并撤销其代理。 在 React 中,于账户设置页面渲染<ConnectedAgents />。它会列出用户已通过的代理,每个代理旁边都有一个 撤销 按钮。
参见 React 快速入门。
在后端检查 act 声明。
代理的访问令牌与用户的访问令牌使用相同的密钥签名,并带有相同的 typ、iss 和 aud,因此只有 act 能将二者区分开:
代理令牌中的
sid 是用户所授予访问权限的 ID,而 GET /session/ 始终会拒绝代理的令牌。
有关代码中的检查方法,参见在服务器上验证令牌。
在控制台中查看与撤销
Authentication > Agent access 页面显示:- 概览: 活跃的智能体会话数、过去 7 天内用户批准的会话数、拥有智能体的用户数,以及本月撤销次数,分别按用户和团队统计。
- 活跃的智能体会话: 每位用户、其智能体及描述、智能体是否已验证、智能体可执行的操作、最近一次活动,以及会话结束时间,并附有 Revoke 按钮。

身份认证 > 智能体访问。
邮件与事件
当您的团队在控制台中撤销某个代理的访问权限时,您可以选择向该人员发送邮件,告知其访问已终止。 该邮件使用您的品牌,与每封登录邮件一样。 批准和撤销操作会以security.agent_access_approved 和 security.agent_access_revoked 事件的形式记录在该人员的时间线上。
即使代理从未兑换其授权码,只要该人员同意,Didit 就会记录一次批准。
参见代理批准审计。