> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langbot.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 数据收集政策

> 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` | 参与查询的管道插件名称                                        |
| `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 theme={null}
space:
  url: "https://space.langbot.app"
  disable_telemetry: true
```

关闭遥测后：

* 不会发送任何查询数据
* 不会发送实例心跳
* 不会获取或展示问卷调查
* 所有其他 LangBot 功能照常运行

## 政策变更

我们可能会随着 LangBot 的发展更新此政策。变更将记录在发布说明中并体现在此页面。

*最后更新：2026 年 6 月*