使用限制和执行
了解 AACWorkflow 如何对代理、团队、自动驾驶和工作空间实施计划限制。
每个 AACWorkflow 计划都包括对您可以创建的代理、团队、自动驾驶和工作空间数量的限制。达到限制时，AACWorkflow 会阻止您创建更多资源并显示升级提示。
按层级的计划限制
| 资源 | 免费版 | 商业版 | 企业版 |
|---|---|---|---|
| 代理 | 5 | 50 | 无限制 |
| 团队 | 2 | 20 | 无限制 |
| 自动驾驶 | 1 | 10 | 无限制 |
| 工作空间 | 1 | 10 | 无限制 |
这些限制适用于每个账户。如果您是账户所有者，限制适用于您创建的所有工作空间。
达到限制时会发生什么
当您尝试创建资源但已达到限制时：
- 创建请求返回错误
- 您在用户界面中看到升级提示
- 资源未创建
示例：您在免费计划上有 5 个代理，并尝试创建第 6 个。
{
"error": "quota_exceeded",
"kind": "agents",
"limit": 5,
"current": 5,
"plan": "free"
}响应：402 Payment Required
用户界面显示：
您已达到免费计划的代理限制（5 个代理）。
要创建更多代理，请升级到商业版或企业版。
[立即升级]检查您的当前使用情况
在 设置 → 计费 → 使用情况 中查看您当前的资源使用：
- 创建的代理与限制对比
- 创建的团队与限制对比
- 创建的自动驾驶与限制对比
- 创建的工作空间与限制对比
用户界面为每种资源类型显示进度条，并在达到限制前警告您。
软删除的资源
存档或删除（软删除）的资源不计入您的限制。您可以删除并重新创建资源以保持在计划范围内。
例如：
- 您有 5 个代理（免费计划最大值）
- 您存档 2 个代理
- 现在您可以创建 2 个新代理（您使用 3 个）
软删除对配额目的是永久的 — 您无法恢复已存档的资源来回收配额。
升级您的计划
当您达到限制时：
- 点击错误提示中的立即升级按钮（或转到 设置 → 计费 → 计划）
- 选择更高的计划（商业版或企业版）
- 完成升级
- 新资源立即可用
升级完成时限制立即增加 — 无延迟或等待。
工作空间限制（账户级别）
工作空间限制适用于每个账户（适用于账户所有者）：
- 免费计划：1 个工作空间
- 商业计划：10 个工作空间
- 企业计划：无限工作空间
如果您在免费计划上并想创建第二个工作空间，您必须升级到商业版。
了解您的计划
要查看您当前的计划和限制：
- 转到 设置 → 计费
- 查看您当前的计划（免费、商业或企业）
- 点击 查看详情 以查看每种资源类型的限制
您还可以在 /pricing 处看到计划定价页面，概览所有计划。
执行和计费集成
当您尝试创建资源时，AACWorkflow 服务器会执行计划限制。执行检查：
- 您当前的计划（来自计费服务）
- 您当前的资源计数（来自数据库）
- 创建一个更多资源是否会超过限制
如果会，请求被拒绝，显示 402 Payment Required。
故障开放行为
如果计费服务临时不可用：
- AACWorkflow 使用故障开放行为 — 限制被视为无限制
- 您仍然可以创建资源
- 计费恢复后，正常限制重新实施
这确保计费中断不会冻结您的团队生产力。
监控限制使用
为避免意外达到限制：
- 设置警报（通过您的账户经理）以接近限制时通知
- 每月审查您的资源使用情况在 设置 → 计费 → 使用情况
- 存档未使用的资源以释放配额，如果您接近限制
- 计划您的团队增长并在达到限制前升级
API 和自动化
使用 AACWorkflow API 创建资源时：
- 应用相同的限制
- 故障时返回相同的
402 quota_exceeded错误 - 解析错误响应以向用户显示升级提示
示例错误处理（TypeScript）：
try {
await createAgent({ name: "new-agent" });
} catch (error) {
if (error.code === "quota_exceeded") {
console.log(`Limit: ${error.limit}, Current: ${error.current}`);
showUpgradeDialog();
}
}计划限制保证
- 无静默故障 — 如果达到限制，您会收到清晰的错误，而不是崩溃
- 立即生效 — 限制在您的计划激活时生效
- 准确性 — 限制在创建时检查，所以没有竞态条件
- 对所有团队公平 — 限制按工作空间和按账户应用，而非共享
常见问题
Q: 如果我直接使用 API，我可以超过计划限制吗？
A: 不能。无论您使用用户界面还是 API，限制都在服务器级别执行。
Q: 已存档的代理计入我的限制吗？
A: 不计。已存档的资源是软删除的，不计入您的限制。
Q: 如果我降级计划会怎样？
A: 如果您拥有的资源超过新计划允许的数量，您将达到或超过限制。您需要在创建新资源前删除或存档资源。（现有资源在降级时永不删除。）
Q: 我的账户经理可以手动增加限制吗？
A: 对于企业客户，可以。联系您的账户经理以请求自定义限制调整。
Q: 升级后有宽限期吗？
A: 没有。计划升级完成时限制立即生效。