LangBot/ja/insight/data-collection-policy.mdx

---
title: "データ収集ポリシー"
description: "LangBot が収集するデータとその使用方法"
---

LangBot は製品改善のため、最小限の匿名テレメトリデータを収集します。このドキュメントでは、収集されるデータ、その用途、およびオプトアウト方法について説明します。

## 収集するデータ

テレメトリが有効な場合（LangBot Space 連携経由）、**各会話クエリごとに**以下のデータが送信されます：

| フィールド | 説明 |
|---|---|
| `query_id` | ランダム生成されたクエリ固有 ID（ユーザー ID とは紐付けられません） |
| `adapter` | 使用中のメッセージングプラットフォームアダプター種別（例：WeChat、QQ、Telegram）— アダプターの種類名のみ、アカウント情報は含まれません |
| `runner` | AI ランナーの種類（例：`local-agent`、`dify-service-api`） |
| `model_name` | クエリに使用されたモデル名（例：`gpt-4o`、`deepseek-chat`） |
| `duration_ms` | クエリの処理時間（ミリ秒） |
| `version` | 実行中の LangBot バージョン |
| `workspace_uuid` | クエリが実行されたワークスペースを識別する安定した UUID。デフォルトのセルフホストワークスペースではインストール UUID と一致し、個人情報とは紐付けられません。 |
| `runtime_instance_id` | マネージド SaaS のクエリイベントでのみ送信され、実行環境のアイドルタイムアウト活動を更新するために使用されます。分析イベントレコードには保存されません。 |
| `pipeline_plugins` | クエリに関与したパイプラインプラグイン名 |
| `features` | クエリの匿名機能使用カウンター（下記参照） |
| `error` | クエリ失敗時のエラートレースバック（ユーザーコンテンツは含まれません） |
| `timestamp` | クエリが発生した時刻（UTC） |

#### `features` オブジェクト

各機能の実際の利用状況を把握するため、各クエリイベントには以下のカウンターとカテゴリ名が含まれる場合があります — ツール呼び出しの内容、検索されたドキュメント、実行されたコードは**一切含まれません**：

| キー | 説明 |
|---|---|
| `tool_calls` | クエリ中のツール呼び出し回数（ツール種別ごと：`native` / `plugin` / `mcp` / `skill`） |
| `tool_call_rounds` | クエリで実行されたエージェントのツール呼び出しラウンド数 |
| `kb` | ナレッジベースの利用状況：クエリしたナレッジベース数、使用中のナレッジエンジンプラグイン ID、検索されたエントリ数 — 検索されたテキストは含まれません |
| `sandbox` | サンドボックスでのコード実行回数とエラー回数 — 実行されたコードやその出力は含まれません |
| `activated_skills` | クエリ中にアクティベートされたスキル名 |
| `mcp_servers` | パイプラインにバインドされた MCP サーバー名（「すべて有効」の場合は送信されません） |

### ワークスペースハートビート

クエリごとのイベントに加え、LangBot は起動直後とその後 1 日 1 回、アクティブなワークスペースごとに匿名の**ワークスペースハートビート**を送信します。これはそのワークスペースの構成プロファイルを示すもので、ワークスペースのデータは一切含まれません：

| フィールド | 説明 |
|---|---|
| `deploy_platform` | LangBot のデプロイ方法（`docker`、`linux`、`darwin`、`win32` など） |
| `database` | 使用中のデータベース種別（`sqlite` または `postgresql`）— 接続情報は含まれません |
| `vdb` | 使用中のベクトルデータベース種別（例：`chroma`、`milvus`、`qdrant`）— 接続情報は含まれません |
| `box` | サンドボックス構成：有効フラグ、可用性、バックエンド種別（`docker` / `nsjail` / `e2b`）、デプロイトポロジー — ワークスペースの内容は含まれません |
| `adapters` | 有効なボットのアダプター種別名 |
| `bot_count`、`pipeline_count`、`mcp_server_count`、`knowledge_base_count`、`plugin_count`、`skill_count` | オブジェクト数のみ — これらのリソースの名前や内容は含まれません |

### アンケート

LangBot はアプリ内でアンケート（例：プロダクトマーケットフィット調査）を表示する場合があります。参加は**任意**です。アンケート送信時には以下が送信されます：

- アンケート ID と回答内容
- インスタンス ID と LangBot バージョン
- アンケートを完了したか、閉じたか

## 収集しないデータ

- ❌ **メッセージ内容** — 会話の内容は一切収集しません
- ❌ **ユーザー ID** — ユーザー名、メールアドレス、電話番号、メッセージングプラットフォームのアカウント ID は収集しません
- ❌ **API キーや認証情報** — モデルプロバイダーの API キーが送信されることはありません
- ❌ **IP アドレス** — 分析目的で IP アドレスを記録・保存することはありません
- ❌ **ファイルやメディア** — ボットとやり取りする画像、ドキュメント、その他メディアは収集しません

## データの使用目的

収集されたテレメトリデータは以下の目的で使用されます：

1. **利用パターンの把握** — どのアダプター、ランナー、モデルが最も使われているか
2. **信頼性の向上** — 一般的なエラーや障害パターンの特定
3. **開発の指針** — 実際の利用状況に基づく機能・プラットフォームサポートの優先順位付け
4. **パフォーマンス監視** — レスポンス時間の追跡とボトルネックの特定

## データの保存と保持

- テレメトリデータは **LangBot Space**（`space.langbot.app`）に送信されます
- データは LangBot チームが運用するサーバーに保存されます
- データは製品分析のために保持され、公開統計（例：総ユーザー数）として集計される場合があります

## オプトアウト方法

`data/config.yaml` 設定ファイルの `space` セクションで `disable_telemetry: true` を設定することで、いつでもテレメトリを無効にできます：

```yaml
space:
  url: "https://space.langbot.app"
  disable_telemetry: true
```

テレメトリを無効にすると：
- クエリデータは送信されません
- ワークスペースハートビートは送信されません
- アンケートの取得・表示は行われません
- その他すべての LangBot 機能は通常通り動作します

## ポリシーの変更

LangBot の発展に伴い、このポリシーを更新する場合があります。変更はリリースノートに記載され、このページに反映されます。

*最終更新：2026年7月*