> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zespan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zespan: Agent Observability for Production AI

> Zespan gives you complete visibility into every agent run, tool call, and LLM interaction. Trace multi-agent systems, monitor costs, debug failures, and optimize your AI operations in one dashboard.

Zespan is an **agent observability platform** that helps you understand exactly what your AI agents are doing in production. Instrument your agents with two lines of code, then explore real-time traces, costs, tool call histories, and AI-powered insights in the Zespan dashboard.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Instrument your first agent and see a trace in the dashboard in under 5 minutes.
  </Card>

  <Card title="Core concepts" icon="lightbulb" href="/concepts">
    Understand traces, spans, span kinds, projects, and the agent observability data model.
  </Card>

  <Card title="TypeScript SDK" icon="js" href="/sdk/typescript">
    Wrap OpenAI, Anthropic, Google, and other clients. Full agent tracing with `withAgent`.
  </Card>

  <Card title="Python SDK" icon="python" href="/sdk/python">
    Patch your Python LLM clients and use `with_agent` for multi-step agent tracing.
  </Card>

  <Card title="LangChain" icon="link" href="/sdk/integrations/langchain">
    Full chain, agent executor, and retriever tracing with `ZespanCallbackHandler`.
  </Card>

  <Card title="Google ADK" icon="bot" href="/sdk/integrations/google-adk">
    Multi-agent tracing with `instrumentADK`, `wrapADKRunner`, or `wrapADKAgent`.
  </Card>
</CardGroup>

## Get started in 3 steps

<Steps>
  <Step title="Create a project and get your API key">
    Sign up at [app.zespan.com](https://app.zespan.com), create an organization, and create your first project. Your project API key (`zsp_...`) is shown once on creation — copy it now.
  </Step>

  <Step title="Install the SDK and instrument your agent">
    Install `@zespan/sdk` (Node.js) or `zespan` (Python), initialize with your API key, and wrap your existing clients or agent frameworks. No changes to your agent logic required.

    ```typescript theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
    import { zespan, withAgent } from "@zespan/sdk";
    import OpenAI from "openai";

    zespan.init({ apiKey: process.env.ZESPAN_API_KEY!, environment: "production" });
    const openai = zespan.wrapOpenAI(new OpenAI());
    ```
  </Step>

  <Step title="View your agent trace in the dashboard">
    Run your agent. Within seconds, the full trace appears in Zespan with a flame graph showing every agent turn, tool call, and LLM interaction — with cost and latency for each step.
  </Step>
</Steps>

<Note>
  Zespan adds zero latency to your agent runs. All telemetry is batched and flushed asynchronously — your agents are never blocked waiting for observability data to be sent.
</Note>