# 授权管理

License 规定当前部署的**每分钟智能体请求数（RPM）**和**授权有效期**，所有设备和执行节点共享授权额度。

## 授权控制什么

文字对话、语音对话、IM、MQTT、工作流、定时任务和 A2A 触发的智能体请求均计为一次请求；同一请求内的模型调用、工具调用和内部重试不重复计数。

用量按连续 **60 秒**窗口统计，每次请求启动满 60 秒后不再计入用量。达到上限时，新请求排队等待可用额度和执行资源，仍受请求超时限制；请求完成不会提前返还额度。

例如，**100 次/分钟**加上 **20% 弹性额度**，最多在任意连续 60 秒内启动 **120 次请求**。第 121 次请求排队等待，直到之前的请求启动时间移出窗口。

License 不会自动增加服务器或模型服务资源。扩容授权后，请结合[部署与配置](./deployment.md)确认服务器和模型服务能够承载相应负载。

这几种额度分别管理：

| 项目 | 管理的内容 |
| --- | --- |
| License | 当前平台部署的每分钟智能体请求数与授权有效期 |
| [设备 AI 额度](./ai-credits.md) | 每台设备可以消耗的 AI 使用预算 |
| 第三方服务额度 | 模型、语音识别和语音合成服务商提供的调用额度或余额 |

> **注意：** License 不包含大模型、语音识别、语音合成等第三方服务的使用额度。相关服务的额度与费用由对应服务商单独管理。

未导入正式授权时，默认使用 **10 次/分钟**的试用 License，含弹性额度最多 **12 次/分钟**，**不过期**。
工作空间顶部显示「试用 License」，授权页显示「默认」类型。软件升级保留已导入的正式授权。

## 查看授权和用量

在工作空间打开**设置 → License 授权**，查看当前授权。用量上限包含页面注明的额外额度。

![默认试用 License 的额度和用量](../images/docs/platform/license/zh/01-overview.png)

| 页面信息 | 含义 |
| --- | --- |
| 额度和类型 | 以**次/分钟**显示请求额度；类型为“默认”或“正式” |
| 最近 60 秒已启动 | 当前部署最近 60 秒内已启动的请求数与启动上限 |
| 排队等待 | 正在等待请求额度或执行资源的请求数 |
| 到期时间 | 正式授权的有效期限，需在到期前续期 |
| 客户标识、租户标识和部署标识 | 授权归属与对应部署；申请时提供实际租户和部署标识 |

## 申请 License

申请、扩容或续期 License，请[联系我们](mailto:contact@emqx.io)。提供平台的**租户标识**和**部署标识**，并说明所需每分钟请求数和授权期限。这两项标识可以在授权页或**更新 License**弹窗中查看。

我们会提供对应的 `.lic` 授权文件，由部署管理员导入平台；也可以在部署交付时完成配置。

## 配置 License

1. 在工作空间打开**设置 → License 授权**，点击**更新 License**。
2. 选择收到的 `.lic` 授权文件。
3. 输入**授权管理令牌**，点击**导入授权**，进入信息确认界面。
4. 核对授权归属、部署信息、每分钟请求额度和到期时间，点击**确认更新**。需要修改文件时，点击**返回检查**。
5. 收到成功提示后，确认授权页中的新额度和到期时间。新授权立即在当前平台部署生效，无需重启。

![更新 License 弹窗](../images/docs/platform/license/zh/02-update-license.png)

授权管理令牌是部署管理员保管的导入密码，与日常登录凭证独立。普通用户可以查看授权信息，
需要导入时请联系部署管理员。服务方也可以在交付部署时完成导入。导入所需的部署配置见[环境变量](../operate-reference/configuration/environment-variables.md)。

## 扩容和续期

联系服务方获取新授权文件，再由管理员导入。升级至 **200 次/分钟**且弹性额度保持 20% 时，
最高额度变为 **240 次/分钟**。软件升级、授权扩容和续期互相独立。

软件升级会保留已导入的授权，不会自动扩容或续期。

导入新授权文件和重启服务不会清空最近 60 秒内已启动的请求数；正在执行的请求可以继续完成。

正式授权到期、尚未生效或校验失败时，平台不能开始新的智能体请求，也不会自动退回试用额度。授权到期时，尚未开始执行的排队请求会失败；正在执行的请求可以完成。仍可进入授权页导入有效文件。请在到期前完成续期，保持业务运行。

## 常见问题

| 现象 | 处理方式 |
| --- | --- |
| 设备有 AI 余额，请求仍在排队 | 查看 License 页的请求额度、用量和排队数量，再通过[监控](./monitoring.md)检查执行资源与服务状态。 |
| 导入提示令牌缺失或不正确 | 向部署管理员确认授权管理令牌；登录密码不能代替此令牌。 |
| 文件无效或部署不匹配 | 核对租户和部署标识，联系获取对应文件。请保留原文件，不要手动编辑。 |
| 文件已到期、尚未生效或版本冲突 | 按页面提示联系获取当前可用的新授权文件。 |

导入失败时，当前已安装的授权保持不变。若授权信息暂时无法读取，请先重试，再联系部署管理员检查服务状态。