Agents & skills · for AI agents

사용량 및 할당량 확인

MCP를 통해 월간 할당량과 토큰 사용량을 에이전트, 사용자, 공간, 날짜 또는 모델별로 확인하여 "한도에 근접했는가?" 및 "비용을 주도하는 요인은 무엇인가?"에 답합니다.

MCP tools:tenant_infousage_stats

두 가지 읽기 전용 도구는 모든 "사용량이 얼마나 되는가?"라는 질문에 답합니다. 두 도구 모두 메타데이터만 반환하며 — 토큰 수와 이벤트 수 — 절대 대화 내용을 반환하지 않습니다.

할당량 대비 현재 위치

tenant_info()                 # plan + monthly_token_quota (the ceiling)
usage_stats(group="total")    # tokens + events used so far this period

사용 사례 — "곧 한계에 도달하는가?" tenant_info에서 monthly_token_quota를 가져와 총 사용량과 비교합니다. 과금된 과금(overage)은 사후 정산되므로, "이번 달 할당량의 82%를 사용 중"이라는 정보를 제공하면 사용자가 비용이 발생하기 전에 결정을 내릴 수 있습니다.

비용의 주요 원인

usage_stats(group=…)는 동일한 총계를 세분화합니다. 답변하려는 질문에 따라 그룹을 선택하십시오:

usage_stats(group="agent")    # which agent is busiest / burning the most tokens
usage_stats(group="user")     # which end user is heaviest — spot one runaway account
usage_stats(group="space")    # usage per customer space (multi-tenant fan-out)
usage_stats(group="day")      # trend over time — catch a spike the day it happens
usage_stats(group="model")    # cost mix across models — is an expensive model doing routine work?

간단한 사용 사례:

"이번 달 청구금이 급증했습니다 — 이유는?" → group="day"로 급증을 찾은 후 group="agent"로 해당 에이전트를 확인합니다.
"하나의 모델이 더 저렴한 모델이 수행할 수 있는 작업을 수행하고 있는가?" → group="model"을 사용하고, 문제 있는 에이전트에 대해 update_agent(name, model=…)를 고려하십시오.
"어떤 고객에게 업셀/속도 제한을 적용해야 하는가?" → group="space" 또는 group="user"를 사용하십시오.

이는 콘텐츠에 대한 분석이 아닌 메타데이터입니다. 이는 얼마나 그리고 누구/무엇에 의해라는 질문에 답하지만, 무엇이 말해졌는지에는 답하지 않습니다. 채팅 기록과 최종 사용자 프로필은 MCP를 통해 의도적으로 접근할 수 없습니다.

보고. 가장 중요한 숫자로 시작하십시오 — "월간 토큰 500만 개 중 420만 개를 사용했습니다(84%)" — 그 다음 이를 설명하는 내역을 제공하고, 전체 그림을 위해 콘솔로 연결하십시오: https://console.agent4.io/#/usage.