跳到主要内容
本指南涵盖了数据到达 LangSmith 云服务器后可用的各种功能，以帮助您实现隐私目标。

​
数据保留

LangSmith 提供自动数据保留功能，以帮助遵守合规性并进行存储管理。数据保留策略可在组织和项目级别配置。 有关数据保留配置和管理的详细信息，请参阅数据保留概念文档。

​
跟踪删除

您可以使用 API 完成跟踪删除。API 支持两种删除跟踪的方法
  1. 按跟踪 ID 和会话 ID：通过提供跟踪 ID 列表及其对应的会话 ID 来删除特定跟踪（每次请求最多 1000 个跟踪）
  2. 按元数据：删除工作区中与任何指定元数据键值对匹配的跟踪
有关更多详细信息，请参阅 API 规范。
所有跟踪删除都将删除所有数据存储中相关的实体，如反馈、聚合和统计数据。

​
删除时间线

跟踪删除在非高峰使用时间处理，并非即时完成，通常在几小时内。没有删除确认 — 您需要再次查询数据以验证其是否已删除。

​
删除特定跟踪

要通过跟踪 ID 从单个会话中删除特定跟踪 
curl -X POST "https://api.smith.langchain.com/api/v1/runs/delete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "run_ids": ["trace-id-1", "trace-id-2", "trace-id-3"],
    "session_id": "session-id-1"
  }'

​
按元数据删除

按元数据删除时
  • 接受一个键/值对的 metadata 对象。KV 对匹配使用 或 条件。如果跟踪具有元数据中指定的 任何 键值对（而不是所有），则将匹配。
  • 按元数据删除时，您不需要指定会话 ID。删除将应用于整个工作区。
要根据工作区中的元数据删除跟踪（匹配 任何 元数据键值对） 
curl -X POST "https://api.smith.langchain.com/api/v1/runs/delete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {
      "user_id": "user123",
      "environment": "staging"
    }
  }'
这将删除元数据中包含 user_id: "user123" 或 environment: "staging" 的跟踪。
请记住，每个会话每次请求最多只能安排 1000 个跟踪。对于大规模删除，您需要发出多个请求。

​
示例删除

您可以通过我们的 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 "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {
      "user_id": "user123",
      "environment": "staging"
    }
  }'
这将返回在您的工作区所有数据集中，元数据中包含 user_id: "user123" 或 environment: "staging" 的示例。

​
2. 彻底删除示例

获取示例 ID 后，发送删除请求。这将清空该示例数据集所有版本中的输入、输出和元数据。 DELETE /examples
  • 指定示例 ID 并将 "hard_delete": true 添加到请求的查询参数中
curl -X DELETE "https://api.smith.langchain.com/api/v1/examples?hard_delete=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "example_ids": ["example-id-1", "example-id-2", "example-id-3"]
  }'

​
删除类型

​
软删除（默认）

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

​
彻底删除

  • 永久从所有数据集版本中移除输入、输出和元数据
  • 当合规性要求所有版本都清空时，完全删除数据
  • 将 "hard_delete": true 添加到查询参数
有关更多详细信息，请参阅 API 规范。
在 GitHub 上编辑此页面源文件。
以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.