diff --git a/docs.json b/docs.json index 427c62d43..ec089241e 100644 --- a/docs.json +++ b/docs.json @@ -106,7 +106,8 @@ "pages": [ "en/insight/guide", "en/insight/features", - "en/insight/community" + "en/insight/community", + "en/insight/data-collection-policy" ] }, { @@ -291,7 +292,8 @@ "pages": [ "zh/insight/guide", "zh/insight/features", - "zh/insight/community" + "zh/insight/community", + "zh/insight/data-collection-policy" ] }, { @@ -506,7 +508,8 @@ "pages": [ "ja/insight/guide", "ja/insight/features", - "ja/insight/community" + "ja/insight/community", + "ja/insight/data-collection-policy" ] }, { diff --git a/en/insight/data-collection-policy.mdx b/en/insight/data-collection-policy.mdx new file mode 100644 index 000000000..054e03be6 --- /dev/null +++ b/en/insight/data-collection-policy.mdx @@ -0,0 +1,77 @@ +--- +title: "Data Collection Policy" +description: "What data LangBot collects and how it is used" +--- + +# Data Collection Policy + +LangBot collects minimal, anonymized telemetry data to help improve the product. This document explains what data is collected, how it is used, and how you can opt out. + +## What We Collect + +When telemetry is enabled (via LangBot Space integration), the following data is sent **per conversation query**: + +| Field | Description | +|---|---| +| `query_id` | A randomly generated unique ID for the query (not linked to user identity) | +| `adapter` | The messaging platform adapter in use (e.g., WeChat, QQ, Telegram) — only the adapter type name, not your account info | +| `runner` | The AI runner type (e.g., `local-agent`, `dify-service-api`) | +| `model_name` | The model name used for the query (e.g., `gpt-4o`, `deepseek-chat`) | +| `duration_ms` | How long the query took to process (in milliseconds) | +| `version` | The LangBot version you are running | +| `instance_id` | A randomly generated UUID identifying your LangBot instance (generated at first launch, not linked to personal identity) | +| `pipeline_plugins` | Names of pipeline plugins involved in the query | +| `error` | Error traceback if the query failed (no user content included) | +| `timestamp` | When the query occurred (UTC) | + +### Surveys + +LangBot may occasionally present in-app surveys (e.g., product-market fit surveys). Participation is **optional**. When a survey is submitted, the following is sent: + +- Survey ID and your answers +- Your instance ID and LangBot version +- Whether you completed or dismissed the survey + +## What We Do NOT Collect + +- ❌ **Message content** — We never collect the content of your conversations +- ❌ **User identities** — No usernames, emails, phone numbers, or account IDs from your messaging platforms +- ❌ **API keys or credentials** — Your model provider API keys are never transmitted +- ❌ **IP addresses** — We do not log or store your IP address for analytics purposes +- ❌ **File or media content** — No images, documents, or other media you exchange with the bot + +## How We Use the Data + +The collected telemetry data is used to: + +1. **Understand usage patterns** — Which adapters, runners, and models are most popular +2. **Improve reliability** — Identify common errors and failure modes +3. **Guide development** — Prioritize features and platform support based on real usage +4. **Monitor performance** — Track response times and identify bottlenecks + +## Data Storage & Retention + +- Telemetry data is sent to **LangBot Space** (`space.langbot.app`) +- Data is stored on servers operated by the LangBot team +- Data is retained for product analytics purposes and may be aggregated for public statistics (e.g., total user count) + +## How to Opt Out + +You can disable telemetry at any time by setting `disable_telemetry: true` in the `space` section of your `data/config.yaml` configuration file: + +```yaml +space: + url: "https://space.langbot.app" + disable_telemetry: true +``` + +When telemetry is disabled: +- No query data will be sent +- No surveys will be fetched or displayed +- All other LangBot features continue to work normally + +## Changes to This Policy + +We may update this policy as LangBot evolves. Changes will be documented in our release notes and reflected in this page. + +*Last updated: July 2025* diff --git a/ja/insight/data-collection-policy.mdx b/ja/insight/data-collection-policy.mdx new file mode 100644 index 000000000..f21d760d5 --- /dev/null +++ b/ja/insight/data-collection-policy.mdx @@ -0,0 +1,77 @@ +--- +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 バージョン | +| `instance_id` | LangBot インスタンスを識別するランダム生成 UUID(初回起動時に生成、個人情報とは紐付けられません) | +| `pipeline_plugins` | クエリに関与したパイプラインプラグイン名 | +| `error` | クエリ失敗時のエラートレースバック(ユーザーコンテンツは含まれません) | +| `timestamp` | クエリが発生した時刻(UTC) | + +### アンケート + +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 の発展に伴い、このポリシーを更新する場合があります。変更はリリースノートに記載され、このページに反映されます。 + +*最終更新:2025年7月* diff --git a/zh/insight/data-collection-policy.mdx b/zh/insight/data-collection-policy.mdx new file mode 100644 index 000000000..b38c92cef --- /dev/null +++ b/zh/insight/data-collection-policy.mdx @@ -0,0 +1,77 @@ +--- +title: "数据收集政策" +description: "LangBot 收集哪些数据及其用途" +--- + +# 数据收集政策 + +LangBot 收集最少量的匿名遥测数据,以帮助改进产品。本文档说明了收集的数据内容、用途以及如何选择退出。 + +## 我们收集什么 + +当遥测功能启用时(通过 LangBot Space 集成),以下数据会在**每次对话查询时**发送: + +| 字段 | 说明 | +|---|---| +| `query_id` | 随机生成的查询唯一 ID(不与用户身份关联) | +| `adapter` | 使用的消息平台适配器类型(如 微信、QQ、Telegram)— 仅适配器类型名称,不包含您的账号信息 | +| `runner` | AI 运行器类型(如 `local-agent`、`dify-service-api`) | +| `model_name` | 查询使用的模型名称(如 `gpt-4o`、`deepseek-chat`) | +| `duration_ms` | 查询处理耗时(毫秒) | +| `version` | 您正在运行的 LangBot 版本 | +| `instance_id` | 随机生成的 UUID,标识您的 LangBot 实例(首次启动时生成,不与个人身份关联) | +| `pipeline_plugins` | 参与查询的管道插件名称 | +| `error` | 查询失败时的错误追踪信息(不包含用户内容) | +| `timestamp` | 查询发生的时间(UTC) | + +### 问卷调查 + +LangBot 可能会偶尔在应用内展示问卷调查(如产品市场匹配调查)。参与完全**自愿**。提交问卷时,将发送以下内容: + +- 问卷 ID 和您的回答 +- 您的实例 ID 和 LangBot 版本 +- 您是否完成或关闭了问卷 + +## 我们不收集什么 + +- ❌ **消息内容** — 我们绝不收集您的对话内容 +- ❌ **用户身份** — 不收集用户名、邮箱、手机号或消息平台的账号 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 的发展更新此政策。变更将记录在发布说明中并体现在此页面。 + +*最后更新:2025 年 7 月*