Wrap unsupported framework

SDK 0.4.0 Wrapping a framework’s top-level call with traced or wrapTraced in atlanai SDK guarantees the agent boundary, input, output, latency, and failure. Use it when the framework emits no usable spans. Calls from instrumented providers inside the wrapper become child spans automatically.

Before you begin

Before you start, make sure you have:

SDK: atlanai SDK installed with tracing, as in Install atlanai SDK.
Tracing: init_logger or initLogger configured, as in Trace first agent run.

Wrap top-level call

Python
TypeScript

from atlanai.tracing import traced

@traced(name="agent.run", type="task")
def run_agent(input):
    return agent.run(input)

import { wrapTraced } from "@atlanai/sdk/tracing";

const runAgent = wrapTraced(agent.run.bind(agent), { name: "agent.run", type: "task" });

const result = await runAgent(input);

Add detail you own

Manual wrapping cannot invent model, tool, token, or cost details that the framework does not expose. Add child spans or span.update(...) calls for those fields where you own the call site, as in Create spans for agent run.

Verify trace

Run one request, flush, and open the trace in Agent Registry. Confirm the root span, provider calls, tool calls, usage, and parent relationships.If no trace appears, see init() disables tracing and no traces are exported.

Troubleshooting

If traces do not appear, see Install and setup errors.

Next steps

Create spans for agent run: add typed spans, usage, and cost inside the wrapper.

Import traces

Attribute runs

Troubleshoot

Before you begin

Troubleshooting

Next steps

See also

​Before you begin

​Troubleshooting

​Next steps

​See also

Before you begin

Troubleshooting

Next steps

See also