指定自定义运行ID

默认情况下，LangSmith会为每次运行分配一个随机ID。当你需要以下情况时，可以覆盖此默认行为，使用自定义ID：

提前知道运行ID（例如，为了在运行后立即附加反馈）。
将LangSmith运行与外部系统的ID关联起来。
通过重用确定性ID使运行具有幂等性。

我们建议使用 UUID v7 作为自定义运行ID。UUIDv7嵌入了时间戳，这能确保追踪中运行的正确时间顺序。目前传递非UUIDv7的ID会发出警告，并且在未来版本中将成为强制要求。LangSmith SDK导出了一个uuid7辅助函数（Python v0.4.43+，JS v0.3.80+）：

Python：from langsmith import uuid7
JS/TS：import { uuid7 } from 'langsmith'

任何UUID v7字符串都是可接受的。你可以传递由LangSmith SDK辅助函数生成的ID，或者如果你的系统已经使用UUID v7标识符，也可以传递你自己的ID。

Python
TypeScript

使用 `@traceable`

在调用带有 [@traceable](https://reference.langchain.com/python/langsmith/run_helpers/traceable) 装饰器的函数时，通过 langsmith_extra 传递 run_id：

Python

from langsmith import traceable, uuid7

@traceable
def my_pipeline(question: str) -> str:
    return "answer"

run_id = uuid7()
my_pipeline("What is the capital of France?", langsmith_extra={"run_id": run_id})

# 现在可以使用 run_id 来附加反馈、查询运行等。

使用 `trace` 上下文管理器

将 run_id 直接传递给 trace 上下文管理器的构造函数，为该追踪块设置ID：

Python

from langsmith import trace, uuid7

run_id = uuid7()

with trace("my-pipeline", run_id=run_id) as run:
    result = "answer"
    run.end(outputs={"result": result})

# 现在可以使用 run_id 来附加反馈、查询运行等。

使用 `traceable`

在传递给 traceable 的配置对象中传递 id：

TypeScript

import { traceable } from "langsmith/traceable";
import { uuid7 } from "langsmith";

const runId = uuid7();

const myPipeline = traceable(
  async (question: string) => {
    return "answer";
  },
  { name: "my-pipeline", id: runId }
);

await myPipeline("What is the capital of France?");

// 现在可以使用 runId 来附加反馈、查询运行等。

Tracing setup

Configuration & troubleshooting

Viewing & managing traces

Automations

Feedback & evaluation

Monitoring & alerting

Data type reference

使用 `@traceable`

使用 `trace` 上下文管理器

使用 `traceable`

相关链接

Tracing setup

Configuration & troubleshooting

Viewing & managing traces

Automations

Feedback & evaluation

Monitoring & alerting

Data type reference

​使用 @traceable

​使用 trace 上下文管理器

​使用 traceable

​相关链接

使用 `@traceable`

使用 `trace` 上下文管理器

使用 `traceable`

相关链接