> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/others/usage-statistics.md).

# 使用量の統計

組織設定の「使用量統計」ページの詳細ガイドです。利用権限とロールによる承認済み Agent への表示範囲の制限、フィルター、使用量の概要とキャッシュ節約、Agent ごとのキャッシュ節約、各タブ（Agent、ロール、メンバー、チャットプラットフォーム、連絡先、音声アシスタント、課金カテゴリ）の列の定義、ロールの使用量の計算方法、「不明」の意味、割り当て上限ページと数値が異なる理由を説明します。

<mark style="color:blue;">使用量統計</mark>は、管理者が組織の使用量を確認するための主要なページです。期間ごとの全体的な傾向を確認したり、Agent、ロール、メンバー、チャットプラットフォーム、連絡先などの観点からランキングを表示して使用量の多い対象を特定したり、Excel にエクスポートしたりできます。Credits 課金の組織では、Credit 消費量、課金カテゴリ別の内訳、キャッシュによる節約も確認できます。

## 利用できるユーザー <a href="#permissions" id="permissions"></a>

* ロールの<mark style="color:blue;">組織権限</mark>にある<mark style="color:blue;">使用量統計権限</mark>が必要です（組織オーナーにはデフォルトで付与されています。設定方法は[ロール権限の編集](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-permission.md#edit-role-permissions)を参照してください）。
* <mark style="color:blue;">Credits</mark> 指標、Credit 列、<mark style="color:blue;">課金カテゴリ</mark>タブは、Credits 課金を利用する組織にのみ表示されます（[Credits 課金制度](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits.md)を参照してください）。
* ロールごとに、メンバーが承認済みの Agent の使用量だけを確認できるように制限できます。[承認済み Agent の使用量だけを表示する](#scope-to-authorized-agents)を参照してください。

## 承認済み Agent の使用量だけを表示する <a href="#scope-to-authorized-agents" id="scope-to-authorized-agents"></a>

使用量統計権限を持つロールでは、さらに<mark style="color:blue;">使用量統計の範囲</mark>を設定して、メンバーがこのページで閲覧できる範囲を指定できます。

| 選択肢                                           | メンバーに表示されるデータ                                                                                                                                                              |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">組織全体</mark>（デフォルト）  | 組織全体の使用量                                                                                                                                                                   |
| <mark style="color:blue;">承認済みアシスタントのみ</mark> | メンバーの所属ロールに割り当てられた Agent が生成した使用量のみ（Agent の割り当て方法は[AI アシスタントの割り当て](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-permission.md#assign-chatbots)を参照してください） |

例えば、カスタマーサポート部門の Agent 管理者が、担当する部門の 3 つの Agent の使用量を追跡する必要がある一方で、組織としては他部門の数値を見せたくない場合です。管理者がこのメンバーの所属ロールの使用量統計の範囲を<mark style="color:blue;">承認済みアシスタントのみ</mark>に変更すると、使用量統計を開いた際に、承認範囲内のデータのみを表示していることがページ上部に通知されます。<mark style="color:blue;">AI アシスタント</mark>や<mark style="color:blue;">メンバー</mark>などのタブでも、この 3 つの Agent の使用量だけが集計されます。

### 設定手順 <a href="#scope-setup" id="scope-setup"></a>

1. 左側のメニューから<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概要</mark>を選択し、<mark style="color:blue;">管理操作</mark>セクションで<mark style="color:blue;">ロール権限の編集</mark>をクリックします。
2. ロール一覧で設定するロールの<mark style="color:blue;">編集</mark>をクリックし、<mark style="color:blue;">ロール権限</mark>タブを開きます。
3. <mark style="color:blue;">組織権限</mark>の<mark style="color:blue;">使用量統計権限</mark>にチェックを入れます。権限一覧の下に<mark style="color:blue;">使用量統計の範囲</mark>が表示されます。
4. <mark style="color:blue;">承認済みアシスタントのみ</mark>を選択し、<mark style="color:blue;">保存</mark>をクリックします。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9c959d9448d4149fb0b42d5a39b73a5a411e9886%2Fusage-statistics-role-scope-setting.png?alt=media" alt="ロール権限タブ下部の使用量統計の範囲設定で、承認済みアシスタントのみを選択した状態"><figcaption><p>使用量統計権限にチェックを入れてから、ロール権限タブ下部で使用量統計の範囲を設定します</p></figcaption></figure>

<mark style="color:blue;">使用量統計権限</mark>のチェックを外すと、この設定も非表示になります。オーナーは常に組織全体を閲覧でき、オーナーロールにはこの設定はありません。

### メンバーに実際に表示される範囲 <a href="#scope-resolution" id="scope-resolution"></a>

* **組織全体を閲覧できるロールが 1 つでもあれば、組織全体が表示されます**：メンバーの所属ロールのうち、使用量統計権限を持ち、範囲が<mark style="color:blue;">組織全体</mark>のロールが 1 つでもあれば、そのメンバーには組織全体が表示されます。使用量統計権限を付与するすべてのロールを<mark style="color:blue;">承認済みアシスタントのみ</mark>に設定した場合に限り、承認済み Agent のみが表示されます。
* **承認済み Agent はすべてのロールを合わせた範囲です**：「所属ロールで承認された Agent」とは、デフォルトロールを含むメンバーのすべてのロールに、<mark style="color:blue;">AI アシスタントの割り当て</mark>で割り当てられた Agent を合わせたものです。メンバーに MaiGPT の利用権限がある場合は、MaiGPT の使用量も範囲に含まれます。

{% hint style="warning" %}
**デフォルトロールに注意してください**

* すべてのメンバーがデフォルトロールを持つため、デフォルトロールに割り当てられた Agent は全員の承認範囲に含まれます。デフォルトロールで多くの Agent を利用できる場合、<mark style="color:blue;">承認済みアシスタントのみ</mark>に設定しても、範囲を狭められる程度は限られます。
* デフォルトロールでも<mark style="color:blue;">使用量統計権限</mark>にチェックが入り、範囲が<mark style="color:blue;">組織全体</mark>のままであれば、すべてのメンバーに組織全体が表示されます。他のロールを<mark style="color:blue;">承認済みアシスタントのみ</mark>に設定しても効果はありません。
  {% endhint %}

### 範囲を制限した後の画面 <a href="#scoped-view" id="scoped-view"></a>

* <mark style="color:blue;">使用量の概要</mark>の上に、「ロールの使用量統計の範囲は『承認済みアシスタントのみ』です。現在、所属ロールがアクセスできる AI アシスタントの使用量データのみを表示しています。」という通知が表示されます。
* 使用量の概要、各タブ、<mark style="color:blue;">Excel にエクスポート</mark>は、承認済み Agent の使用量のみを集計します。ナレッジベースのストレージに対する日次課金など、いずれの Agent にも属さない消費は表示されません。
* <mark style="color:blue;">Credit 消費量</mark>カードの<mark style="color:blue;">残高</mark>は、引き続き組織ウォレットの残高です。<mark style="color:blue;">推定残り日数</mark>は「-」と表示されます。一部の Agent の消費だけでは、組織の残高をあと何日使えるか推定できないためです。

## アクセス方法 <a href="#how-to-enter" id="how-to-enter"></a>

左側のメニューから<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">使用量統計</mark>を選択します。

## フィルター条件 <a href="#filters" id="filters"></a>

ページ最上部のフィルターバーは、ページ全体に適用されます。

| フィルター  | 選択肢                                                                                                                                                                                                                      |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 時間の粒度  | <mark style="color:blue;">時間別</mark>、<mark style="color:blue;">日別</mark>（デフォルト）、<mark style="color:blue;">月別</mark>です。グラフの横軸の間隔を指定します                                                                                    |
| 日付範囲   | デフォルトは直近 30 日間です                                                                                                                                                                                                         |
| 指標     | <mark style="color:blue;">Token</mark>、<mark style="color:blue;">文字数</mark>、<mark style="color:blue;">メッセージ</mark>、<mark style="color:blue;">会話</mark>、<mark style="color:blue;">Credits</mark>です。グラフとランキングで集計する数値を指定します |
| タイムゾーン | <mark style="color:blue;">ローカルタイムゾーン</mark>、<mark style="color:blue;">UTC タイムゾーン</mark>です。グラフの時間軸の表示にのみ影響します                                                                                                             |

<mark style="color:blue;">フィルターをリセット</mark>をクリックすると、デフォルトに戻ります。<mark style="color:blue;">音声アシスタント</mark>タブに切り替えると、指標メニューは<mark style="color:blue;">STT 秒数</mark>、<mark style="color:blue;">TTS 文字数</mark>、<mark style="color:blue;">音声モデル Token 数</mark>、<mark style="color:blue;">Credits</mark>に変わります。

## 使用量の概要 <a href="#overview-cards" id="overview-cards"></a>

<mark style="color:blue;">使用量の概要</mark>では、選択した期間の合計をカードで表示します。

| カード                                                                                            | 内容                                                                                                                                                               |
| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">文字数</mark>                                                           | 入力、出力、合計の文字数です                                                                                                                                                   |
| TOKEN                                                                                          | 入力、出力、合計の Token 数です                                                                                                                                              |
| <mark style="color:blue;">メッセージ総数</mark>／<mark style="color:blue;">会話総数</mark>                 | 選択した期間のメッセージ数と会話数です                                                                                                                                              |
| <mark style="color:blue;">Credit 消費量</mark>（Credits 課金の組織）                                     | Credit 消費量、<mark style="color:blue;">キャッシュ節約</mark>、ウォレットの<mark style="color:blue;">残高</mark>、期間中の 1 日あたり平均消費量に基づく<mark style="color:blue;">推定残り日数</mark>です（参考値） |
| <mark style="color:blue;">STT / TTS 使用量</mark>、<mark style="color:blue;">音声モデル Token 総数</mark> | 2 行目に、音声通話の STT 合計秒数、TTS 合計文字数、音声モデル Token 数を表示します                                                                                                               |

<mark style="color:blue;">キャッシュ節約</mark>は、プラットフォームが自動的に有効にする Prompt キャッシュにより、選択した期間中に節約できた Credits の純額です。正の値、0、負の値になる場合があります。正の値は緑色、0 は通常の色、負の値は「-」付きの赤色で表示されます。負の値は、キャッシュ書き込みで追加負担した Credits が、キャッシュ読み取りで節約した Credits を上回ったことを意味します。どの Agent が節約し、どの Agent で追加コストが発生しているかは、[Agent ごとのキャッシュ節約](#chatbot-cache-savings)を参照してください。キャッシュの仕組みは [Prompt Cache の使用量](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits.md#prompt-cache-usage)を参照してください。

## 各タブ <a href="#tabs" id="tabs"></a>

| タブ                                            | 内容                                                                                                                                                                  |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">傾向</mark>           | 選択した指標の<mark style="color:blue;">使用量の推移</mark>として、各時点の使用量と累積使用量を表示します                                                                                               |
| <mark style="color:blue;">AI アシスタント</mark>    | Agent 別の集計です。Credits 課金の組織では、表に<mark style="color:blue;">キャッシュ節約</mark>列も表示されます。[Agent ごとのキャッシュ節約](#chatbot-cache-savings)を参照してください                                 |
| <mark style="color:blue;">ロール</mark>          | ロール別の集計です。計算方法は[ロールタブの計算方法](#role-tab-aggregation)を参照してください                                                                                                         |
| <mark style="color:blue;">メンバー</mark>         | メンバー別の集計で、<mark style="color:blue;">メンバー名</mark>と<mark style="color:blue;">メンバー Email</mark>を含みます。各ユーザーがどれだけ使用したかを確認できます                                            |
| <mark style="color:blue;">チャットプラットフォーム</mark> | チャットプラットフォーム別の集計です。<mark style="color:blue;">種類</mark>列で、Web、内部、API などの送信元を区別します                                                                                    |
| <mark style="color:blue;">連絡先</mark>          | 連絡先別の集計で、各行は「連絡先 × Agent」です。外部訪問者の使用量を確認できます                                                                                                                        |
| <mark style="color:blue;">音声アシスタント</mark>     | 音声通話の STT 秒数、音声モデル Token、TTS 文字数、<mark style="color:blue;">音声会話回数</mark>を Agent 別に集計します                                                                             |
| <mark style="color:blue;">課金カテゴリ</mark>       | 指標を<mark style="color:blue;">Credits</mark>に切り替えると表示されます。AI テキスト生成・理解モデル、ナレッジベース・ベクトル検索システムなどの課金カテゴリ別に Credit 消費量を一覧表示します。展開すると、プロバイダー別・モデル別の消費量と、メンバー別の消費明細を確認できます |

<mark style="color:blue;">傾向</mark>と<mark style="color:blue;">課金カテゴリ</mark>を除き、各タブには 3 つのグラフ（時系列、<mark style="color:blue;">Top 10 ランキング</mark>、<mark style="color:blue;">使用割合</mark>）と明細表があります。明細表の上で ID または名前で検索できます。<mark style="color:blue;">Excel にエクスポート</mark>をクリックすると、現在のタブ、日付範囲、検索条件に基づいてデータをダウンロードできます。

{% hint style="info" %}
使用量はメッセージ処理の完了後にバックグラウンドジョブで累計されるため、最新の会話が統計に表示されるまで少し時間がかかる場合があります。<mark style="color:blue;">課金カテゴリ</mark>の数値は定期的な事前集計に基づくため、非同期の引き落としや小数の四捨五入により、リアルタイムの請求額と多少異なる場合があります。
{% endhint %}

## 連絡先の使用量をエクスポートする <a href="#export-contact-usage" id="export-contact-usage"></a>

カスタマーサポートの責任者が、連絡先の使用量を社内データと照合する場合を考えます。<mark style="color:blue;">連絡先</mark>タブで日付範囲を選択して Excel にエクスポートし、ファイル内の<mark style="color:blue;">連絡先 Source ID</mark>とカスタム属性列で送信元を識別して、各連絡先の使用量を整理できます。レポートを結合するために連絡先データを別途調べる必要はありません。

### レポートのダウンロード <a href="#download-contact-report" id="download-contact-report"></a>

1. <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">使用量統計</mark>を開き、日付範囲を選択します。
2. <mark style="color:blue;">連絡先</mark>タブに切り替えます。必要に応じて、検索ボックスに連絡先 ID または名前を入力します。
3. <mark style="color:blue;">Excel にエクスポート</mark>をクリックします。Credits の使用量を確認する場合は、先に指標を<mark style="color:blue;">Credits</mark>に切り替えてからエクスポートします。
4. ダウンロードした Excel を開き、既存の使用量列の後ろにある<mark style="color:blue;">連絡先 Source ID</mark>と各カスタム属性列を確認します。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9e31484057ef02f9c4bb648f5d1a37d1a5f5397c%2Fusage-statistics-contact-export-toolbar.png?alt=media" alt="連絡先明細表の上にある連絡先 ID または名前の検索ボックスと Excel にエクスポートボタン"><figcaption><p>連絡先タブで検索し、「Excel にエクスポート」をクリックしてレポートをダウンロードします</p></figcaption></figure>

### 追加された列の見方 <a href="#contact-export-profile-columns" id="contact-export-profile-columns"></a>

* **連絡先 Source ID**：送信元システムにおける連絡先の識別値です。MaiAgent の「連絡先 ID」とは異なり、未設定の場合は空欄になります。
* **連絡先 ＜属性名＞**：連絡先のカスタム属性（Metadata）です。属性ごとに 1 列を使用し、例えば「連絡先 access\_environment」と表示されます。今回のエクスポート結果に含まれる全連絡先の属性の和集合から列を作り、表示名順に並べます。ある連絡先に該当属性がない場合、そのセルは空欄になります。
* チャット前フォームのカスタム属性は、フォームのフィールド名を優先して表示します。対応する名前が見つからない場合のみ、元の属性名を表示します。氏名、Email、電話などの標準連絡先フィールドに対応するフォーム項目は、カスタム属性列として重複表示されません。
* 異なる属性の表示列名が同じ場合は、「(Metadata)」という接尾辞を付けて区別し、それぞれの値を保持します。

例えば、エクスポートするすべての連絡先に「access\_environment」属性があり、一部の連絡先だけに「department」属性がある場合、レポートには「連絡先 access\_environment」と「連絡先 department」の 2 列が含まれます。部門データのない連絡先では、「連絡先 department」のセルが空欄になります。同じ連絡先に異なる Agent ごとの使用量行がある場合、各行にその連絡先の Source ID と属性が含まれます。

{% hint style="info" %}
これらの列は、通常の使用量と Credits の両方の連絡先エクスポートファイルに追加されます。画面上の連絡先明細表に列が追加されるわけではありません。エクスポート結果の連絡先にカスタム属性が一切ない場合、カスタム属性列は表示されません。
{% endhint %}

## 列の定義 <a href="#column-definitions" id="column-definitions"></a>

| 列                                                                                                                             | 定義                                                                                                                                                                                     |
| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">入力文字数</mark>／<mark style="color:blue;">出力文字数</mark>／<mark style="color:blue;">合計文字数</mark>          | メッセージ内容の文字数です。ユーザーが送信したメッセージは入力、Agent の返信は出力に計上します                                                                                                                                     |
| <mark style="color:blue;">入力 Token</mark>／<mark style="color:blue;">出力 Token</mark>／<mark style="color:blue;">合計 Token</mark> | モデルが処理した Token 数です。合計 Token＝入力＋出力で、キャッシュは含みません                                                                                                                                         |
| <mark style="color:blue;">キャッシュ書き込み</mark>／<mark style="color:blue;">キャッシュ読み取り</mark>                                         | Prompt キャッシュに書き込んだ Token 数と、キャッシュから読み取った Token 数です                                                                                                                                     |
| <mark style="color:blue;">キャッシュヒット率</mark>                                                                                    | キャッシュ読み取り ÷（入力 Token＋キャッシュ書き込み＋キャッシュ読み取り）です                                                                                                                                            |
| <mark style="color:blue;">メッセージ数</mark>                                                                                       | メッセージ 1 件につき 1 回を計上します。ユーザーのメッセージと Agent の返信の両方を含みます                                                                                                                                   |
| <mark style="color:blue;">会話数</mark>                                                                                          | 新しい会話の最初のメッセージが発生した時点で 1 回を計上します                                                                                                                                                       |
| Credits                                                                                                                       | 選択した期間の Credit 消費量です                                                                                                                                                                   |
| <mark style="color:blue;">取引回数</mark>                                                                                         | Credit 引き落としの件数です。1 回の会話で複数の引き落としが発生する場合があります。例えば、モデル使用量、キャッシュ、ツール呼び出しはそれぞれ個別に課金されます                                                                                                   |
| <mark style="color:blue;">キャッシュ節約</mark>                                                                                      | Credits 課金の組織の<mark style="color:blue;">AI アシスタント</mark>タブにのみ表示されます。この Agent が選択した期間に Prompt キャッシュで節約した Credits の純額で、負の値になる場合もあります。[Agent ごとのキャッシュ節約](#chatbot-cache-savings)を参照してください |

指標で<mark style="color:blue;">Token</mark>を選択すると、ランキンググラフと割合グラフにはキャッシュ書き込みとキャッシュ読み取りも含まれます。そのため、表の<mark style="color:blue;">合計 Token</mark>より大きくなる場合があります。

各タブ上部の総数（メンバータブの<mark style="color:blue;">メンバー数</mark>、Agent タブの Agent 数など、API レスポンスでは `totalMembers`、`totalChatbots`）は、**選択した期間内に使用量の記録がある対象の数**（重複排除）です。組織の現在のメンバー数や Agent 総数ではありません。例えば「今週何人が質問したか」を確認するには、期間を今週に設定してメンバータブのメンバー数を確認します。期間は、選択した日付の各日全体を対象にします。

## Agent ごとのキャッシュ節約 <a href="#chatbot-cache-savings" id="chatbot-cache-savings"></a>

Credits 課金の組織では、<mark style="color:blue;">AI アシスタント</mark>タブの明細表に、<mark style="color:blue;">Credits</mark>、<mark style="color:blue;">取引回数</mark>に続いて<mark style="color:blue;">キャッシュ節約</mark>列が表示されます。各 Agent が選択した期間に Prompt キャッシュで節約した Credits の純額を示します。上部の<mark style="color:blue;">Credit 消費量</mark>カードでは組織全体の合計しか確認できませんが、この列ではどの Agent が節約し、どの Agent に追加コストが発生しているかを確認できます。

例えば、組織管理者が 10 月 19 日の<mark style="color:blue;">キャッシュ節約</mark>の合計 771.718 を見て、全体の節約を減らしている Agent がないか確認したい場合です。日付範囲を 2026/10/19 に設定し、<mark style="color:blue;">AI アシスタント</mark>タブに切り替えて、明細表を右へスクロールし、<mark style="color:blue;">キャッシュ節約</mark>列を表示します。ある Agent は 779.89 を節約しています。別の Agent は<mark style="color:blue;">キャッシュ書き込み</mark>と<mark style="color:blue;">キャッシュ読み取り</mark>がともに 0 のため、キャッシュ節約も 0 です。もう 1 つの Agent は赤色の -8.17 で、<mark style="color:blue;">キャッシュ書き込み</mark>が 4,128 Token、<mark style="color:blue;">キャッシュ読み取り</mark>が 0 です。つまり、その日にキャッシュへ書き込んだ内容が後続のリクエストで一度も読み取られていません。3 行の合計は 771.72 で、上部カードの 771.718 との差は表示する小数桁数だけです。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-edc17f7c2e0725c74c351f3e0cde98e041c929a7%2Fusage-statistics-cache-saved-overview.png?alt=media" alt="日付範囲を 2026/10/19 に設定した使用量の概要。Credit 消費量カードのキャッシュ節約は 771.718 と表示されています"><figcaption><p>使用量の概要：Credit 消費量カードのキャッシュ節約は、選択した期間の組織全体の合計です</p></figcaption></figure>

### 確認手順 <a href="#chatbot-cache-savings-steps" id="chatbot-cache-savings-steps"></a>

1. 左側のメニューから<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">使用量統計</mark>を選択し、フィルターバーで日付範囲を設定します。
2. <mark style="color:blue;">AI アシスタント</mark>タブに切り替え、下部の明細表までスクロールします。
3. 明細表は列が多いため、右へスクロールして最後の<mark style="color:blue;">キャッシュ節約</mark>列を表示します。列名の横にある説明アイコンにマウスを合わせると、数値の説明を確認できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-ed7e1e3ceb59c3799c043ceb23f566df988499b0%2Fusage-statistics-chatbot-cache-saved-column.png?alt=media" alt="AI アシスタント明細表の右側にあるキャッシュ書き込み、キャッシュ読み取り、キャッシュヒット率、メッセージ数、会話数、Credits、取引回数、キャッシュ節約の各列。1 行目のキャッシュ節約は緑色の 779.89、2 行目はキャッシュ書き込みと読み取りがともに 0 で節約も 0、3 行目は書き込み 4,128、読み取り 0、節約は赤色の -8.17 です"><figcaption><p>AI アシスタント明細表のキャッシュ節約列：3 行目はキャッシュ書き込みのみで読み取りがなく、キャッシュ節約が負の値になっています</p></figcaption></figure>

この列は上部の<mark style="color:blue;">指標</mark>メニューの影響を受けず、<mark style="color:blue;">Token</mark>を選択しても表示されます。ただし、列名をクリックして並べ替えることはできず、<mark style="color:blue;">Excel にエクスポート</mark>にもこの列は含まれません。

### 数値の見方 <a href="#chatbot-cache-savings-values" id="chatbot-cache-savings-values"></a>

| 表示            | 意味                                                                      |
| ------------- | ----------------------------------------------------------------------- |
| 緑色の正の値        | キャッシュ読み取りで節約した Credits が書き込みによる追加負担を上回っており、この Agent はキャッシュでコストを節約しています  |
| 赤色の負の値（「-」付き） | キャッシュ書き込みによる追加の Credits 負担が、読み取りで節約した Credits を上回っています                  |
| 0（通常の色）       | 純額が 0 です。選択した期間にこの Agent のキャッシュ使用量がない場合や、小数第 2 位までに四捨五入すると 0 になる場合を含みます |
| —             | この Agent のキャッシュ節約データを取得できていません。実際の 0 とは異なります                            |

キャッシュ節約は、各キャッシュ処理の Token 数に「同じモデルの通常入力単価」から「キャッシュ単価」を引いた差額を掛け、その結果を合計して求めます。キャッシュ読み取りの単価は通常入力より低いため、読み取りのたびに節約できます。一方、キャッシュ書き込みの単価は通常入力より高い場合があります。書き込んだ内容がその後十分な回数読み取られないと、追加負担を相殺できず、合計が負の値になります。キャッシュの課金方法は [Prompt Cache の使用量](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits.md#prompt-cache-usage)を参照してください。

### 組織全体の合計との差 <a href="#chatbot-cache-savings-vs-total" id="chatbot-cache-savings-vs-total"></a>

各行と<mark style="color:blue;">Credit 消費量</mark>カードの<mark style="color:blue;">キャッシュ節約</mark>は同じ計算方法を使いますが、集計範囲が異なるため、表の各行の合計がカードの合計と一致するとは限りません。

* **削除済みの Agent**：明細表には表示されませんが、選択した期間のキャッシュ節約はカードの合計に含まれます。
* **使用量統計の範囲**：ロールが<mark style="color:blue;">承認済みアシスタントのみ</mark>に設定されたメンバーの場合、表とカードの両方で、アクセスできる Agent のみを集計します（[承認済み Agent の使用量だけを表示する](#scope-to-authorized-agents)を参照してください）。
* **表示精度**：表は小数第 2 位まで表示します。カードでは 1,000 以上を K、M で省略表示し（例：1,949.03 は 1.9K）、1,000 未満では最大で小数第 3 位まで表示します（例：771.718）。

## ロールタブの計算方法 <a href="#role-tab-aggregation" id="role-tab-aggregation"></a>

ロールの使用量は、**そのロールに現在所属する全メンバーの個人使用量の合計**です。「そのロールを通じて生成された使用量」ではありません。

* メンバーが複数のロールに所属している場合、その使用量は各ロールに全額計上されます。例えば、あるメンバーが 3 つのロールに所属し、期間中に使用量があるのがそのメンバーだけであれば、3 つのロールにはまったく同じ数値が表示されます。
* このため、各ロールの数値を合計すると、組織の実際の合計使用量を超える場合があります。
* クエリ実行時点のロール所属メンバーに基づいて計算します。メンバーがロールに参加する前の使用量もそのロールに含まれ、ロールから離れた後は、そのメンバーの使用量は含まれなくなります。

## 「不明」の意味 <a href="#unknown-bucket" id="unknown-bucket"></a>

指標を<mark style="color:blue;">Credits</mark>に切り替えると、<mark style="color:blue;">メンバー</mark>、<mark style="color:blue;">チャットプラットフォーム</mark>などのタブのランキンググラフや割合グラフに「不明」が表示される場合があります。これは、該当する Credit 消費量を特定のメンバーに帰属させられないことを意味します。<mark style="color:blue;">チャットプラットフォーム</mark>タブでは、ナレッジベースのストレージなど、いずれのチャットプラットフォームにも属さない消費を意味します。<mark style="color:blue;">メンバー</mark>タブで「不明」となる主な要因は次のとおりです。

| 要因              | 説明                                                                  | 明細の確認先                                    |
| --------------- | ------------------------------------------------------------------- | ----------------------------------------- |
| 外部訪問者           | Web Chat や LINE などのチャットプラットフォームを通じて Agent と会話する、組織メンバーではない訪問者です     | <mark style="color:blue;">連絡先</mark>タブ    |
| 無効化または削除されたメンバー | 消費が発生した時点で、対応するメンバーが組織の有効なメンバーではなくなっていた場合です                         | —                                         |
| システム課金          | ナレッジベースのストレージに対する日次課金や、開始したメンバーを特定できない自動処理など、特定のメンバーが起動したものではない課金です | <mark style="color:blue;">課金カテゴリ</mark>タブ |

## 割り当て上限ページと数値が異なる理由 <a href="#why-differs-from-quota" id="why-differs-from-quota"></a>

<mark style="color:blue;">Credits</mark>ページの<mark style="color:blue;">割り当て上限の配分</mark>と、メンバーアカウントページの<mark style="color:blue;">Credit 上限</mark>では、「使用量」が「使用済み／上限」で表示されます。例えば `7,000.00 / 10,000.00` は、その割り当てで 7,000 Credits を使用済みで、上限が 10,000 Credits であることを意味します。使用量統計の数値と一致しないことが多いのは、次の理由によります。

| 相違点     | 使用量統計                              | 割り当て上限                                                                                                                                                                   |
| ------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 計算期間    | フィルターバーで選択した日付範囲です（デフォルトは直近 30 日間） | その割り当ての適用開始時、または前回のリセット以降の累計です                                                                                                                                           |
| 集計範囲    | そのメンバーに帰属するすべての使用量です               | 割り当ての[適用範囲](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits/member-credit-quota.md#applicable-scope)内の消費のみです                                              |
| ロール     | 現在のロール所属メンバーについて、期間内の全使用量を合計します    | 消費が発生した時点でメンバーが所属する各管理対象ロールに計上し、ロール上限の適用開始後からのみ累計します（[ロール上限](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits/member-credit-quota.md#role-quota)を参照してください） |
| 更新タイミング | バックグラウンドで累計し、課金カテゴリは定期的に事前集計します    | 引き落としのたびに累計します                                                                                                                                                           |

個別の引き落としを照合するには、<mark style="color:blue;">Credits</mark> → <mark style="color:blue;">消費履歴</mark>に移動してください（[Credits 管理パネル](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits.md#consumption-tab)を参照してください）。

## よくある質問 <a href="#faq" id="faq"></a>

#### Q：<mark style="color:blue;">課金カテゴリ</mark>タブが見つかりません。 <a href="#faq-credit-categories-missing" id="faq-credit-categories-missing"></a>

指標を<mark style="color:blue;">Credits</mark>に切り替えると、タブが表示されます。このタブを開いている間、指標メニューは Credits に固定されます。指標メニューに Credits がない場合、その組織は Credits 課金ではありません。

#### Q：複数のロールで数値がまったく同じです。集計に誤りがありますか？ <a href="#faq-identical-roles" id="faq-identical-roles"></a>

通常は誤りではありません。同じメンバーが複数のロールに所属している場合、その使用量は各ロールに全額計上されます。期間中に使用量があるのがそのメンバーだけであれば、それらのロールには同じ数値が表示されます。詳しくは[ロールタブの計算方法](#role-tab-aggregation)を参照してください。

#### Q：メンバーごとの使用量レポートはどのように作成しますか？ <a href="#faq-member-report" id="faq-member-report"></a>

<mark style="color:blue;">メンバー</mark>タブに切り替え、日付範囲を設定してから<mark style="color:blue;">Excel にエクスポート</mark>をクリックします。Credits を確認する場合は、指標を<mark style="color:blue;">Credits</mark>に切り替えてからエクスポートしてください。

#### Q：外部訪問者の使用量はどこに計上されますか？ <a href="#faq-visitor-usage" id="faq-visitor-usage"></a>

外部訪問者は組織メンバーではないため、<mark style="color:blue;">メンバー</mark>タブの表には表示されません。<mark style="color:blue;">連絡先</mark>または<mark style="color:blue;">チャットプラットフォーム</mark>タブで確認してください。Credits でメンバーのランキングを表示する場合、この使用量は「不明」に含まれます。

#### Q：Agent 管理者が自分の担当する Agent の使用量だけを確認するにはどうすればよいですか？ <a href="#faq-own-agents-only" id="faq-own-agents-only"></a>

その管理者が所属するロールの<mark style="color:blue;">使用量統計の範囲</mark>を<mark style="color:blue;">承認済みアシスタントのみ</mark>に設定し、<mark style="color:blue;">AI アシスタントの割り当て</mark>では担当する Agent だけを割り当てます。設定手順は[承認済み Agent の使用量だけを表示する](#scope-setup)を参照してください。

#### Q：ロールを「承認済みアシスタントのみ」に設定しても、メンバーに組織全体が表示されます。 <a href="#faq-scope-still-organization" id="faq-scope-still-organization"></a>

そのメンバーの他のロール（デフォルトロールを含みます）を確認してください。<mark style="color:blue;">使用量統計の権限</mark>を持ち、範囲が<mark style="color:blue;">組織全体</mark>になっているロールが 1 つでもあれば、そのメンバーには組織全体が表示されます。また、オーナーには常に組織全体が表示されます。詳しくは[メンバーに実際に表示される範囲](#scope-resolution)を参照してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/others/usage-statistics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
