LangSmith UI 目前不支持删除单个跟踪。但是,这可以通过直接从 ClickHouse 中的所有物化视图(runs_history 视图除外)以及运行和反馈表本身中删除跟踪来完成。 此命令可以使用跟踪 ID 作为参数运行,也可以使用跟踪 ID 列表的文件运行。

前提条件

确保已准备好以下工具/项目。
  1. kubectl
  2. Clickhouse 数据库凭据
    • 主机
    • 端口
    • 用户名
      • 如果使用捆绑版本,这是 default
    • 密码
      • 如果使用捆绑版本,这是 password
    • 数据库名称
      • 如果使用捆绑版本,这是 default
  3. 从您将运行 delete_trace_by_id 脚本的机器到 Clickhouse 数据库的连接。
    • 如果您使用捆绑版本,可能需要将 clickhouse 服务端口转发到本地机器。
    • 运行 kubectl port-forward svc/langsmith-clickhouse 8123:8123 将 clickhouse 服务端口转发到本地机器。
  4. 删除跟踪的脚本
    • 您可以从此处下载脚本

为单个跟踪运行删除脚本

运行以下命令以使用单个跟踪 ID 运行跟踪删除脚本:
sh delete_trace_by_id.sh <clickhouse_url> --trace_id <trace_id>
例如,如果您使用带有端口转发的捆绑版本,命令将如下所示:
sh delete_trace_by_id.sh "clickhouse://default:password@localhost:8123/default" --trace_id 4ec70ec7-0808-416a-b836-7100aeec934b
如果您访问 LangSmith UI,现在应该看到指定的跟踪 ID 不再存在,也不反映在统计信息中。

从每行一个跟踪 ID 的文件为多个跟踪运行删除脚本

运行以下命令以使用跟踪 ID 列表运行跟踪删除脚本:
sh delete_trace_by_id.sh <clickhouse_url> --file <path/to/foo.txt>
例如,如果您使用带有端口转发的捆绑版本,命令将如下所示:
sh delete_trace_by_id.sh "clickhouse://default:password@localhost:8123/default" --file path/to/traces.txt
如果您访问 LangSmith UI,现在应该看到所有指定的跟踪都已被删除。
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.