README.md

@braintrust/openai-agents

SDK for integrating Braintrust with OpenAI Agents.

Installation

npm install braintrust @braintrust/openai-agents @openai/agents
# or
yarn add braintrust @braintrust/openai-agents @openai/agents
# or
pnpm add braintrust @braintrust/openai-agents @openai/agents

Requirements

• braintrust
• @openai/agents

Quickstart

import { initLogger } from "braintrust";
import { OpenAIAgentsTraceProcessor } from "@braintrust/openai-agents";
import { Agent, run, addTraceProcessor } from "@openai/agents";

// Initialize Braintrust logger
const logger = initLogger({
  projectName: "my-agents-project",
});

// Create the tracing processor
const processor = new OpenAIAgentsTraceProcessor({ logger });

// Add the processor to OpenAI Agents
addTraceProcessor(processor);

// Create and run your agent
const agent = new Agent({
  name: "my-agent",
  model: "gpt-4o-mini",
  instructions: "You are a helpful assistant.",
});

const result = await run(agent, "Hello, world!");

API

OpenAIAgentsTraceProcessor

A tracing processor that logs traces from the OpenAI Agents SDK to Braintrust.

Constructor

new OpenAIAgentsTraceProcessor(options?: OpenAIAgentsTraceProcessorOptions)

Options:

• logger?: Logger - A Braintrust Span, Experiment, or Logger to use for logging. If undefined, the current span, experiment, or logger will be selected exactly as in startSpan.
• maxTraces?: number - Maximum number of concurrent traces to keep in memory (default: 10000). When exceeded, oldest traces are evicted using LRU policy to prevent memory leaks.

Documentation

• Braintrust docs: https://www.braintrust.dev/docs
• OpenAI Agents docs: https://openai.github.io/openai-agents-js/