---
title: "Braintrust integration for LuumenAI"
url: "https://www.luumen.ai/integrations/braintrust/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Braintrust integration for LuumenAI

Read Braintrust experiments and logs, then write datasets back as approved steps

## What LuumenAI can do with Braintrust

LuumenAI connects to Braintrust with an API token and exposes 17 tools (5 read-only · 10 write · 2 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 17 tools (5 read-only · 10 write · 2 destructive)
- Plan: available on all plans
- Category: AI & automation

## About Braintrust with LuumenAI

Connect Braintrust and your agent can read the projects, experiments, datasets, prompts, and functions your API key can see. It can page through log events, run bounded BTQL queries, and pull aggregate summaries for an experiment. Changes — new datasets, prompt versions, inserted events, metadata edits — are previewed and approved before they land.

## Example tools

Read-only (5 in total):

- `BRAINTRUST_FETCH_EVENTS` — Fetch one newest-to-oldest page of project log, experiment, or dataset events.
- `BRAINTRUST_GET_RESOURCE` — Get one project, experiment, dataset, prompt, or function by UUID.
- `BRAINTRUST_LIST_RESOURCES` — List and filter one page of projects, experiments, datasets, prompts, or functions visible to the connected Braintrust API key.
- `BRAINTRUST_QUERY_DATA` — Run one bounded synchronous read-only BTQL query over Braintrust project logs, an experiment, or a dataset.
- `BRAINTRUST_SUMMARIZE_RESOURCE` — Return metadata and optional aggregate summaries for one Braintrust experiment or dataset.

Write and destructive (12 in total, approval required by default):

- `BRAINTRUST_CREATE_DATASET` — Create a named dataset under a Braintrust project, or return the existing dataset unchanged when its name already exists in that project.
- `BRAINTRUST_CREATE_EXPERIMENT` — Create an experiment under a Braintrust project.
- `BRAINTRUST_CREATE_PROJECT` — Create a Braintrust project, or return the existing project unchanged when its name already exists.
- `BRAINTRUST_CREATE_PROMPT` — Upsert a versioned prompt configuration under a Braintrust project without invoking it.
- `BRAINTRUST_DELETE_PROJECT` — Soft-delete a Braintrust project and return its deletion state.
- `BRAINTRUST_DELETE_RESOURCE` — Delete one Braintrust experiment, dataset, or prompt by UUID for explicit lifecycle cleanup.
- `BRAINTRUST_INSERT_DATASET_EVENTS` — Upsert a batch of examples into an existing Braintrust dataset.
- `BRAINTRUST_INSERT_EXPERIMENT_EVENTS` — Upsert a batch of result events into an existing Braintrust experiment.

## Frequently asked questions

### How does LuumenAI connect to Braintrust?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Braintrust on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 2 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Braintrust — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/braintrust/