合规性数据清除

本指南介绍数据到达 LangSmith Cloud 服务器后可使用的各种功能，帮助您实现隐私目标。

数据保留

LangSmith 提供自动数据保留功能，帮助满足合规要求并管理存储。数据保留策略可在两个级别进行配置：

工作区级别：具有所需权限的 Enterprise 客户可以将延长保留设置为工作区默认值，并自定义保留时长（最长 400 天）。请参阅自定义延长保留策略。
项目级别：具有所需权限的客户可以为每个追踪项目设置默认保留层级，在基础保留（14 天）和延长保留（400 天）之间进行选择。请参阅更改项目级别的默认保留设置。

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

自定义延长保留策略

此功能适用于 Enterprise 计划客户。对于自托管 Enterprise 客户，请参阅工作区级别配置部分。

Enterprise 客户可以在工作区级别自定义追踪数据的延长保留期限，以满足特定的合规要求。默认情况下，延长保留期限设置为 400 天，但您可以根据组织的需求进行调整。保留期限的更改仅适用于新的追踪数据。

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

配置延长保留

组织管理员和操作员 (organization:manage) 可以为任何工作区配置保留策略。工作区管理员可以配置其所属工作区 (workspaces:manage)。有关完整的权限参考，请参阅组织和工作区操作。

在 LangSmith UI 中：

在页面底部导航至 Settings。
从左侧菜单中选择 Usage configuration。
在列表中找到您想要配置的工作区。
点击该工作区 Data retention policy 列下的值。
在 workspace usage configurations 模态框中，使用 Extended - All traces are retained for 选项的下拉菜单自定义延长保留策略。可用时长包括：30d、60d、90d、120d、150d、180d、240d、300d、365d 和 400d。
选择 Save。

若要读取当前设置：组织级别 (organization:manage)

curl -X GET "https://api.smith.langchain.com/api/v1/orgs/ttl-settings" \
  -H "x-api-key: YOUR_API_KEY"

工作区级别 (workspaces:manage)

curl -X GET "https://api.smith.langchain.com/api/v1/ttl-settings" \
  -H "x-api-key: YOUR_API_KEY"

若要更新保留期限，请将 resource_type 设置为追踪数据对应的 "run"，并将 ttl_days 设置为所需时长。可用时长包括：30、60、90、120、150、180、240、300、365 和 400 天。组织级别 (organization:manage)

curl -X PUT "https://api.smith.langchain.com/api/v1/orgs/ttl-settings" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resource_type": "run", "ttl_days": 90}'

工作区级别 (workspaces:manage)

curl -X PUT "https://api.smith.langchain.com/api/v1/ttl-settings" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resource_type": "run", "ttl_days": 90}'

自托管环境中的工作区级别延长保留

自托管的 Enterprise 客户也可以使用工作区级别的延长保留配置，而不是系统范围的 TTL 设置。这样无需更改环境变量，即可对不同工作区的数据保留进行更细粒度的控制。

如果您使用 Blob 存储，必须为配置的每个自定义保留期限添加生命周期规则。例如，将某个工作区设置为保留 90 天，意味着 Blob 数据会写入 ttl_90d/ 前缀，因此需要设置相应的生命周期规则，以便自动清理这些数据。有关详细信息和示例，请参阅 Blob 存储 TTL 配置。

若要为自托管部署配置此功能，请参阅自托管 TTL 文档了解旧版系统范围方法，或联系支持团队。

删除追踪数据

您可以使用 API 完成追踪数据删除。API 支持以下两种追踪数据删除方式：

按追踪 ID 和会话 ID 删除：提供追踪 ID 列表及其对应的会话 ID，以删除指定的追踪数据（每个请求最多 1000 条追踪数据）
按元数据删除：删除工作区中匹配指定元数据键值对的追踪数据

有关更多详细信息，请参阅 API 规范。

删除追踪数据时，所有数据存储中的相关实体（例如反馈、聚合数据和统计信息）也会一并删除。

删除时间线

追踪数据删除会在非高峰使用时段处理，并非即时完成。LangChain 会在周末运行删除任务。删除完成后不会收到确认信息——您需要重新查询数据，以验证其是否已被删除。

删除指定的追踪数据

若要根据追踪 ID 删除单个会话中的指定追踪数据：

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 自助删除数据集示例。根据数据保留需求，API 同时支持软删除和硬删除。

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

删除示例分为两个步骤

对于批量操作，示例删除分为以下两个步骤：

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

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

Edit this page on GitHub or file an issue.

Organization

Users & access control

Tools

Auditing

Data & compliance

Additional resources

数据保留

自定义延长保留策略

配置延长保留

自托管环境中的工作区级别延长保留

删除追踪数据

删除时间线

删除指定的追踪数据

示例删除

删除示例分为两个步骤

1. 按元数据搜索示例

2. 硬删除示例

删除类型

软删除（默认）

硬删除

​数据保留

​自定义延长保留策略

​配置延长保留

​自托管环境中的工作区级别延长保留

​删除追踪数据

​删除时间线

​删除指定的追踪数据

​示例删除

​删除示例分为两个步骤

​1. 按元数据搜索示例

​2. 硬删除示例

​删除类型

​软删除（默认）

​硬删除

数据保留

自定义延长保留策略

配置延长保留

自托管环境中的工作区级别延长保留

删除追踪数据

删除时间线

删除指定的追踪数据

示例删除

删除示例分为两个步骤

1. 按元数据搜索示例

2. 硬删除示例

删除类型

软删除（默认）

硬删除