> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 智能体访问：让用户的 AI 智能体代其操作

> 让用户批准自己的 AI 智能体在您的应用中代为操作。会话范围受限、自动过期，用户或您的团队均可随时撤销。Didit 提供支持。

Didit Authentication 的智能体访问功能让您应用的用户可以批准自己的 AI 智能体代其行事。用户可以查看智能体请求的内容并予以批准，之后智能体会获得一个独立的、权限范围受限的会话。该会话会自动结束，用户或您的团队也可以随时撤销。您的后端通过令牌中的 `act` 声明来区分智能体的请求与用户本人的请求。

智能体访问功能包含在每个套餐中，无需额外付费。

## 工作原理

1. AI 代理请求代表您应用中的某个人执行操作，并列出所需的权限范围。
2. 该用户在您应用的托管审批页面或您自己的同意页面上登录，可以看到代理的名称、它是否已通过验证，以及它请求的内容。
3. 用户可以缩小请求范围（减少权限范围、缩短会话时长、仅选择部分[组织](https://docs.didit.me/zh/authentication/organizations.md)），然后批准请求。如果您的设置要求，批准时还需使用新的通行密钥。
4. 代理收到一个一次性授权码，并用它换取自己的令牌。其访问令牌的有效期最长为 5 分钟，与用户的访问令牌相同。
5. 代理发往您后端的每个请求都携带一个令牌，该令牌中的 `act` 声明会标明代理本身以及用户批准的权限范围。

代理的会话会在有效期届满、空闲超时后结束，或在用户或您的团队将其撤销后结束。

## 启用并选择规则

智能体访问功能在新应用中默认关闭。
请前往 **Authentication > Agent access** 将其开启，然后点击 **Edit settings**：

| 设置 | 选项 | 默认值 |
| - | - | - |
| 智能体可以执行的操作 | **仅读取**（`read`）：查看用户的账户信息。**代表其操作**（`act`）：更改用户的账户设置和偏好。 | 选择前无 |
| 哪些智能体可以发起请求 | 目前任何智能体都可以发起请求，批准页面会显示该智能体是否经过验证。仅允许经过验证的智能体目前尚不可用。 | 任何智能体 |
| 会话持续时间 | 1、7 或 30 天。 | 7 天 |
| 空闲多久后结束 | 30 分钟、2 小时或 24 小时。 | 2 小时 |
| 用户如何批准 | **通行密钥**，或 **其常用登录方式**。 | 通行密钥 |
| 仅由本人批准智能体请求 | 每次批准都需要由批准人自己的通行密钥提供一个新的断言。 | 关闭 |

用户只能在批准页面上关闭您提供的任何权限范围，不能开启。
更改适用于新的批准：已有的活跃智能体会话将保留用户批准的内容。

**仅由本人批准智能体请求**（`agent_humans_only`）只能由您的 Didit 组织的所有者或管理员更改，且该人员须先在其自己的控制台账户中设置通行密钥。
该设置可证明批准人使用了自己的身份验证器并完成了用户验证，且验证在五分钟内完成并与该请求绑定；它并不能检测一般意义上的自动化操作。
如需搭建您自己的同意页面，相关接口调用请参阅[使用通行密钥进行智能体批准](https://docs.didit.me/zh/authentication/sign-in-methods.md#使用通行密钥批准智能体)。

## 添加到你的应用

支持该功能的代理会自行将用户引导至你的批准页面。
你的应用需要完成两件事：

**让用户查看并撤销其代理。**
在 React 中，于账户设置页面渲染 `<ConnectedAgents />`。它会列出用户已通过的代理，每个代理旁边都有一个 **撤销** 按钮。
参见 [React 快速入门](https://docs.didit.me/zh/authentication/quickstarts/react.md)。

**在后端检查 `act` 声明。**
代理的访问令牌与用户的访问令牌使用相同的密钥签名，并带有相同的 `typ`、`iss` 和 `aud`，因此只有 `act` 能将二者区分开：

| `act` | 谁在调用 | 允许的操作 |
| - | - | - |
| `null` | 用户本人。 | 用户可执行的操作。 |
| `{"sub", "agent", "scopes"}` | 代表用户行事的 AI 代理。 | 仅允许 `act.scopes` 授予的内容，且只限于你向代理开放的路由。其他所有位置一律拒绝。 |

代理令牌中的 `sid` 是用户所授予访问权限的 ID，而 `GET /session/` 始终会拒绝代理的令牌。
有关代码中的检查方法，参见[在服务器上验证令牌](https://docs.didit.me/zh/authentication/tokens-and-jwks.md#在服务器上验证令牌)。

## 在控制台中查看与撤销

**Authentication > Agent access** 页面显示：

* **概览：** 活跃的智能体会话数、过去 7 天内用户批准的会话数、拥有智能体的用户数，以及本月撤销次数，分别按用户和团队统计。
* **活跃的智能体会话：** 每位用户、其智能体及描述、智能体是否已验证、智能体可执行的操作、最近一次活动，以及会话结束时间，并附有 **Revoke** 按钮。

![Didit 商业控制台中的智能体访问页面，显示智能体设置、关键指标，以及带有 Revoke 按钮的活跃智能体会话](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-agent-access.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=7cc518e37e2ccafa5515eb22e6ef9b8d)

身份认证 > 智能体访问。

撤销会立即结束该智能体的会话，您还可以向相关用户发送邮件，告知其会话已结束。

您的团队也可以结束某位用户的全部智能体会话：在 **Users** 中封禁该用户、重置其 MFA 或撤销其会话，同样会撤销其智能体访问权限。

## 邮件与事件

当您的团队在控制台中撤销某个代理的访问权限时，您可以选择向该人员发送邮件，告知其访问已终止。
该邮件使用您的品牌，与每封[登录邮件](https://docs.didit.me/zh/authentication/branding-and-custom-domain.md#登录邮件)一样。

批准和撤销操作会以 `security.agent_access_approved` 和 `security.agent_access_revoked` 事件的形式记录在该人员的时间线上。
即使代理从未兑换其授权码，只要该人员同意，Didit 就会记录一次批准。
参见[代理批准审计](https://docs.didit.me/zh/authentication/events-and-webhooks.md#代理审批审计)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.