Skip to main content

​
Installation

pip install respan-exporter-anthropic-agents

​
Classes

​
RespanAnthropicAgentsExporter

Main exporter that hooks into the Anthropic Agent SDK via lifecycle hooks. 
from respan_exporter_anthropic_agents import RespanAnthropicAgentsExporter
ParameterTypeDefaultDescription
api_keystr | NoneNoneRespan API key. Falls back to RESPAN_API_KEY env var.
base_urlstr | NoneNoneAPI base URL. Falls back to RESPAN_BASE_URL.
endpointstr | NoneNoneIngest endpoint URL.

​
Methods

MethodDescription
create_hooks(existing_hooks)Create Respan instrumentation hooks to attach to agent options.
with_options(options)Attach Respan hooks to agent SDK options. Returns modified options.
query(prompt, options)Wrapped Claude query with automatic tracking.
track_message(message, session_id, prompt)Track individual messages.

​
Hook callbacks

The exporter captures agent lifecycle events:
HookCaptures
on_user_prompt_submitUser prompts
on_pre_tool_useTool call inputs
on_post_tool_useTool call results
on_subagent_stopSub-agent completions
on_stopAgent run completions

​
Usage

from claude_agent_sdk import create_agent
from respan_exporter_anthropic_agents import RespanAnthropicAgentsExporter

exporter = RespanAnthropicAgentsExporter(api_key="your-api-key")

options = exporter.with_options({
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
})

agent = create_agent(options)
result = agent.query("Tell me a joke")
print(result)