AgentLens Examples

Example scripts demonstrating the AgentLens SDK for tracing and observing AI agent behavior.

Setup

pip install vectry-agentlens

Script	Description
`basic_agent.py`	Simplest usage — init, trace, log decisions, shutdown
`openai_agent.py`	OpenAI integration — wrap the client for automatic LLM call tracing
`multi_agent.py`	Nested traces — planner delegates to researcher, writer, and editor sub-agents
`customer_support_agent.py`	Realistic support workflow — classification, routing, escalation, error handling
`seed_demo_traces.py`	Seeds the live dashboard with 11 realistic traces via direct HTTP POST (no SDK)

Each SDK example follows the same pattern:

# Set your API key and endpoint
export AGENTLENS_API_KEY="your-key"

# Run any example
python examples/basic_agent.py

For the OpenAI example, you also need:

pip install openai
export OPENAI_API_KEY="sk-..."

The seed script sends pre-built traces directly to the API — no SDK or OpenAI key needed:

python examples/seed_demo_traces.py

This populates the dashboard with varied traces (COMPLETED, ERROR, RUNNING) across multiple agent types.