跳转到主要内容
Didit Authentication 的智能体访问功能让您应用的用户可以批准自己的 AI 智能体代其行事。用户可以查看智能体请求的内容并予以批准,之后智能体会获得一个独立的、权限范围受限的会话。该会话会自动结束,用户或您的团队也可以随时撤销。您的后端通过令牌中的 act 声明来区分智能体的请求与用户本人的请求。 智能体访问功能包含在每个套餐中,无需额外付费。

工作原理

  1. AI 代理请求代表您应用中的某个人执行操作,并列出所需的权限范围。
  2. 该用户在您应用的托管审批页面或您自己的同意页面上登录,可以看到代理的名称、它是否已通过验证,以及它请求的内容。
  3. 用户可以缩小请求范围(减少权限范围、缩短会话时长、仅选择部分组织),然后批准请求。如果您的设置要求,批准时还需使用新的通行密钥。
  4. 代理收到一个一次性授权码,并用它换取自己的令牌。其访问令牌的有效期最长为 5 分钟,与用户的访问令牌相同。
  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 按钮。
Didit 商业控制台中的智能体访问页面,显示智能体设置、关键指标,以及带有 Revoke 按钮的活跃智能体会话

身份认证 > 智能体访问。

撤销会立即结束该智能体的会话,您还可以向相关用户发送邮件,告知其会话已结束。 您的团队也可以结束某位用户的全部智能体会话:在 Users 中封禁该用户、重置其 MFA 或撤销其会话,同样会撤销其智能体访问权限。

邮件与事件

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