mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-10-30 04:15:45 +08:00
105 lines
5.0 KiB
Plaintext
105 lines
5.0 KiB
Plaintext
---
|
||
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 版本 |
|
||
| `workspace_uuid` | 标识查询执行工作区的稳定 UUID。默认自托管工作区与安装 UUID 对齐，不与个人身份关联。 |
|
||
| `runtime_instance_id` | 仅托管 SaaS 查询事件发送，用于刷新运行实例的空闲超时活动；不会写入分析事件记录。 |
|
||
| `pipeline_plugins` | 参与查询的管道插件名称 |
|
||
| `features` | 本次查询的匿名功能使用计数（见下文） |
|
||
| `error` | 查询失败时的错误追踪信息（不包含用户内容） |
|
||
| `timestamp` | 查询发生的时间（UTC） |
|
||
|
||
#### `features` 对象
|
||
|
||
为了解各项能力的实际使用情况，每个查询事件可能包含以下计数和类别名称 — **绝不包含**工具调用内容、检索到的文档内容或执行的代码：
|
||
|
||
| 键 | 说明 |
|
||
|---|---|
|
||
| `tool_calls` | 本次查询中的工具调用次数，按工具来源分组（`native` / `plugin` / `mcp` / `skill`） |
|
||
| `tool_call_rounds` | 本次查询经历的 Agent 工具调用轮数 |
|
||
| `kb` | 知识库使用情况：查询的知识库数量、使用的知识引擎插件 ID、检索到的条目数量 — 不包含检索到的文本 |
|
||
| `sandbox` | 沙箱代码执行次数和沙箱错误次数 — 不包含执行的代码或其输出 |
|
||
| `activated_skills` | 本次查询中激活的技能名称 |
|
||
| `mcp_servers` | 绑定到管道的 MCP 服务器名称（使用"全部启用"时不发送） |
|
||
|
||
### 工作区心跳
|
||
|
||
除每次查询事件外，LangBot 会在启动后不久为每个活跃工作区发送一条匿名**工作区心跳**，之后每天发送一次。心跳描述该工作区的配置概况 — 绝不包含工作区数据：
|
||
|
||
| 字段 | 说明 |
|
||
|---|---|
|
||
| `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
|
||
- ❌ **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 月*
|