import type { Metadata } from "next"; import { CodeBlock } from "@/components/code-block"; export const metadata: Metadata = { title: "Getting Started", description: "Install AgentLens, initialize the SDK, and send your first trace in under five minutes.", }; export default function GettingStartedPage() { return (

Getting Started

Go from zero to full agent observability in under five minutes. This guide walks you through installing the SDK, initializing it, and sending your first trace.

Prerequisites

Step 1: Install the SDK

Python

pip install vectry-agentlens

TypeScript / Node.js

npm install agentlens-sdk

Step 2: Initialize AgentLens

Sign up at{" "} agentlens.vectry.tech , then go to{" "} Dashboard → API Keys {" "} to create your key. Pass it to the SDK during initialization:

Python

{`import agentlens agentlens.init( api_key="your-api-key", endpoint="https://agentlens.vectry.tech" )`}

TypeScript

{`import { init } from "agentlens-sdk"; init({ apiKey: "your-api-key", endpoint: "https://agentlens.vectry.tech", });`}

Step 3: Trace your first agent

Python

{`import agentlens from agentlens import trace agentlens.init( api_key="your-api-key", endpoint="https://agentlens.vectry.tech" ) @trace(name="my-first-agent") def my_agent(prompt: str) -> str: # Your agent logic here response = call_llm(prompt) return response # Run it — the trace is sent automatically result = my_agent("What is the capital of France?")`}

TypeScript

{`import { init, TraceBuilder } from "agentlens-sdk"; init({ apiKey: "your-api-key", endpoint: "https://agentlens.vectry.tech", }); const trace = new TraceBuilder("my-first-agent"); trace.addSpan({ name: "llm-call", type: "LLM_CALL", input: { prompt: "What is the capital of France?" }, output: { response: "Paris" }, status: "COMPLETED", }); await trace.end();`}

Step 4: View in the dashboard

Open your AgentLens dashboard to see the trace you just sent. You will see the trace name, its status, timing information, and any spans or decision points you recorded.

Open Dashboard

Next steps

Core Concepts

Learn about Traces, Spans, Decision Points, and Events.

Python SDK Reference

Explore the full Python SDK API surface.

OpenAI Integration

Auto-trace OpenAI calls with a single wrapper.

Self-Hosting

Deploy your own AgentLens instance with Docker.

); }