Trace 查询语法

使用 SDK 中的 list_runs 方法或 API 中的 /runs/query 端点，您可以过滤 runs 以进行分析和导出。

过滤器参数

键	描述
project_id / project_name	从中获取 runs 的项目 - 可以是单个项目或项目列表。
trace_id	获取属于特定 trace 的 runs。
run_type	要获取的 run 类型，例如 llm、chain、tool、retriever 等。
dataset_name / dataset_id	获取与指定数据集中的示例行关联的 runs。这对于比较给定数据集上的 prompts 或模型非常有用。
reference_example_id	获取与特定示例行关联的 runs。这对于比较给定输入上的 prompts 或模型非常有用。
parent_run_id	获取给定 run 的子 runs。这对于获取使用上下文管理器分组在一起的 runs 或获取 agent 轨迹非常有用。
error	获取出错或未出错的 runs。
run_ids	获取具有给定 run id 列表的 runs。注意：这将忽略所有其他过滤参数。
filter	获取与给定结构化过滤器语句匹配的 runs。有关更多信息，请参见下面的指南。
trace_filter	应用于 trace 树中 ROOT run 的过滤器。 这旨在与常规 filter 参数结合使用，以便您可以通过 trace 中根 run 的属性来过滤 runs。
tree_filter	应用于 trace 树中其他 runs 的过滤器，包括同级和子 runs。 这旨在与常规 filter 参数结合使用，以便您可以通过 trace 中任何 run 的属性来过滤 runs。
is_root	仅返回根 runs。
select	选择要在响应中返回的字段。 默认情况下，返回所有字段。
query (实验性)	自然语言查询，它将您的查询转换为过滤器语句。

过滤器查询语言

LangSmith 支持强大的过滤功能，使用过滤器查询语言可以在获取 runs 时执行复杂的过滤操作。

过滤语法基于 run 对象中字段的常见比较器。 支持的比较器包括

• gte (大于或等于)
• gt (大于)
• lte (小于或等于)
• lt (小于)
• eq (等于)
• neq (不等于)
• has (检查 run 是否包含标签或元数据 json blob)
• search (在字符串字段中搜索子字符串)

此外，您可以通过 and 和 or 运算符组合多个比较。

这些可以应用于 run 对象的字段，例如其 id、name、run_type、start_time / end_time、latency、total_tokens、error、execution_order、tags 以及通过 feedback_key 和 feedback_score 关联的任何反馈。