Python SDK tutorial

import os
import trulayer

trulayer.init(
    api_key=os.environ["TRULAYER_API_KEY"],
    project_name="tutorial",   # any string — creates projects on first use
    environment="development", # free-form; used as a filter in the dashboard
)

import trulayer

with trulayer.trace("answer_question") as trace:
    trace.set_input({"question": "What is TruLayer?"})

    answer = my_agent(question)

    trace.set_output({"answer": answer})

with trulayer.trace("answer_question") as trace:
    trace.set_input({"question": question})

    with trace.span("retrieve", span_type="retrieval") as span:
        docs = vector_store.search(question, k=5)
        span.set_output({"doc_count": len(docs)})

    with trace.span("generate", span_type="llm") as span:
        span.set_model("gpt-4o-mini")
        response = generate_with_context(question, docs)
        span.set_output(response)

    trace.set_output({"answer": response})

from openai import OpenAI
import trulayer

client = OpenAI()
trulayer.instrument_openai(client)

with trulayer.trace("answer_question") as trace:
    trace.set_input({"question": question})
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": question}],
    )
    trace.set_output(response.choices[0].message.content)

from anthropic import Anthropic
import trulayer

client = Anthropic()
trulayer.instrument_anthropic(client)

with trulayer.trace("answer_question"):
    message = client.messages.create(
        model="claude-sonnet-4-6",
        max_tokens=1024,
        messages=[{"role": "user", "content": question}],
    )

from langchain_openai import ChatOpenAI
import trulayer

handler = trulayer.instrument_langchain()

llm = ChatOpenAI(model="gpt-4o-mini", callbacks=[handler])
chain = prompt_template | llm

with trulayer.trace("summarize"):
    result = chain.invoke({"text": long_text})

import asyncio
import trulayer
from openai import AsyncOpenAI

client = AsyncOpenAI()
trulayer.instrument_openai(client)

async def handle(question: str):
    async with trulayer.atrace("answer_question") as trace:
        trace.set_input({"question": question})
        response = await client.chat.completions.create(
            model="gpt-4o-mini",
            messages=[{"role": "user", "content": question}],
        )
        trace.set_output(response.choices[0].message.content)

with trulayer.trace("user_message", session_id=conversation_id) as trace:
    ...

with trulayer.trace("answer_question") as trace:
    trace.set_metadata(
        user_id="u_42",
        tier="pro",
        feature_flag_rag_v2=True,
    )

import trulayer

client = trulayer.get_client()
client.submit_feedback(
    trace_id=trace_id,
    label="good",
    score=0.95,
    comment="Exactly what I needed.",
)

import re

def scrub(value):
    if isinstance(value, str):
        return re.sub(r"\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b", "[email]", value, flags=re.I)
    return value

trulayer.init(
    api_key=os.environ["TRULAYER_API_KEY"],
    project_name="prod",
    scrub_fn=scrub,
)

import atexit
import trulayer

trulayer.init(api_key="...", project_name="...")
atexit.register(trulayer.shutdown)