🚧 Roadmap — 本页描述的能力尚在路线图中,概念与设计已定型,接口与操作步骤以正式发布为准。
Limits 与 SLA
本页是 GenAuth Agent Identity 的配额与性能基线框架。所有数字以正式发布口径为准——压测与容量口径由工程侧统一给出,未发布前本页不提供任何具体数值,也请勿以第三方渠道听到的数字做容量规划。
配额与性能条目
| 条目 | 它约束什么 | 基线值 |
|---|---|---|
| 单租户 Agent 数上限 | 一个租户可注册的 Agent 身份总数——决定舰队规模的天花板 | 待发布 |
| 单用户并发委托数 | 一个用户同时生效的委托授权数量——防止单个用户面被无限展开 | 待发布 |
| 委托令牌签发速率 | 单位时间内可签发的委托令牌数(按租户计)——服务端集成的吞吐边界 | 待发布 |
| 令牌兑换 QPS | 令牌兑换接口的每秒请求上限——Agent 访问资源前的必经一跳,通常是最高频调用 | 待发布 |
| 审计查询延迟 | 审计事件从发生到可查询的延迟目标——决定告警与追溯的实时性 | 待发布 |
| SLA 可用性目标 | 服务可用性承诺(月度口径)——签发与兑换链路的可用性即 Agent 的行动能力 | 待发布 |
当前已生效的契约边界
与上表的"待发布"不同,委托令牌的有效期范围 60–86400 秒(expiresIn)是已发布 SDK(@eazo/anima v0.2.1)中生效的契约,可直接作为集成设计依据。安全上建议按最短可用时长取值,理由见安全考量。
触达限额时会发生什么
正式发布时,本节将给出各条目触达限额后的行为口径(拒绝并返回限流错误、排队、还是降级)与建议的重试策略。在此之前,集成侧应当默认按"限流即拒绝 + 指数退避重试"设计客户端,这是最保守也最不会返工的假设。
如何申请提升配额
正式发布后,本节将提供配额提升的自助申请流程与审批口径(哪些条目可自助上调、哪些需要容量评估)。
在此之前:如果你的场景对上表任一条目有明确的容量诉求(例如大规模 Agent 舰队、批量委托签发),请通过你的支持渠道或解决方案联系人提交预期规模与峰值口径——这些输入会直接参与正式配额口径的制定。
下一步
- Agent 舰队治理 —— 规模化运行 Agent 时的治理视角
- 第一次委托:30 分钟跑通 —— 先跑通,再谈容量
- API Reference —— 各端点的请求与错误契约