Skip to main content
이 가이드는 LangSmith Cloud 서버에 데이터가 도달한 후 개인정보 보호 목표를 달성하는 데 도움이 되는 다양한 기능을 다룹니다.

​
데이터 보존

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 쌍 매칭은 OR 조건을 사용합니다. 트레이스는 메타데이터에 지정된 키-값 쌍 중 하나라도 있으면 일치합니다(모두 있을 필요는 없음)
  • 메타데이터별로 삭제할 때는 세션 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를 통해 데이터셋 예제를 셀프 서비스로 삭제할 수 있으며, 데이터 보존 요구 사항에 따라 소프트 삭제와 하드 삭제 방법을 모두 지원합니다.
하드 삭제는 전체 데이터셋 히스토리에서 지정된 예제의 모든 버전에서 입력, 출력 및 메타데이터를 영구적으로 제거합니다.

​
예제 삭제는 2단계 프로세스입니다

대량 작업의 경우 예제 삭제는 2단계 프로세스를 따릅니다:

​
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 스펙을 참조하세요.
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I