使用 SDK 中的方法或 API 中的端点,您可以过滤运行以进行分析和导出。

过滤器参数

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

过滤器查询语言

LangSmith 支持强大的过滤功能,使用过滤器查询语言在获取运行时允许复杂的过滤操作。 过滤语法基于运行对象中字段的常见比较器。支持的比较器包括:
  • gte(大于或等于)
  • gt(大于)
  • lte(小于或等于)
  • lt(小于)
  • eq(等于)
  • neq(不等于)
  • has(检查运行是否包含标签或元数据 json blob)
  • search(在字符串字段中搜索子字符串)
此外,您可以通过 and 运算符组合多个比较。 这些可以应用于运行对象的字段,例如其 idnamerun_typestart_time / end_timelatencytotal_tokenserrorexecution_ordertags,以及通过 feedback_keyfeedback_score 关联的任何反馈。
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.