Quickstart

Set up Respan

Sign up — Create an account at platform.respan.ai
Create an API key — Generate one on the API keys page
Add credits or a provider key — Add credits on the Credits page or connect your own provider key on the Integrations page

1. Set up your account

2. Set up tracing

Pick the method that matches your stack.

Respan tracing SDK
OpenAI Agents SDK
Anthropic Agents SDK
Vercel AI SDK
Others

Add @workflow and @task decorators to your code. LLM calls are auto-captured.

# pip install respan-tracing
from openai import OpenAI
from respan_tracing.decorators import workflow, task
from respan_tracing.main import RespanTelemetry

k_tl = RespanTelemetry()
client = OpenAI()

@task(name="joke_creation")
def create_joke():
    completion = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": "Tell me a joke about AI"}],
    )
    return completion.choices[0].message.content

@workflow(name="joke_workflow")
def joke_workflow():
    return create_joke()

result = joke_workflow()
print(result)

For advanced features (class-based workflows, override span I/O), see Tracing SDK.

Set Respan as the trace processor for the OpenAI Agents SDK.

# pip install respan-exporter-openai-agents
import asyncio
from agents import Agent, Runner
from agents.tracing import set_trace_processors, trace
from respan_exporter_openai_agents import RespanTraceProcessor

set_trace_processors([
    RespanTraceProcessor(
        api_key=os.getenv("RESPAN_API_KEY"),
        endpoint=os.getenv("RESPAN_OAIA_TRACING_ENDPOINT"),
    ),
])

async def main():
    agent = Agent(
        name="Assistant",
        instructions="You only respond in haikus.",
    )
    with trace("Hello world test"):
        result = await Runner.run(agent, "Tell me about recursion in programming.")
        print(result.final_output)

asyncio.run(main())

For the full setup guide, see OpenAI Agents SDK.

Set Respan as the exporter for the Anthropic Agents SDK.

# pip install respan-exporter-anthropic-agents
import asyncio
from claude_agent_sdk import ClaudeAgentOptions
from respan_exporter_anthropic_agents.respan_anthropic_agents_exporter import (
    RespanAnthropicAgentsExporter,
)

exporter = RespanAnthropicAgentsExporter()

async def main():
    options = exporter.with_options(
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Glob", "Grep"],
            permission_mode="acceptEdits",
        )
    )
    async for message in exporter.query(
        prompt="Analyze this repository and summarize architecture.",
        options=options,
    ):
        print(message)

asyncio.run(main())

For the full setup guide, see Anthropic Agents SDK.

instrumentation.ts

// npm install @respan/exporter-vercel
import { registerOTel } from "@vercel/otel";
import { RespanExporter } from "@respan/exporter-vercel";

export function register() {
  registerOTel({
    serviceName: "next-app",
    traceExporter: new RespanExporter({
      apiKey: process.env.RESPAN_API_KEY,
      baseUrl: process.env.RESPAN_BASE_URL,
      debug: true,
    }),
  });
}

app/api/chat/route.ts

import { openai } from "@ai-sdk/openai";
import { streamText } from "ai";

export async function POST(req: Request) {
  const { messages } = await req.json();

  const result = streamText({
    model: openai("gpt-4o"),
    messages,
    experimental_telemetry: { isEnabled: true },
  });

  return result.toDataStreamResponse();
}

For the full setup guide, see Vercel AI SDK.

3. See your first trace

Open the Traces page in the Respan dashboard. You should see your trace appear within a few seconds.

What’s next

Enrich your spans with customer_identifier, metadata, and thread_identifier.
Set up the gateway to route LLM traffic through one API with fallbacks, retries, and caching.

Get started

Features

Admin

Security

Resources

Help & Community

1. Set up your account

2. Set up tracing

3. See your first trace

What’s next

Get started

Features

Admin

Security

Resources

Help & Community

​1. Set up your account

​2. Set up tracing

​3. See your first trace

​What’s next

1. Set up your account

2. Set up tracing

3. See your first trace

What’s next