Quick Start

python -m pip install sentrial

npm install @sentrial/sdk

import os
from sentrial import SentrialClient

client = SentrialClient(
    api_key=os.environ["SENTRIAL_API_KEY"],
    fail_silently=False,
)
try:
    with client.begin(
        user_id="quickstart-example",
        event="quickstart-example",
        input="What is 2 + 3?",
        metadata={"synthetic": True},
    ) as run:
        if not run.session_id:
            raise RuntimeError("Sentrial did not acknowledge the session.")
        result = 2 + 3
        run.track_tool_call(
            tool_name="add",
            tool_input={"a": 2, "b": 3},
            tool_output={"result": result},
        )
        run.set_output(str(result))
    client.flush()
    print("Session ID:", run.session_id)
finally:
    client.shutdown()

import { SentrialClient } from '@sentrial/sdk';

const client = new SentrialClient({
  apiKey: process.env.SENTRIAL_API_KEY,
  apiUrl: process.env.SENTRIAL_API_URL,
  failSilently: false,
});
try {
  const run = await client.begin({
    userId: 'quickstart-example',
    event: 'quickstart-example',
    input: 'What is 2 + 3?',
    metadata: { synthetic: true },
  });
  const sessionId = run.getSessionId();
  if (!sessionId) throw new Error('Sentrial did not acknowledge the session.');
  const result = 2 + 3;
  await run.trackToolCall({
    toolName: 'add',
    toolInput: { a: 2, b: 3 },
    toolOutput: { result },
  });
  await run.finish({ output: String(result), success: true });
  await client.flush();
  console.log('Session ID:', sessionId);
} finally {
  await client.shutdown();
}

python first_trace.py

node first-trace.mjs