Documentation Index
Fetch the complete documentation index at: https://langchain-zh.cn/llms.txt
Use this file to discover all available pages before exploring further.
在继续本指南之前，请先阅读 LangSmith 架构概述 和 连接外部 ClickHouse 的指南。
架构概述
将 LangSmith 托管的 ClickHouse 与您的自托管 LangSmith 实例结合使用的架构，与使用完全自托管的 ClickHouse 实例类似，但有几个关键区别：- 您需要在您的 LangSmith 实例和 LangSmith 托管的 ClickHouse 实例之间建立私有网络连接。这是为了确保您的数据安全，并且您可以从自托管的 LangSmith 实例连接到 ClickHouse 实例。
- 使用此选项时，追踪的敏感信息（输入和输出）将存储在您云环境内的云对象存储（S3 或 GCS）中，而不是 ClickHouse 中，以确保敏感信息不会离开您的 VPC。有关特定数据字段存储位置的更多详细信息，请参阅数据存储。
- LangSmith 团队将监控您的 ClickHouse 实例，并确保其平稳运行。这使我们能够跟踪诸如运行摄取延迟和查询性能等指标。
要求
- 您必须使用受支持的 Blob 存储选项。 请阅读 Blob 存储指南 了解更多信息。
- 要使用私有端点，请确保您的 VPC 位于 ClickHouse Cloud 支持的区域中。否则，您将需要使用一个我们将通过防火墙规则进行保护的公共端点。您的 VPC 需要有一个 NAT 网关，以便我们能够将您的流量加入允许列表。
- 您必须拥有一个可以连接到 LangSmith 托管 ClickHouse 服务的 VPC。您需要与我们的团队合作来设置必要的网络。
- 您必须运行一个 LangSmith 自托管实例。您可以将我们的托管 ClickHouse 服务与 Kubernetes 和 Docker 安装一起使用。
数据存储
ClickHouse 存储运行和反馈数据，具体包括：- 所有反馈数据字段。
- 部分运行数据字段。
inputs、outputs、errors、manifests、extras 和 events，因为这些字段可能包含 LLM 提示词和补全。使用 LangSmith 托管的 ClickHouse 时，这些敏感字段存储在您云环境内的云对象存储（S3 或 GCS）中，而运行数据的其余部分存储在 ClickHouse 中，确保敏感信息永远不会离开您的 VPC。
存储的反馈数据字段
由于所有反馈数据都存储在 ClickHouse 中，请勿在反馈（分数和注释/评论）或存储的运行数据字段中提到的任何其他运行字段中发送敏感信息。
| 字段名称 | 类型 | 描述 |
|---|---|---|
id | UUID | 记录本身的唯一标识符 |
created_at | datetime | 记录创建的时间戳 |
modified_at | datetime | 记录最后修改的时间戳 |
session_id | UUID | 运行所属的实验或追踪项目的唯一标识符 |
run_id | UUID | 会话内特定运行的唯一标识符 |
key | string | 描述反馈标准的键，例如 'correctness' |
score | number | 与反馈键关联的数值分数 |
value | string | 保留用于存储与分数关联的值。适用于分类反馈。 |
comment | string | 与记录相关的任何注释或注解。这可以是给定分数的理由。 |
correction | object | 保留用于存储更正详情，如果有的话 |
feedback_source | object | 包含有关反馈源信息的对象 |
feedback_source.type | string | 反馈来源的类型，例如 'api', 'app', 'evaluator' |
feedback_source.metadata | object | 保留用于附加元数据，目前 |
feedback_source.user_id | UUID | 提供反馈的用户的唯一标识符 |
存储的运行数据字段
运行数据字段在托管的 ClickHouse 数据库和您的云对象存储（例如 S3 或 GCS）之间拆分存储。对于存储在对象存储中的运行字段，ClickHouse 中仅保留引用或指针。例如，
inputs 和 outputs 的内容被卸载到 S3/GCS，ClickHouse 记录在 inputs_s3_urls 和 outputs_s3_urls 字段中存储相应的 S3 URL。| 字段 | 存储位置 |
|---|---|
id | ClickHouse |
name | ClickHouse |
inputs | 对象存储 |
run_type | ClickHouse |
start_time | ClickHouse |
end_time | ClickHouse |
extra | 对象存储 |
error | 对象存储 |
outputs | 对象存储 |
events | 对象存储 |
tags | ClickHouse |
trace_id | ClickHouse |
dotted_order | ClickHouse |
status | ClickHouse |
child_run_ids | ClickHouse |
direct_child_run_ids | ClickHouse |
parent_run_ids | ClickHouse |
feedback_stats | ClickHouse |
reference_example_id | ClickHouse |
total_tokens | ClickHouse |
prompt_tokens | ClickHouse |
completion_tokens | ClickHouse |
total_cost | ClickHouse |
prompt_cost | ClickHouse |
completion_cost | ClickHouse |
first_token_time | ClickHouse |
session_id | ClickHouse |
in_dataset | ClickHouse |
parent_run_id | ClickHouse |
execution_order (已弃用) | ClickHouse |
serialized | ClickHouse |
manifest_id (已弃用) | ClickHouse |
manifest_s3_id | ClickHouse |
inputs_s3_urls | ClickHouse |
outputs_s3_urls | ClickHouse |
price_model_id | ClickHouse |
app_path | ClickHouse |
last_queued_at | ClickHouse |
share_token | ClickHouse |
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.