> 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/maiagent-user-guide-ja/org/usage.md).
# 利用分析
## 確認方法
左側の機能メニュー「AI アシスタント」内の「利用分析」に入ると、AI アシスタントの対話処理状況を示すダッシュボードを確認できます。
* 対話文字数
* 対話回数
* メッセージ回数
* 平均対話インタラクション回数
* ユーザー満足度
* 期間フィルター（日付・月・日・時間別）
これらの指標を通じて、さまざまな観点から AI アシスタントの利用状況を把握できます。
## 統計データの詳細説明
### 1. 対話文字数 (Words Count)
**計算方法：**
* **テキスト文字数**：メッセージ内容の文字数をカウントします
* **画像コスト**：画像 1 枚ごとに、設定された画像文字数コストに従って計算します
* **総文字数** = メッセージ内容の文字数 +（画像枚数 × 画像文字数コスト）
**集計範囲：** ユーザーが入力したメッセージと AI アシスタントが返信したメッセージを含み、日次・月次の時間粒度での集計に対応しています
***
### 2. 対話回数 (Conversations Count)
**計算方法：**
* 新しい対話が作成されるたびに、カウンターが +1 されます
* 対話内の最初のメッセージが作成されると、対話統計の更新がトリガーされます
**更新タイミング：** ユーザーが新しい対話を開始したとき（最初のメッセージ）
**集計範囲：** 時間・日次・月次の時間粒度での集計に対応しています
***
### 3. メッセージ回数 (Messages Count)
**計算方法：**
* 新しいメッセージが作成されるたびに、カウンターが +1 されます
* ユーザーが入力したメッセージと AI アシスタントが返信したメッセージを含みます
**更新タイミング：** メッセージが作成されるたびに統計更新がトリガーされます
**集計範囲：** 時間・日次・月次の時間粒度での集計に対応しています
***
### 4. 平均対話インタラクション回数 (Average Messages per Conversation)
**計算式：**
```
平均対話インタラクション回数 = メッセージ回数 ÷ 対話回数（対話回数が 0 の場合は 0 を表示）
```
**意味の説明：**
* 1 つの対話に平均で何件のメッセージが含まれるかを表します
* ユーザーと AI アシスタントのインタラクションの深さを反映します
* 数値が高いほど対話が深く、インタラクションが頻繁であることを示します
**集計範囲：** 時間・日次・月次の時間粒度での集計に対応しています
***
### 5. ユーザー満足度 (User Satisfaction Rate)
**計算式：**
```
ユーザー満足度 = 高評価数 ÷ 総フィードバック数（総フィードバック数が 0 の場合は 0 を表示）
総フィードバック数 = 高評価数 + 低評価数
```
**意味の説明：**
* ポジティブなフィードバックを得た割合（高評価率）を表します
* 数値範囲：0% ～ 100%
* 数値が高いほど、ユーザーが AI アシスタントの返信に満足していることを示します
**フィードバックの仕組み：**
* ユーザーは AI アシスタントの返信に対して「高評価」または「低評価」を付けられます
* 統計データのリアルタイム更新に対応しています
**更新タイミング：** ユーザーがフィードバックを行ったとき（作成・更新・削除）
**集計範囲：** 時間・日次・月次の時間粒度での集計に対応しています
***
## 統計データの更新の仕組み
**リアルタイム更新：** 関連するイベントが発生したとき（新規メッセージ、新規対話、フィードバックの変更）、即座に統計更新がトリガーされます
**時間粒度のサポート：**
* **時間単位**：リアルタイムのモニタリングに適しています
* **日単位**：日報分析に適しています
* **月単位**：月報やトレンド分析に適しています
## 活用シーン：利用成果の評価
「ユーザー満足度」とインタラクション回数の変化傾向を観察することで、AI アシスタントの応答品質が期待どおりかを評価でき、最適化の判断材料となります。
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/org/usage.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.