条件追踪

import langsmith as ls
from langsmith import traceable

# 全局设置了 LANGSMITH_TRACING=true

@traceable
def my_function(input_text: str):
    return process(input_text)

# 默认调用 - 会被追踪
result = my_function("regular data")

# 为敏感数据禁用追踪
with ls.tracing_context(enabled=False):
    result = my_function("sensitive data")  # 不被追踪

import langsmith as ls
from langsmith import traceable

@traceable
def my_function(input_text: str):
    return process(input_text)

def client_requires_zero_retention(client_id: str) -> bool:
    """
    检查客户端是否具有零保留策略。

    在生产环境中，这将查询数据库、配置服务或功能开关系统。考虑缓存结果以提高性能。
    """
    # 示例：从数据库或配置中查询
    zero_retention_clients = get_zero_retention_clients()  # 你的实现
    return client_id in zero_retention_clients

def handle_request(client_id: str, user_input: str):
    """
    根据客户端要求处理带有条件追踪的请求。
    """
    should_disable = client_requires_zero_retention(client_id)

    with ls.tracing_context(enabled=not should_disable):
        return my_function(user_input)

# 示例用法
handle_request("client-a", "some input")  # 根据客户端设置决定是否追踪

import langsmith as ls
from langsmith import traceable

@traceable
def my_function(input_text: str):
    return process(input_text)

def handle_request(client_id: str, user_input: str, region: str):
    """
    将追踪路由到特定于客户端的项目，并附带自定义元数据。
    """
    client_tier = get_client_tier(client_id)  # 例如："enterprise"、"standard"

    with ls.tracing_context(
        enabled=True,
        project_name=f"client-{client_id}",
        tags=["production", f"tier-{client_tier}", f"region-{region}"],
        metadata={
            "client_id": client_id,
            "region": region,
            "tier": client_tier
        }
    ):
        return my_function(user_input)

# 追踪数据将发送到 "client-abc" 项目，并带有自定义标签和元数据
handle_request("abc", "some input", "us-west")

import os
import langsmith as ls

# 全局环境变量已设置
os.environ["LANGSMITH_TRACING"] = "true"

@ls.traceable
def process_data(data: str):
    return data.upper()

# 自动追踪（遵循 LANGSMITH_TRACING）
process_data("hello")

# 覆盖全局设置 - 为此调用禁用
with ls.tracing_context(enabled=False):
    process_data("sensitive")  # 不被追踪

# 覆盖全局设置 - 使用自定义配置启用
with ls.tracing_context(
    enabled=True,
    project_name="special-project"
):
    process_data("important")  # 追踪到 "special-project"

import contextlib
import langsmith as ls
from langgraph_sdk.runtime import ServerRuntime


@contextlib.asynccontextmanager
async def make_graph(runtime: ServerRuntime):
    graph = build_my_graph()

    # 你可以使用 tracing_context 动态启用/禁用追踪、
    # 设置元数据或标签、覆盖追踪项目等。
    with ls.tracing_context(enabled=False, metadata={"foo": "bar"}):
        yield graph

import contextlib
import langsmith as ls
from langgraph_sdk.runtime import ServerRuntime

def get_project_for_user(user_id: str) -> str | None:
    ...
    return "my-project"

graph = build_my_graph()

@contextlib.asynccontextmanager
async def make_graph(runtime: ServerRuntime):
    user = runtime.user
    # 根据用户将追踪路由到不同的项目，或完全禁用追踪
    project_name = get_project_for_user(user.identity)

    if project_name is None:
        with ls.tracing_context(enabled=False):
            yield graph
    else:
        with ls.tracing_context(
            enabled=True,
            project_name=project_name,
            metadata={"user_id": user.identity, "foo": "bar"},
        ):
            yield graph