AgentOps (tracing)

AgentOps provides OpenTelemetry-backed decorators for tracing agent applications. Respan uses the spans AgentOps already creates, translates its native kinds and content into the Respan span contract, and exports them through the active Respan pipeline.

Setup

$
pip install respan-ai respan-instrumentation-agentops agentops

$
export RESPAN_API_KEY="YOUR_RESPAN_API_KEY"

1
from agentops import guardrail, task, tool, trace, workflow
2
from respan import Respan
3
from respan_instrumentation_agentops import AgentOpsInstrumentor
4
5
respan = Respan(
6
    instrumentations=[AgentOpsInstrumentor()],
7
)
8
9
10
@guardrail
11
def validate_city(city: str) -> str:
12
    if not city:
13
        raise ValueError("city is required")
14
    return city
15
16
17
@tool
18
def lookup_temperature(city: str) -> dict[str, object]:
19
    return {"city": city, "temperature_c": 21}
20
21
22
@task
23
def format_forecast(payload: dict[str, object]) -> str:
24
    return f"{payload['city']}: {payload['temperature_c']} C"
25
26
27
@workflow
28
def weather_workflow(city: str) -> str:
29
    return format_forecast(lookup_temperature(validate_city(city)))
30
31
32
@trace
33
def run() -> str:
34
    return weather_workflow("Paris")
35
36
37
try:
38
    print(run())
39
finally:
40
    respan.shutdown()

What gets traced

The integration adapts the span kinds emitted by the installed AgentOps SDK.

The adapter promotes only attributes AgentOps actually emits. It does not synthesize model, token, tool-call, or response fields for decorator kinds that do not provide them.

Content controls

Content capture is enabled by default. Disable it when decorator arguments or results may contain sensitive data:

1
from respan import Respan
2
from respan_instrumentation_agentops import AgentOpsInstrumentor
3
4
respan = Respan(
5
    instrumentations=[AgentOpsInstrumentor(capture_content=False)]
6
)

Operation names, kinds, tags, end state, and success/error status remain available.

Lifecycle

AgentOpsInstrumentor connects AgentOps’ tracing core to the active Respan tracer provider without starting AgentOps’ exporter or metrics pipeline. activate() and deactivate() are reference-counted across instrumentor instances, and Respan retains ownership of tracer-provider shutdown.

Initialize Respan before the first decorated call. Call respan.shutdown() during application shutdown to flush pending spans and restore the prior AgentOps tracing state.