-
Notifications
You must be signed in to change notification settings - Fork 1.5k
zh insight data collection policy
langbot-wiki-sync[bot] edited this page Jul 31, 2026
·
2 revisions
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) |
为了解各项能力的实际使用情况,每个查询事件可能包含以下计数和类别名称 — 绝不包含工具调用内容、检索到的文档内容或执行的代码:
| 键 | 说明 |
|---|---|
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 地址
- ❌ 文件或媒体内容 — 不收集您与机器人交换的图片、文档或其他媒体
收集的遥测数据用于:
- 了解使用模式 — 哪些适配器、运行器和模型最受欢迎
- 提高可靠性 — 识别常见错误和故障模式
- 指导开发 — 根据实际使用情况确定功能和平台支持的优先级
- 监控性能 — 跟踪响应时间并识别瓶颈
- 遥测数据发送至 LangBot Space(
space.langbot.app) - 数据存储在 LangBot 团队运维的服务器上
- 数据保留用于产品分析,可能会汇总用于公开统计(如总用户数)
您可以随时在 data/config.yaml 配置文件的 space 部分设置 disable_telemetry: true 来关闭遥测:
space:
url: "https://space.langbot.app"
disable_telemetry: true关闭遥测后:
- 不会发送任何查询数据
- 不会发送工作区心跳
- 不会获取或展示问卷调查
- 所有其他 LangBot 功能照常运行
我们可能会随着 LangBot 的发展更新此政策。变更将记录在发布说明中并体现在此页面。
最后更新:2026 年 7 月
Automatically synchronized from langbot-app/langbot-wiki.
简体中文
指南
开发者
- 插件开发
- 插件 SDK API
- 核心开发
API 参考
- Service API
English
Guides
Developers
-
Plugin Development
- Plugin Development Tutorial
- Completing Plugin Configuration Information
- Plugin Directory Structure
- Component Development
- Code Style Guide
- Migration Guide
- Publish Plugin
- Plugin SDK API
- Core Development
API Reference
- Service API