マイページ：利用分析
利用分析
画面: 利用分析
自分がオーナーのエージェントに寄せられた通報・フィードバック・コメント、共有からの流入、ナレッジ閲覧の状況をまとめて確認・改善できる画面です。「どのナレッジが効いているか」「利用者からどんな声が入っているか」を把握するのに使います。
ログイン必須・オーナー向け。 表示できるのは自分がオーナーのエージェントのデータのみです（メンバーは閲覧不可。ヘッダーメニューにリンクは出ますが、オーナーでないエージェントのデータは表示されません）。
画面の開き方
| 経路 | 操作 |
|---|---|
| ユーザーメニュー | 画面右上のアバター → 利用分析 ※新着があるとバッジ付き |
この画面を開くと、ヘッダーに表示されていた要対応バッジが既読化（0 に戻る）されます。
画面上部の絞り込み
| 操作 | 内容 |
|---|---|
| エージェント | 「すべてのエージェント」または自分がオーナーのエージェント 1 件に絞り込み |
| 期間 | 7 日 / 30 日 / 90 日（既定 30 日）。変更すると全カードが再取得される |
カードの並び順
画面には次の順でカードが並びます。
- 共有からの流入（折れ線グラフ）
- 通報
- フィードバック・未回答質問
- ナレッジ閲覧
共有からの流入
共有 QR やコピーリンク経由でチャットアプリまたはナレッジエディターが開かれた回数を日別の折れ線グラフで表示します。
| 系列 | 意味 |
|---|---|
| チャット QR | チャット共有 QR（?ref=qr）経由 |
| チャットリンク | チャット共有 URL コピー（?ref=link）経由 |
| ナレッジ QR | ナレッジエディター QR（?ref=qr）経由 |
| ナレッジリンク | ナレッジ共有リンク（?ref=link）経由 |
カード見出し右に選択期間の合計件数が表示されます。
流入のカウント条件（参考）
?ref=qrまたは?ref=linkが付いた URL でページが開かれたときに記録- 未ログインのアクセスもカウント
- 同一ブラウザセッションでは、同一エージェント × 流入先 × 経路につき 1 日 1 回まで（リロードのノイズ抑制）
- ボット UA（
bot/crawler等）や空 UA は記録しない
通報
利用者からの通報（不適切なチャット発言・ナレッジの問題）を一覧で確認できます。
- 行ホバー（PC）/ 左スワイプ（スマホ）で出る削除アイコンから不要な通報を削除できます。
フィードバック・未回答質問
利用者がチャットのエージェント発言に付けたフィードバック（品質評価）と、エージェントが答えられなかった未回答質問を同じテーブルで確認できます。
理由フィルタ
| フィルタ値 | 内容 |
|---|---|
| すべて | フィードバック＋未回答を合算 |
| 事実が違う | フィードバック理由: 事実誤り |
| 情報が足りない | フィードバック理由: 情報不足 |
| 質問と無関係 | フィードバック理由: 無関係 |
| 未回答 | エージェントが回答できなかった質問 |
行のアクション
| アクション | 内容 |
|---|---|
| 行クリック | 該当チャットの該当ターンへ遷移してハイライト |
| コピー | エージェントへ改善指示を渡すテキストをクリップボードにコピー |
| ナレッジ | フィードバック対象の出典ナレッジへ遷移 |
| レビュー済み | 出典ナレッジを確認済みにして行を消し込み（reviewed_at を更新） |
- 行ホバー（PC）/ 左スワイプ（スマホ）で出るアイコンから不要な行を削除できます。
ナレッジ閲覧
チャット引用・人閲覧・AI 参照の 3 チャネルと合計を 1 行で俯瞰できるカードです。既定の並びは合計閲覧の降順。
| 列 | 意味 |
|---|---|
| ナレッジタイトル | 対象ナレッジ（行クリックでエディターへ）。種類バッジが付く場合あり |
| エージェント名 | 所属エージェント |
| チャット引用: 候補 | LLM プロンプトの候補に載った回数（candidate_count） |
| チャット引用: 引用 | 回答の根拠として選ばれた回数（selected_count） |
| チャット引用: 採用率 | 引用数 ÷ 候補数（% 表示） |
| 人閲覧 | 人がナレッジを直接開いた回数（human_view_count） |
| AI 参照 | MCP get-knowledge で AI がナレッジを取得した回数（ai_reference_count） |
| 合計閲覧 | 上記 3 チャネルの合算（total_view_count） |
種類バッジと要レビュー
各行のタイトル横に種類バッジが付く場合があります。種類フィルタでバッジ別に絞り込めます。
| バッジ | 意味 | 対応目安 |
|---|---|---|
critical |
候補数が多いが採用率が極端に低い（改善緊急度: 高） | 本文・タイトルの見直し |
stale |
長期間更新・レビューされていない（陳腐化の疑い） | 内容を確認し「レビュー済み」操作 |
low_adoption |
採用率が低め（候補 5 件以上かつ採用率 20% 未満は赤字） | タグ・見出し・関連ナレッジを補強 |
comments |
未確認のセクションコメントあり | コメント内容を確認 |
各行から「レビュー済み」操作でバッジを消し込めます（reviewed_at を更新し、stale / critical / low_adoption を解消）。
読み方のコツ
| パターン | 示唆 |
|---|---|
| 引用数が多い | 回答の根拠としてよく使われている（効いているナレッジ） |
| 候補数は多いが採用率が低い（赤字） | 検索にはヒットするが回答に採用されにくい。内容の改善候補 |
| どちらも少ない | 質問内容と合っていない、タグ・見出し・関連ナレッジの不足の可能性 — No.5.9 で改善手順を確認 |
列ヘッダーをクリックすると各列でソートできます。1 ページ 20 件、ページネーションあり。
カウントの対象外（参考）
- 「ナレッジが見つかりませんでした」等の定型応答は記録しない
- Web チャット・公開ナビゲーター・Teams・メンション連鎖・再生成を含む
運用への活かし方
- 共有の効果測定 — QR をポスターに載せたあと、流入グラフで反応を確認（No.4.2）
- フィードバックへの対応 — 「コピー」ボタンで改善指示テキストを取り出し、エージェントのプロンプト改善に活用。対応後は「レビュー済み」で消し込み
- ナレッジ改善の優先付け — 種類バッジで要レビュー行を絞り込み、No.5.8 で指標を理解し No.5.9 の執筆コツで修正 → チャットで再テスト
- レビューサイクル —
staleバッジが付いた古いナレッジを定期確認（No.5.4）
開発者向け（API）
プログラムから同じ集計を取得する場合:
| API | 用途 |
|---|---|
GET /api/v1/analytics/referrals |
流入の日別系列 |
GET /api/v1/analytics/knowledge-citations |
ナレッジ閲覧一覧（チャット引用・人閲覧・AI参照・合計） |
GET /api/v1/analytics/message-feedbacks |
フィードバック・未回答質問一覧 |
GET /api/v1/analytics/message-reports |
通報一覧 |
GET /api/v1/analytics/review-summary |
要対応バッジの件数（未読の新着通報・フィードバック・コメント数） |
共通クエリ: from / to（最大 366 日）、agent_id（省略時は所有全件合算）。詳細は「開発者向け：REST API」（No.7.3）。