跳到主要内容
在深入了解此内容之前,阅读以下内容可能会有所帮助
LangSmith 以一种简单的格式存储和处理跟踪数据,易于导出和导入。 其中许多字段是可选的或不重要,但为了完整性而包含在内。加粗的字段是最重要的。
字段名称类型描述
idUUIDSpan 的唯一标识符。
名称字符串与运行相关的名称。
输入对象提供给运行的输入映射或集合。
run_type字符串运行类型,例如“llm”、“chain”、“tool”。
start_timedatetime运行的开始时间。
end_timedatetime运行的结束时间。
extra对象运行的任何额外信息。
错误字符串如果运行遇到错误,则为错误消息。
输出对象运行生成的输出映射或集合。
events对象数组与运行相关的事件对象列表。这与启用流式传输的运行相关。
tags字符串数组与运行相关的标签或标记。
trace_idUUID运行所属跟踪的唯一标识符。这也是跟踪根运行的 id 字段
dotted_order字符串排序字符串,分层。格式:run_start_timeZrun_uuid.child_run_start_timeZchild_run_uuid
状态字符串运行执行的当前状态,例如“error”、“pending”、“success”
child_run_idsUUID 数组所有子运行的 ID 列表。
direct_child_run_idsUUID 数组此运行的直接子项的 ID 列表。
parent_run_idsUUID 数组所有父运行的 ID 列表。
feedback_stats对象此运行的反馈统计聚合
reference_example_idUUID与运行关联的参考示例的 ID。这通常只存在于评估运行中。
total_tokens整数运行处理的总令牌数。
prompt_tokens整数运行提示中的令牌数。
completion_tokens整数运行完成中的令牌数。
total_cost字符串与处理运行相关的总成本。
prompt_cost字符串与运行提示部分相关的成本。
completion_cost字符串与运行完成相关的成本。
first_token_timedatetime生成模型输出第一个令牌的时间。仅适用于 run_type="llm" 且启用流式传输的运行。
session_id字符串运行的会话标识符,也称为跟踪项目 ID。
in_dataset布尔值指示运行是否包含在数据集中。
parent_run_idUUID父运行的唯一标识符。
execution_order(已弃用)整数此运行在跟踪中的执行顺序。
serialized对象如果适用,执行运行的对象的序列化状态。
manifest_id(已弃用)UUID与 Span 关联的清单的标识符。
manifest_s3_idUUID清单的 S3 标识符。
inputs_s3_urls对象输入的 S3 URL。
outputs_s3_urls对象输出的 S3 URL。
price_model_idUUID应用于运行的定价模型的标识符。
app_path字符串此运行的应用程序 (UI) 路径。
last_queued_atdatetimeSpan 最后一次排队的时间。
share_token字符串用于共享运行数据访问的令牌。
以下是上述格式运行的 JSON 表示示例
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "inputs": {},
  "run_type": "llm",
  "start_time": "2024-04-29T00:49:12.090000",
  "end_time": "2024-04-29T00:49:12.459000",
  "extra": {},
  "error": "string",
  "execution_order": 1,
  "serialized": {},
  "outputs": {},
  "parent_run_id": "f8faf8c1-9778-49a4-9004-628cdb0047e5",
  "manifest_id": "82825e8e-31fc-47d5-83ce-cd926068341e",
  "manifest_s3_id": "0454f93b-7eb6-4b9d-a203-f1261e686840",
  "events": [{}],
  "tags": ["foo"],
  "inputs_s3_urls": {},
  "outputs_s3_urls": {},
  "trace_id": "df570c03-5a03-4cea-8df0-c162d05127ac",
  "dotted_order": "20240429T004912090000Z497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "status": "string",
  "child_run_ids": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"],
  "direct_child_run_ids": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"],
  "parent_run_ids": ["f8faf8c1-9778-49a4-9004-628cdb0047e5"],
  "feedback_stats": {
    "correctness": {
      "n": 1,
      "avg": 1.0
    }
  },
  "reference_example_id": "9fb06aaa-105f-4c87-845f-47d62ffd7ee6",
  "total_tokens": 0,
  "prompt_tokens": 0,
  "completion_tokens": 0,
  "total_cost": "string",
  "prompt_cost": "string",
  "completion_cost": "string",
  "price_model_id": "0b5d9575-bec3-4256-b43a-05893b8b8440",
  "first_token_time": null,
  "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
  "app_path": "string",
  "last_queued_at": null,
  "in_dataset": true,
  "share_token": "d0430ac3-04a1-4e32-a7ea-57776ad22c1c"
}

什么是 dotted_order

运行的点序是一个可排序的键,它完全指定了其在跟踪层次结构中的位置。 请看以下示例:
import langsmith as ls

@ls.traceable
def grandchild():
    p("grandchild")

@ls.traceable
def child():
    grandchild()

@ls.traceable
def parent():
    child()
如果您打印出每个阶段的 ID,您可能会得到以下结果
parent	run_id=0e01bf50-474d-4536-810f-67d3ee7ea3e7	trace_id=0e01bf50-474d-4536-810f-67d3ee7ea3e7  parent_run_id=null	dotted_order=20240919T171648521691Z0e01bf50-474d-4536-810f-67d3ee7ea3e7
child	run_id=a8024e23-5b82-47fd-970e-f6a5ba3f5097	trace_id=0e01bf50-474d-4536-810f-67d3ee7ea3e7  parent_run_id=0e01bf50-474d-4536-810f-67d3ee7ea3e7	dotted_order=20240919T171648521691Z0e01bf50-474d-4536-810f-67d3ee7ea3e7.20240919T171648523407Za8024e23-5b82-47fd-970e-f6a5ba3f5097
grandchild	run_id=0ec6b845-18b9-4aa1-8f1b-6ba3f9fdefd6	trace_id=0e01bf50-474d-4536-810f-67d3ee7ea3e7  parent_run_id=a8024e23-5b82-47fd-970e-f6a5ba3f5097	dotted_order=20240919T171648521691Z0e01bf50-474d-4536-810f-67d3ee7ea3e7.20240919T171648523407Za8024e23-5b82-47fd-970e-f6a5ba3f5097.20240919T171648523563Z0ec6b845-18b9-4aa1-8f1b-6ba3f9fdefd6
请注意一些不变性
  • “id”等于点序的最后 36 个字符(最终“Z”后的后缀)。例如,在孙子中查看 0ec6b845-18b9-4aa1-8f1b-6ba3f9fdefd6
  • “trace_id”等于点序中的第一个 UUID(即 dotted_order.split('.')[0].split('Z')[1]
  • 如果“parent_run_id”存在,它是点序中倒数第二个 UUID。例如,在孙子中查看 a8024e23-5b82-47fd-970e-f6a5ba3f5097
  • 如果将 dotted_order 按点分割,每个段的格式为 (<run_start_time>Z<run_id>)

以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.