Ограничения использования и принудительное применение

Каждый план AACWorkflow включает ограничения на количество агентов, команд, автопилотов и рабочих пространств, которые вы можете создать. Когда вы достигаете ограничения, AACWorkflow предотвращает создание новых ресурсов и показывает подсказку обновления.

Ограничения плана по уровню

Эти ограничения применяются на аккаунт. Если вы владелец аккаунта, ограничения применяются ко всем созданным рабочим пространствам.

Что происходит, когда вы достигаете ограничения

Когда вы пытаетесь создать ресурс и достигли ограничения:

1. Запрос создания возвращает ошибку
2. Вы видите подсказку обновления в интерфейсе
3. Ресурс не создается

Пример: Вы находитесь на плане Free с 5 агентами и пытаетесь создать 6-го.

{
  "error": "quota_exceeded",
  "kind": "agents",
  "limit": 5,
  "current": 5,
  "plan": "free"
}

Ответ: 402 Payment Required

Интерфейс показывает:

Вы достигли ограничения агентов для вашего плана Free (5 агентов).
Чтобы создать больше агентов, обновитесь на Business или Enterprise.
[Обновиться сейчас]

Проверка вашего текущего использования

Посмотрите использование текущих ресурсов в Настройки → Платежи → Использование:

• Созданные агенты против ограничения
• Созданные команды против ограничения
• Созданные автопилоты против ограничения
• Созданные рабочие пространства против ограничения

Интерфейс показывает прогресс-бар для каждого типа ресурса и предупреждает вас перед достижением ограничения.

Мягко удаленные ресурсы

Ресурсы, которые архивированы или удалены (мягкое удаление), не учитываются при вашем ограничении. Вы можете удалить и пересоздать ресурсы, чтобы остаться в пределах вашего плана.

Например:

• У вас 5 агентов (максимум плана Free)
• Вы архивируете 2 агентов
• Теперь вы можете создать 2 новых агентов (вы используете 3)

Мягкие удаления постоянны для целей квоты — вы не можете восстановить архивированные ресурсы, чтобы вернуть квоту.

Обновление вашего плана

Когда вы достигаете ограничения:

1. Нажмите кнопку Обновиться сейчас в подсказке ошибки (или перейдите в Настройки → Платежи → Планы)
2. Выберите более высокий план (Business или Enterprise)
3. Завершите обновление
4. Новые ресурсы становятся доступны сразу же

Ограничения увеличиваются мгновенно при завершении обновления — без задержки или ожидания.

Ограничения рабочего пространства (уровень аккаунта)

Ограничение рабочего пространства применяется на аккаунт (применяется к владельцу аккаунта):

• План Free: 1 рабочее пространство
• План Business: 10 рабочих пространств
• План Enterprise: Без ограничений

Если вы находитесь на плане Free и хотите создать второе рабочее пространство, вам нужно обновиться на Business.

Понимание вашего плана

Чтобы увидеть ваш текущий план и ограничения:

1. Перейдите в Настройки → Платежи
2. Посмотрите ваш текущий план (Free, Business или Enterprise)
3. Нажмите Просмотреть детали, чтобы увидеть ограничения для каждого типа ресурса

Вы также можете увидеть страницу цен плана по адресу /pricing для обзора всех планов.

Применение и интеграция платежей

Ограничения плана применяются сервером AACWorkflow при попытке создать ресурс. Применение проверяет:

1. Ваш текущий план (из сервиса платежей)
2. Ваше текущее количество ресурсов (из базы данных)
3. Превысит ли создание одного больше ресурса ограничение

Если да, запрос отклоняется с 402 Payment Required.

Поведение fail-open

Если сервис платежей временно недоступен:

• AACWorkflow использует поведение fail-open — ограничения рассматриваются как безлимитные
• Вы все равно можете создавать ресурсы
• После восстановления платежей обычные ограничения применяются снова

Это гарантирует, что авария платежей не заморозит производительность вашей команды.

Мониторинг использования ограничений

Чтобы избежать неожиданного достижения ограничений:

1. Установите оповещения (через вашего менеджера аккаунта) для приближения к ограничениям
2. Просмотрите ваше использование ресурсов ежемесячно в Настройки → Платежи → Использование
3. Архивируйте неиспользуемые ресурсы, чтобы освободить квоту, если вы близко к ограничению
4. Планируйте рост вашей команды и обновляйтесь перед достижением ограничений

API и автоматизация

При использовании API AACWorkflow для создания ресурсов:

• Применяются те же ограничения
• Возвращается та же ошибка 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();
  }
}

Гарантии ограничений плана

• Нет скрытых отказов — если вы достигаете ограничения, вы получаете ясную ошибку, а не crash
• Немедленный эффект — ограничения вступают в силу, когда ваш план активен
• Точность — ограничения проверяются в момент создания, поэтому нет race condition
• Справедливо для всех команд — ограничения применяются на рабочее пространство и на аккаунт, а не общие

Часто задаваемые вопросы

В: Могу ли я превысить ограничение плана, если буду использовать API напрямую?

О: Нет. Ограничения применяются на уровне сервера, независимо от того, используете ли вы интерфейс или API.

В: Учитываются ли архивированные агенты против моего ограничения?

О: Нет. Архивированные ресурсы являются мягко удаленными и не учитываются при вашем ограничении.

В: Что происходит, если я понижу мой план?

О: Если у вас есть больше ресурсов, чем позволяет ваш новый план, вы будете на или выше ограничения. Вам нужно будет удалить или архивировать ресурсы перед созданием новых. (Существующие ресурсы никогда не удаляются при понижении.)

В: Может ли мой менеджер аккаунта увеличить ограничения вручную?

О: Для клиентов Enterprise — да. Свяжитесь с вашим менеджером аккаунта, чтобы запросить настраиваемое увеличение ограничения.

В: Есть ли период благодати после обновления?

О: Нет. Ограничения вступают в силу немедленно при завершении обновления плана.

Следующие шаги

• Функции управления Enterprise — контроль бюджета и дополнительно
• Платежи — управляйте вашей подпиской и способом платежа
• Цены — посмотрите все доступные планы и цены