Helicone (tracing)

pip install respan-ai respan-instrumentation-helicone "helicone-helpers~=1.2.1" openai

npm install @respan/respan @respan/instrumentation-helicone @helicone/helpers@~1.8.3 openai

import os

from helicone_helpers import HeliconeManualLogger
from openai import OpenAI
from respan import Respan
from respan_instrumentation_helicone import HeliconeInstrumentor

respan = Respan(
    api_key=os.environ["RESPAN_API_KEY"],
    app_name="helicone-manual-logger",
    instrumentations=[HeliconeInstrumentor()],
)

helicone = HeliconeManualLogger(api_key=os.environ["HELICONE_API_KEY"])
openai = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

request = {
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Say hello in three languages."}],
}


def call_model(recorder):
    response = openai.chat.completions.create(**request)
    recorder.append_results(response.model_dump())
    return response


try:
    response = helicone.log_request(
        request=request,
        operation=call_model,
        provider="openai",
        additional_headers={
            "Helicone-User-Id": "user_123",
            "Helicone-Session-Id": "conversation_456",
            "Helicone-Property-Environment": "production",
        },
    )
    print(response.choices[0].message.content)
finally:
    respan.flush()
    respan.shutdown()

import { HeliconeManualLogger } from "@helicone/helpers";
import { HeliconeInstrumentor } from "@respan/instrumentation-helicone";
import { Respan } from "@respan/respan";
import OpenAI from "openai";

const respan = new Respan({
  apiKey: process.env.RESPAN_API_KEY,
  baseURL: process.env.RESPAN_BASE_URL,
  appName: "helicone-manual-logger",
  instrumentations: [new HeliconeInstrumentor()],
});
await respan.initialize();

const helicone = new HeliconeManualLogger({
  apiKey: process.env.HELICONE_API_KEY!,
});
const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

const request = {
  model: "gpt-4o-mini",
  messages: [
    { role: "user" as const, content: "Say hello in three languages." },
  ],
};

try {
  const response = await helicone.logRequest(
    request,
    async (recorder) => {
      const result = await openai.chat.completions.create(request);
      recorder.appendResults(result);
      return result;
    },
    {
      "Helicone-User-Id": "user_123",
      "Helicone-Session-Id": "conversation_456",
      "Helicone-Property-Environment": "production",
    },
    "openai",
  );

  console.log(response.choices[0]?.message.content);
} finally {
  await respan.shutdown();
}