사용 한계 및 적용

각 AACWorkflow 계획에는 생성할 수 있는 에이전트, 팀, 자동 조종 및 작업 공간의 수에 대한 한계가 포함됩니다. 한계에 도달하면 AACWorkflow는 더 많은 리소스 생성을 방지하고 업그레이드 프롬프트를 표시합니다.

계층별 계획 한계

이 한계는 계정당 적용됩니다. 계정 소유자인 경우, 한계가 생성하는 모든 작업 공간에 적용됩니다.

한계에 도달했을 때 일어나는 일

한계에 도달한 상태로 리소스 생성을 시도할 때:

1. 생성 요청이 오류 반환
2. UI에 업그레이드 프롬프트 표시
3. 리소스가 생성되지 않음

예: 무료 계획에 5개의 에이전트가 있고 6번째를 생성하려고 시도합니다.

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

응답: 402 Payment Required

UI는 다음을 표시합니다:

무료 계획에 대한 에이전트 한계(5개 에이전트)에 도달했습니다.
더 많은 에이전트를 생성하려면 비즈니스 또는 엔터프라이즈로 업그레이드하세요.
[지금 업그레이드]

현재 사용 확인

설정 → 청구 → 사용에서 현재 리소스 사용 확인:

• 한계 대비 생성된 에이전트
• 한계 대비 생성된 팀
• 한계 대비 생성된 자동 조종
• 한계 대비 생성된 작업 공간

UI는 각 리소스 유형에 대해 진행률 표시줄을 표시하고 한계 도달 전 경고합니다.

소프트 삭제된 리소스

아카이브되거나 삭제(소프트 삭제)된 리소스는 한계에 계산되지 않습니다. 리소스를 삭제하고 다시 생성하여 계획 범위 내에 유지할 수 있습니다.

예:

• 5개의 에이전트(무료 계획 최대)가 있음
• 2개의 에이전트 아카이브
• 이제 2개의 새 에이전트 생성 가능(3개 사용)

소프트 삭제는 할당량 목적으로 영구적입니다 — 아카이브된 리소스를 복원하여 할당량을 회수할 수 없습니다.

계획 업그레이드

한계에 도달했을 때:

1. 오류 프롬프트에서 지금 업그레이드 버튼을 클릭합니다(또는 설정 → 청구 → 계획으로 이동)
2. 더 높은 계획 선택(비즈니스 또는 엔터프라이즈)
3. 업그레이드 완료
4. 새 리소스가 즉시 사용 가능

한계가 업그레이드 완료 시 즉시 증가 — 지연 없음.

작업 공간 한계(계정 수준)

작업 공간 한계는 계정당 적용(계정 소유자에 적용):

• 무료 계획: 1개 작업 공간
• 비즈니스 계획: 10개 작업 공간
• 엔터프라이즈 계획: 무제한 작업 공간

무료 계획이고 두 번째 작업 공간을 만들려면 비즈니스로 업그레이드해야 합니다.

계획 이해

현재 계획 및 한계를 보려면:

1. 설정 → 청구로 이동
2. 현재 계획 확인(무료, 비즈니스 또는 엔터프라이즈)
3. 세부 정보 보기를 클릭하여 각 리소스 유형의 한계 확인

또한 **/pricing**의 계획 가격 페이지에서 모든 계획 개요를 볼 수 있습니다.

적용 및 청구 통합

리소스 생성을 시도할 때 AACWorkflow 서버가 계획 한계를 적용합니다. 적용은 다음을 확인합니다:

1. 현재 계획(청구 서비스에서)
2. 현재 리소스 수(데이터베이스에서)
3. 하나의 추가 리소스 생성이 한계를 초과하는지

그렇다면 요청이 402 Payment Required로 거부됩니다.

실패 개방 동작

청구 서비스가 일시적으로 사용 불가:

• AACWorkflow는 실패 개방 동작 사용 — 한계가 무제한으로 취급됨
• 여전히 리소스 생성 가능
• 청구 복구 후 정상 한계 재적용

이는 청구 중단이 팀 생산성을 동결하지 않도록 보장합니다.

한계 사용 모니터링

한계 예상치 못한 도달 방지:

1. 경고 설정(계정 관리자 통해) 한계 접근 시 알림
2. 매월 리소스 사용 검토 설정 → 청구 → 사용에서
3. 미사용 리소스 아카이브 한계 근처인 경우 할당량 해제
4. 팀 성장 계획 및 한계 도달 전 업그레이드

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: 아니요. UI 또는 API 사용 여부와 관계없이 한계가 서버 수준에서 적용됩니다.

Q: 아카이브된 에이전트가 한계에 계산됩니까?

A: 아니요. 아카이브된 리소스는 소프트 삭제되고 한계에 계산되지 않습니다.

Q: 계획을 다운그레이드하면 어떻게 됩니까?

A: 새 계획이 허용하는 것보다 더 많은 리소스가 있으면 한계에서 또는 초과합니다. 새 리소스 생성 전 삭제 또는 아카이브해야 합니다. (기존 리소스는 다운그레이드 시 삭제 안 됨.)

Q: 계정 관리자가 수동으로 한계를 증가시킬 수 있습니까?

A: 엔터프라이즈 고객의 경우 예. 사용자 정의 한계 조정을 요청하려면 계정 관리자에게 문의합니다.

Q: 업그레이드 후 유예 기간이 있습니까?

A: 아니요. 계획 업그레이드 완료 시 한계가 즉시 효과 발생합니다.

다음 단계

• 엔터프라이즈 거버넌스 기능 — 예산 제어 및 더
• 청구 — 구독 및 결제 방법 관리
• 가격 — 사용 가능한 모든 계획 및 가격 확인