跟踪查询语法

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

筛选参数

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

筛选查询语言

LangSmith 支持强大的筛选功能和筛选查询语言，允许在获取运行时进行复杂的筛选操作。

筛选语法基于运行对象中字段的常见比较器。支持的比较器包括：

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

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

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