面向合规的数据清除

本指南涵盖数据到达 LangSmith Cloud 服务器后可用的各种功能，以帮助你达成隐私目标。

数据保留

LangSmith 提供自动数据保留功能，以帮助合规和存储管理。数据保留策略可在两个层级上配置：

• 工作区级别：具有所需权限的企业版客户可以将延长保留设为工作区默认值，并自定义保留时长（截至 2026 年 9 月 14 日最长 180 天）。参阅自定义延长保留策略。
• 项目级别：具有所需权限的客户可以为每个追踪项目设置默认保留层级，在基础保留（14 天）或延长保留（180 天）之间选择。参阅更改项目级默认保留。

有关数据保留配置和管理的详细信息，请参阅数据保留概念文档。

自定义延长保留策略

NOTE

此功能面向 Enterprise 方案客户。对于自托管企业版客户，参阅工作区级别的配置章节。

企业版客户可以在工作区级别自定义追踪的延长数据保留期，以满足特定的合规要求。自 2026 年 9 月 14 日起，SaaS 客户的长生命周期追踪保留期最长为 180 天。你可以根据组织需求在此上限之下调整保留期。对保留期的更改仅适用于新追踪。

NOTE

对保留期的更改仅适用于新追踪。现有追踪不受影响。

配置延长保留

组织管理员和操作员（organization:manage）可以为任何工作区配置保留。工作区管理员可以配置他们自己的工作区（workspaces:manage）。有关完整的权限参考，参阅组织与工作区操作。

在 LangSmith UI中：

1. 导航到页面底部的 Settings。
2. 从左侧菜单中选择 Usage configuration。
3. 在列表中找到你想要配置的工作区。
4. 点击该工作区 Data retention policy 列下的值。
5. 在 workspace usage configurations 模态框上，使用 Extended - All traces are retained for 选项的下拉菜单来自定义延长策略。SaaS 客户可用的时长为：30d、60d、90d、120d、150d 和 180d（截至 2026 年 9 月 14 日的最大值）。自托管部署不受此上限约束。
6. 选择 Save。

自托管的工作区级延长保留

自托管企业版客户也可以使用工作区级延长保留配置，而非系统级 TTL 设置。这为不同工作区的数据保留提供了更细粒度的控制，而无需更改环境变量。

WARNING

如果你使用 blob 存储，你必须为你配置的每个自定义保留期添加一条生命周期规则。例如，将工作区设为 90 天保留意味着 blob 数据会写入 ttl_90d/ 前缀，这需要一条匹配的生命周期规则来自动清理。详情和示例参阅blob 存储 TTL 配置。

要为自托管部署配置此项，参阅自托管 TTL 文档了解遗留的系统级方法，或联系支持。

追踪删除

你可以使用 API 完成追踪删除。该 API 支持两种删除追踪的方法：

1. 按追踪 ID 和 session ID：通过提供一组追踪 ID 及其对应的 session ID 来删除特定追踪（每次请求最多 1000 条追踪）
2. 按元数据：删除工作区内匹配任一指定元数据键值对的追踪

更多详情，参阅 API 规范。

WARNING

所有追踪删除都会删除相关的实体，比如反馈、聚合和统计，跨越所有数据存储。

删除时间线

追踪删除在非高峰使用时段处理，并非即时。LangChain 在周末运行删除作业。没有删除确认——你需要再次查询数据以核实它已被移除。

删除特定追踪

要按追踪 ID 从单个 session 删除特定追踪：

NOTE

session_id 是你要尝试删除的追踪的项目 ID。你可以在 LangSmith UI 的追踪项目页面上找到它。

curl -X POST "https://api.smith.langchain.com/api/v1/runs/delete" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "trace_ids": ["trace-id-1", "trace-id-2", "trace-id-3"],
    "session_id": "session-id-1"
  }'

示例删除

你可以通过我们的 API 自助删除数据集示例，它根据数据保留需求支持软删除和硬删除两种方法。

WARNING

硬删除会从整个数据集历史中，永久移除指定示例所有版本中的输入、输出和元数据。

删除示例是一个两步过程

对于批量操作，示例删除遵循一个两步过程：

1. 按元数据搜索示例

在工作区内所有数据集中查找具有匹配元数据的所有示例。

GET /examples

• as_of 必须显式指定为一个时间戳。只返回在 as_of 日期之前创建的示例

curl -X GET "https://api.smith.langchain.com/api/v1/examples?as_of=2024-01-01T00:00:00Z" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {
      "user_id": "user123",
      "environment": "staging"
    }
  }'

这将在你工作区的所有数据集中返回元数据里含有 user_id: "user123" 或 environment: "staging" 的示例。

2. 硬删除示例

一旦你有了示例 ID，就发送一个删除请求。这会将该示例在数据集所有版本中的输入、输出和元数据清零。

POST /v1/platform/datasets/examples/delete/

• 在请求体中指定 example_ids（示例 ID 列表）和 hard_delete（布尔值）

curl -X POST "https://api.smith.langchain.com/v1/platform/datasets/examples/delete/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "example_ids": ["example-id-1", "example-id-2", "example-id-3"],
    "hard_delete": true
  }'

删除类型

软删除（默认）

• 在数据集中创建带有 NULL 输入/输出的墓碑条目
• 保留历史数据并维护数据集版本控制
• 只影响数据集的当前版本

硬删除

• 从所有数据集版本中永久移除输入、输出和元数据
• 当合规要求在跨所有版本清零时，完全移除数据
• 在请求体中设置 "hard_delete": true

---