Users - TraceRoot

Set a User ID on a trace to associate it with a specific user — enabling per-user filtering, cost tracking, and analytics in the dashboard.

TraceRoot dashboard showing traces filtered by user

Using `using_attributes` / `usingAttributes`

Propagate a User ID to all traces within a block:

Python
TypeScript

from traceroot import using_attributes

with using_attributes(user_id="user-42"):
    response = agent.run("What's the weather in SF?")

import { usingAttributes } from '@traceroot-ai/traceroot';

await usingAttributes({ userId: 'user-42' }, async () => {
  await agent.run("What's the weather in SF?");
});

Using `observe` / inside a function

Call update_current_trace / updateCurrentTrace from within any observed function:

Python
TypeScript

from traceroot import observe, update_current_trace

@observe(name="handle_request", type="agent")
def handle_request(query: str, user_id: str):
    update_current_trace(user_id=user_id)
    return process(query)

import { observe, updateCurrentTrace } from '@traceroot-ai/traceroot';

async function handleRequest(query: string, userId: string) {
  return observe({ name: 'handle_request', type: 'agent' }, async () => {
    updateCurrentTrace({ userId });
    return process(query);
  });
}

⌘I