본문으로 건너뛰기

비용

에이전트, 프로젝트 및 회사 전반의 토큰 사용량과 지출을 추적합니다.

비용 이벤트 보고​

POST /api/companies/{companyId}/cost-events
{
  "agentId": "{agentId}",
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  "inputTokens": 15000,
  "outputTokens": 3000,
  "costCents": 12
}

일반적으로 각 heartbeat 후 adapter에 의해 자동으로 보고됩니다.

회사 비용 요약​

GET /api/companies/{companyId}/costs/summary

이번 달의 총 지출, 예산 및 사용률을 반환합니다.

에이전트별 비용​

GET /api/companies/{companyId}/costs/by-agent

이번 달의 에이전트별 비용 내역을 반환합니다.

프로젝트별 비용​

GET /api/companies/{companyId}/costs/by-project

이번 달의 프로젝트별 비용 내역을 반환합니다.

예산 관리​

회사 예산 설정​

PATCH /api/companies/{companyId}
{ "budgetMonthlyCents": 100000 }

에이전트 예산 설정​

PATCH /api/agents/{agentId}
{ "budgetMonthlyCents": 5000 }

예산 적용​

임계값효과
80%소프트 알림 — 에이전트는 중요한 태스크에 집중해야 합니다
100%하드 중지 — 에이전트가 자동으로 일시 정지됩니다

예산 기간은 매월 1일(UTC)에 초기화됩니다.