> 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/build/agent/usage.md).

# Agent の利用分析

バックエンドの監視データを確認し、ユーザーの利用状況を把握できます。

## 確認方法 <a href="#how-to-view" id="how-to-view"></a>

左側のメニューから<mark style="color:blue;">AI 機能</mark> → <mark style="color:blue;">AI アシスタント</mark>に進み、確認したい Agent をクリックして設定ページを開きます。上部の<mark style="color:blue;">利用分析</mark>タブに切り替えてください。このページには 2 つのサブタブがあります。

| サブタブ                                  | 内容                                                                                                                                                                                                                                                            | 閲覧できるメンバー                                                                        |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| <mark style="color:blue;">監視指標</mark> | AgentOps の<mark style="color:blue;">AI アシスタント監視</mark>ダッシュボードと同じ指標とグラフ（会話数、応答時間、エラー率、ストリーミング性能、回答品質スコアなど）を、この Agent に限定して表示します。グラフの説明は[ダッシュボードのグラフ](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent-ops/evaluations.md#dashboard-charts)を参照してください | ロールに<mark style="color:blue;">AI アシスタント監視権限</mark>があるメンバーです。権限がない場合は利用統計のみ表示されます |
| <mark style="color:blue;">利用統計</mark> | この Agent の会話量とトークン使用量です（このページの以降で説明します）                                                                                                                                                                                                                       | この Agent を閲覧できるメンバーです                                                            |

<mark style="color:blue;">利用統計</mark>には、次のグラフがあります。

* <mark style="color:blue;">トークン使用量</mark>：この Agent が使用する LLM モデルごとに 1 本の線と、<mark style="color:blue;">合計トークン使用量</mark>の線を表示し、LLM の実際の消費量を示します。[Credits 課金制度](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits.md)と照らし合わせてコストを見積もれます
* <mark style="color:blue;">会話文字数</mark>：同様に LLM モデルごとに 1 本の線と、<mark style="color:blue;">合計会話文字数</mark>の線を表示します
* 会話回数
* メッセージ数
* 会話あたりの平均メッセージ数
* ユーザー満足度

グラフ上部で期間（今日、昨日、今週、先週、今月、先月、過去 7 日間、過去 30 日間、今四半期、前四半期、今年、昨年、またはカスタム期間）を選択し、集計単位を<mark style="color:blue;">時間</mark>、<mark style="color:blue;">日</mark>、<mark style="color:blue;">月</mark>に切り替えられます。

これらの指標から、Agent の利用状況を多角的に把握できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-365a7f2570428c98ef11ea2ae079c88048511794%2Fagent-usage-token-per-model.png?alt=media" alt="利用統計タブのトークン使用量と会話文字数のグラフ。トークン使用量グラフにマウスを合わせると、各モデルと合計トークン使用量の値が表示されます"><figcaption><p>トークン使用量と会話文字数のグラフ：モデルごとに 1 本の線と、合計の線を表示します</p></figcaption></figure>

### モデル別にトークン使用量を確認する <a href="#token-usage-by-model" id="token-usage-by-model"></a>

<mark style="color:blue;">トークン使用量</mark>グラフの各モデルの線は、そのモデルの合計トークン数（入力、出力、Prompt Cache の合計）を示します。<mark style="color:blue;">合計トークン使用量</mark>は、すべてのモデルを合計した値です。グラフには凡例がありません。任意の日付にマウスを合わせると、その日の各モデル（「モデル名 | プロバイダー」の形式）と合計の値が表示されます。

{% hint style="info" %}

* 選択期間内にトークンのみがあり、文字数がないモデル（画像やファイルの解析に使用するモデルなど）は、<mark style="color:blue;">トークン使用量</mark>グラフのみに表示されます。<mark style="color:blue;">会話文字数</mark>グラフに 0 の線は描画されません。逆の場合も同様です。合計の線は常に表示され、使用量がない場合は 0 の位置に表示されます。
* 集計単位が<mark style="color:blue;">時間</mark>の場合、<mark style="color:blue;">トークン使用量</mark>と<mark style="color:blue;">会話文字数</mark>のグラフは表示されません。<mark style="color:blue;">日</mark>または<mark style="color:blue;">月</mark>に切り替えてください。
  {% endhint %}

**利用例**：カスタマーサポートの責任者が、「注文照会アシスタント」で別のモデルを試した後、各モデルが消費したトークン数を確認したいと考えています。この Agent の<mark style="color:blue;">利用分析</mark> → <mark style="color:blue;">利用統計</mark>を開き、期間に過去 7 日間、集計単位に<mark style="color:blue;">日</mark>を選択します。<mark style="color:blue;">トークン使用量</mark>グラフのテスト実施日にマウスを合わせると、2 つのモデルそれぞれのトークン数と<mark style="color:blue;">合計トークン使用量</mark>を確認できます。組織の使用量統計ページで別途絞り込む必要はありません。

## 統計データの詳細 <a href="#statistics-details" id="statistics-details"></a>

### 1. 会話文字数 (Words Count) <a href="#words-count" id="words-count"></a>

**計算方法：**

* **テキスト文字数**：メッセージ内容の文字数を数えます
* **画像コスト**：画像ごとに、設定された画像の文字数コストで計算します
* **合計文字数** = メッセージ内容の文字数 + (画像数 × 画像の文字数コスト)

**集計範囲：** ユーザーの入力メッセージと Agent の返信メッセージを含み、日単位・月単位の集計に対応しています

***

### 2. 会話回数 (Conversations Count) <a href="#conversations-count" id="conversations-count"></a>

**計算方法：**

* 新しい会話が作成されるたびに、カウンターが 1 増えます
* 会話の最初のメッセージが作成されると、会話統計の更新が行われます

**更新タイミング：** ユーザーが新しい会話を開始したとき（最初のメッセージ）です

{% hint style="info" %}
ここの「会話回数」と、AgentOps の「AI アシスタント監視」ダッシュボードの「会話数」は定義が異なります。ここでは 1 つの会話を 1 回と数えますが、ダッシュボードの「会話数」は Agent の返信回数であり、同じ会話でも返信した回数分を数えます。詳しくは[自動評価と Agent 監視](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent-ops/evaluations.md#conversation-count-definition)を参照してください。
{% endhint %}

**集計範囲：** 時間単位・日単位・月単位の集計に対応しています

***

### 3. メッセージ数 (Messages Count) <a href="#messages-count" id="messages-count"></a>

**計算方法：**

* 新しいメッセージが作成されるたびに、カウンターが 1 増えます
* ユーザーの入力メッセージと Agent の返信メッセージを含みます

**更新タイミング：** メッセージが作成されるたびに統計が更新されます

**集計範囲：** 時間単位・日単位・月単位の集計に対応しています

***

### 4. 会話あたりの平均メッセージ数 (Average Messages per Conversation) <a href="#average-messages-per-conversation" id="average-messages-per-conversation"></a>

**計算式：**

```
会話あたりの平均メッセージ数 = メッセージ数 ÷ 会話回数（会話回数が 0 の場合は 0 を表示します）
```

**指標の意味：**

* 1 つの会話に平均で何件のメッセージが含まれるかを示します
* ユーザーと Agent のやり取りの深さを表します
* 値が高いほど、会話が深まり、やり取りが頻繁に行われていることを示します

**集計範囲：** 時間単位・日単位・月単位の集計に対応しています

***

### 5. ユーザー満足度 (User Satisfaction Rate) <a href="#user-satisfaction-rate" id="user-satisfaction-rate"></a>

**計算式：**

```
ユーザー満足度 = 高評価数 ÷ フィードバック総数（フィードバック総数が 0 の場合は 0 を表示します）
フィードバック総数 = 高評価数 + 低評価数
```

**指標の意味：**

* 肯定的なフィードバックの割合（高評価率）を示します
* 値の範囲は 0% \~ 100% です
* 値が高いほど、ユーザーが Agent の返信に満足していることを示します

**フィードバックの仕組み：**

* ユーザーは Agent の返信に「高評価」または「低評価」を付けられます
* 統計データはリアルタイムで更新されます

**更新タイミング：** ユーザーがフィードバックを行ったとき（作成・更新・削除）です

**高評価／低評価の数え方：**

* 各返信のフィードバックは最大 1 件として数えます。高評価を低評価に変更すると、高評価数が 1 減り、低評価数が 1 増えます。フィードバックを取り消すと、統計から差し引かれます
* フィードバックは、評価した時刻ではなく「評価対象の返信」が作成された時間帯に計上されます。たとえば、訪問者が前日の返信に翌日高評価を付けた場合、その高評価は前日に加算されます
* **Web Chat の開始メッセージへのフィードバックは集計しません**：開始メッセージは固定の文面であり、AI の回答ではありません。Web Chat の開始メッセージには<mark style="color:blue;">コピー</mark>ボタンのみがあり、高評価／低評価ボタンはありません。独自の API 連携や旧版の埋め込みスクリプトから開始メッセージへのフィードバックを送信した場合、そのメッセージに保存されますが、高評価数・低評価数・ユーザー満足度には含まれません

{% hint style="info" %}
**満足度に数値があるのに、会話履歴に高評価が見つからないのはなぜですか？** 以前は開始メッセージへの高評価／低評価も満足度に含まれていました。訪問者が Web Chat を開き、開始メッセージに高評価を付けてそのまま離れると、会話履歴に質問と回答がなくても満足度が 100% になっていました。現在は開始メッセージへのフィードバックを除外し、実際の返信に対する訪問者の評価のみを満足度に反映します。
{% endhint %}

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-6cda82815c0a1348a03c234ed46e428cbfaf7c75%2Fweb-chat-greeting-no-feedback.png?alt=media" alt="Web Chat の会話画面。開始メッセージの下にはコピーボタンのみがあり、Agent の回答の下にはコピー・高評価・低評価の 3 つのボタンがあります"><figcaption><p>開始メッセージの下はコピーボタンのみで、Agent の回答にのみ高評価／低評価ボタンがあります</p></figcaption></figure>

**利用例**：カスタマーサポートの責任者が、「注文照会アシスタント」のある日の満足度が 100% であることに気付き、開始メッセージへのフィードバックだけで算出された数値ではないか確認したいと考えています。この Agent の Web Chat を開くと、開始メッセージの下には<mark style="color:blue;">コピー</mark>のみがあり、Agent の回答の下にだけ高評価／低評価ボタンがあることを確認できます。次に、バックエンドの<mark style="color:blue;">利用分析</mark> → <mark style="color:blue;">利用統計</mark>に戻り、集計単位に<mark style="color:blue;">日</mark>を選択して、<mark style="color:blue;">ユーザー満足度</mark>グラフの該当日にマウスを合わせます。表示される割合は、訪問者が Agent の回答に付けた高評価／低評価のみから計算され、開始メッセージへのフィードバックは含まれていません。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-1f87e409d2ad280bd69755512a5afef091a268dd%2Fusage-satisfaction-chart.png?alt=media" alt="利用統計タブのユーザー満足度グラフ。2026-10-12 にマウスを合わせると、割合が 1 と表示されます"><figcaption><p>ユーザー満足度グラフ：日付にマウスを合わせると、その日の高評価率が表示されます</p></figcaption></figure>

**集計範囲：** 時間単位・日単位・月単位の集計に対応しています

***

## 統計データの更新の仕組み <a href="#statistics-update-mechanism" id="statistics-update-mechanism"></a>

**リアルタイム更新：** 関連するイベント（新規メッセージ、新規会話、フィードバックの変更）が発生すると、直ちに統計が更新されます

**対応する集計単位：**

* **時間単位**：リアルタイム監視に適しています
* **日単位**：日次レポートの分析に適しています
* **月単位**：月次レポートや傾向分析に適しています

## レポートのエクスポートや定期送信はできますか？ <a href="#export-and-reports" id="export-and-reports"></a>

利用分析のグラフは画面上でのみ確認できます。エクスポートボタンや、レポートを定期送信する設定はありません。プラットフォーム外にデータを持ち出す場合は、次のエクスポート対応ページを使用してください。

| 必要なデータ                             | エクスポート元                                                                                                                                                                                                                                                                                                                                 |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Agent・ロール・メンバー・チャネルごとの使用量と Credits | 使用量統計の各タブから<mark style="color:blue;">Excel をエクスポート</mark>できます。[使用量統計](https://docs.maiagent.ai/maiagent-user-guide/ja/others/usage-statistics.md)を参照してください                                                                                                                                                                              |
| 各質問と回答で使用したツールと、その実行の成功・失敗         | ツール実行履歴ページにはエクスポート機能がありません。<mark style="color:blue;">AgentOps</mark> → <mark style="color:blue;">AI アシスタント監視</mark>のテキスト会話履歴をツールで絞り込んでからエクスポートすると、Excel の<mark style="color:blue;">使用ツール（実行結果）</mark>列に表示されます。[使用ツールで会話履歴を絞り込む](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent-ops/evaluations.md#filter-by-tool)を参照してください |
| AI の質問・回答履歴                        | <mark style="color:blue;">AgentOps</mark> → <mark style="color:blue;">AI アシスタント監視</mark>で絞り込んで Excel にエクスポートするか、質問・回答履歴 API を使用して社内システムに定期的に同期できます。[会話の質問・回答履歴の取得](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/daily-operations/reply/conversation-viewer.md#export-conversation-history)を参照してください                            |

## 活用例：利用効果の評価 <a href="#use-case-effectiveness-evaluation" id="use-case-effectiveness-evaluation"></a>

ユーザー満足度とやり取りの回数の推移を観察することで、Agent の応答品質が期待どおりかを評価し、改善に役立てられます。


---

# 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/build/agent/usage.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.
