respan-exporter-anthropic-agents 1.0.16

Exporter for Anthropic Agent SDK telemetry to Respan

Respan Exporter for Anthropic Agent SDK

respan.ai | Documentation

Exporter for Anthropic Agent SDK telemetry to Respan.

Respan is a proxy and tracing platform. Your Respan API key authenticates both LLM inference (proxy) and telemetry export (tracing).

Configuration

1. Install

pip install claude-agent-sdk respan-exporter-anthropic-agents

2. Set Environment Variables

Variable	Required	Description
RESPAN_API_KEY	Yes	Your Respan API key. Authenticates both proxy and tracing.
RESPAN_BASE_URL	No	Defaults to https://api.respan.ai.

export RESPAN_API_KEY=your_respan_key
# export RESPAN_BASE_URL=https://api.respan.ai  # default, only override if self-hosting

That's it. Everything else is derived:

• Proxy: ANTHROPIC_BASE_URL = RESPAN_BASE_URL + /api/anthropic
• Auth: ANTHROPIC_API_KEY = RESPAN_API_KEY
• Tracing: The exporter reads RESPAN_API_KEY and RESPAN_BASE_URL automatically.

Quickstart

3. Run Script

Save this as quickstart.py:

import asyncio
import os
from claude_agent_sdk import ClaudeAgentOptions
from respan_exporter_anthropic_agents import RespanAnthropicAgentsExporter

respan_api_key = os.environ["RESPAN_API_KEY"]
respan_base_url = os.getenv("RESPAN_BASE_URL", "https://api.respan.ai")

exporter = RespanAnthropicAgentsExporter()

async def main() -> None:
    options = exporter.with_options(
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Glob", "Grep"],
            permission_mode="acceptEdits",
            env={
                "ANTHROPIC_API_KEY": respan_api_key,
                "ANTHROPIC_BASE_URL": f"{respan_base_url}/api/anthropic",
            },
        )
    )

    async for message in exporter.query(
        prompt="Analyze this repository and summarize architecture.",
        options=options,
    ):
        print(message)

asyncio.run(main())

Run it:

python quickstart.py

4. View Dashboard

Open:

• https://platform.respan.ai/platform/traces

Further Reading

Runnable examples with full setup instructions:

• Python examples root: python/tracing/anthropic-agents-sdk
• Python basic scripts:
  • hello_world_test.py
  • wrapped_query_test.py
  • tool_use_test.py
  • gateway_test.py
• TypeScript examples root: typescript/tracing/anthropic-agents-sdk

Dev Guide

Running Tests

# Unit tests
python -m unittest tests.test_exporter -v

# Live integration test (opt-in, makes real API calls)
export RESPAN_API_KEY="your_respan_key"
export IS_REAL_GATEWAY_TESTING_ENABLED=1
python -m unittest tests.test_real_gateway_integration -v