LangSmith

Deliver live PraisonAI TypeScript traces to LangSmith

LangSmith stores every trace from your agents so you can replay, debug, and share runs — PraisonAI delivers them live over LangSmith’s Runs API.

Quick Start

1. Simple Usage

   import { Agent, createObservabilityAdapter, setObservabilityAdapter } from 'praisonai';
   
   const obs = await createObservabilityAdapter('langsmith');
   setObservabilityAdapter(obs);
   
   const agent = new Agent({
     name: 'TracedAgent',
     instructions: 'You are helpful.',
     observability: true
   });
   
   await agent.chat('Hello!');
   await obs.flush();

2. With Configuration

   import { Agent, createObservabilityAdapter, setObservabilityAdapter } from 'praisonai';
   
   const obs = await createObservabilityAdapter('langsmith', {
     name: 'langsmith',
     apiKey: process.env.LANGSMITH_API_KEY,
     baseUrl: process.env.LANGSMITH_ENDPOINT,   // e.g. https://langsmith.my-company.com
     projectId: 'production-agents'
   });
   setObservabilityAdapter(obs);

How It Works

Spans are posted to LangSmith as runs, asynchronously, while your agent keeps working.

Configuration Options

Secrets are read from the environment only and never logged; programmatic values override the env.

When does delivery happen?

Spans are posted asynchronously; your agent’s hot path never waits for LangSmith. Call await obs.flush() before the process exits (e.g. in a serverless handler) to drain the queue. If a request fails, flush() warns how many runs did not reach LangSmith — the key, endpoint and network are not silently swallowed.

Common Patterns

Multiple agents sharing one trace keep their tree in LangSmith via parent_run_id.

import { Agent, Agents, createObservabilityAdapter, setObservabilityAdapter } from 'praisonai';

const obs = await createObservabilityAdapter('langsmith');
setObservabilityAdapter(obs);

const researcher = new Agent({
  name: 'Researcher',
  instructions: 'Research topics thoroughly.',
  observability: true
});

const writer = new Agent({
  name: 'Writer',
  instructions: 'Write clear summaries.',
  observability: true
});

const agents = new Agents({ agents: [researcher, writer] });
await agents.start('Summarize AI trends 2024');
await obs.flush();

Self-hosted LangSmith is one env var away.

import { Agent, createObservabilityAdapter, setObservabilityAdapter } from 'praisonai';

process.env.LANGSMITH_ENDPOINT = 'https://langsmith.my-company.com';

const obs = await createObservabilityAdapter('langsmith');
setObservabilityAdapter(obs);

const agent = new Agent({
  name: 'InternalAgent',
  instructions: 'You are helpful.',
  observability: true
});

await agent.chat('Hello!');
await obs.flush();

Missing key degrades gracefully: spans record to memory and flush() warns nothing was delivered.

import { createObservabilityAdapter } from 'praisonai';

const obs = await createObservabilityAdapter('langsmith');
console.log(obs.isEnabled);
// false when LANGSMITH_API_KEY is unset — traces stay in memory; safe for local dev.

Best Practices

Related