遥测
了解 CrewAI 收集的遥测数据及其如何助力改进库。
遥测
默认情况下,我们不会收集根据 GDPR 和其他隐私法规被视为个人信息的数据。我们确实会收集工具名称和 Agent 角色名称,因此建议不要在工具名称或 Agent 角色名称中包含任何个人信息。由于不收集个人信息,因此无需担心数据驻留问题。启用 share_crew
时,会收集额外的数据,如果用户包含个人信息,这些数据可能会包含个人信息。用户在启用此功能时应谨慎行事,以确保符合隐私法规。
CrewAI 利用匿名遥测收集使用统计数据,主要目的是增强库的功能。我们的重点是改进和开发用户最常使用的功能、集成和工具。
理解这一点至关重要:默认情况下,不收集任何个人数据,包括关于提示、任务描述、Agent 的背景故事或目标、工具使用、API 调用、响应、Agent 处理的任何数据,或者秘密和环境变量。启用 share_crew
功能后,会收集详细数据,包括任务描述、Agent 的背景故事或目标以及其他特定属性,以提供更深入的洞察。如果用户将其纳入团队或任务中,这种扩展的数据收集可能包含个人信息。用户在启用 share_crew
之前应仔细考虑其团队和任务的内容。用户可以通过将环境变量 CREWAI_DISABLE_TELEMETRY
设置为 true
或将 OTEL_SDK_DISABLED
设置为 true
来禁用遥测(请注意,后者会全局禁用所有 OpenTelemetry 检测)。
示例
数据说明
默认收集 | 数据 | 原因和详情 |
---|---|---|
是 | CrewAI 和 Python 版本 | 跟踪软件版本。示例:CrewAI v1.2.3, Python 3.8.10。无个人数据。 |
是 | 团队元数据 | 包括:随机生成的 key 和 ID,流程类型(例如,“顺序”、“并行”),内存使用布尔标志(true/false),任务数量,Agent 数量。所有数据均非个人信息。 |
是 | Agent 数据 | 包括:随机生成的 key 和 ID,角色名称(不应包含个人信息),布尔设置(详细模式、允许委派、允许代码执行),最大迭代次数,最大 RPM,最大重试限制,LLM 信息(参见 LLM 属性),工具名称列表(不应包含个人信息)。无个人数据。 |
是 | 任务元数据 | 包括:随机生成的 key 和 ID,布尔执行设置(async_execution, human_input),关联 Agent 的角色和 key,工具名称列表。所有数据均非个人信息。 |
是 | 工具使用统计 | 包括:工具名称(不应包含个人信息),使用尝试次数(整数),使用的 LLM 属性。无个人数据。 |
是 | 测试执行数据 | 包括:团队的随机生成的 key 和 ID,迭代次数,使用的模型名称,质量得分(浮点数),执行时间(以秒为单位)。所有数据均非个人信息。 |
是 | 任务生命周期数据 | 包括:创建和执行开始/结束时间,团队和任务标识符。以带有时间戳的 spans 形式存储。无个人数据。 |
是 | LLM 属性 | 包括:LLM 的 name, model_name, model, top_k, temperature 和 class name。所有数据均为技术性、非个人数据。 |
是 | 使用 crewAI CLI 尝试部署团队 | 包括:正在进行部署的事实和团队 ID,以及是否正在尝试拉取日志,不包含其他数据。 |
否 | Agent 扩展数据 | 包括:目标描述,背景故事文本,i18n 提示文件标识符。用户应确保文本字段中不包含个人信息。 |
否 | 详细任务信息 | 包括:任务描述,预期输出描述,上下文引用。用户应确保这些字段中不包含个人信息。 |
否 | 环境信息 | 包括:平台,发布版本,系统,版本和 CPU 数量。示例:‘Windows 10’,‘x86_64’。无个人数据。 |
否 | 团队和任务输入输出 | 包括:输入参数和输出结果作为非识别数据。用户应确保不包含个人信息。 |
否 | 详细团队执行数据 | 包括:团队操作的详细日志,所有 Agent 和任务数据,最终输出。所有数据均非个人且属于技术性质。 |
“默认收集”列中的“否”表示仅当 share_crew
设置为 true
时才收集此数据。
选择启用更多遥测共享
用户可以通过在其团队配置中将 share_crew
属性设置为 True
来选择共享完整的遥测数据。启用 share_crew
会收集详细的团队和任务执行数据,包括任务的 goal
、backstory
、context
和 output
。这有助于深入了解使用模式。
如果启用 share_crew
,收集的数据可能包含个人信息,如果这些信息已包含在团队配置、任务描述或输出中。用户在启用此功能之前,应仔细检查其数据并确保符合 GDPR 和其他适用的隐私法规。