Package dev.braintrust.api

Interface BraintrustApiClient

All Known Implementing Classes:

BraintrustApiClient.HttpImpl, BraintrustApiClient.InMemoryImpl

public interface BraintrustApiClient

Provides the necessary API calls for the Braintrust SDK. Users of the SDK should favor using Eval or BraintrustTracing

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final record	BraintrustApiClient.CreateDatasetRequest
static final record	BraintrustApiClient.CreateExperimentRequest
static final record	BraintrustApiClient.CreateProjectRequest
static final record	BraintrustApiClient.Dataset
static final record	BraintrustApiClient.DatasetEvent
static final record	BraintrustApiClient.DatasetList
static final record	BraintrustApiClient.Experiment
static final record	BraintrustApiClient.ExperimentList
static class	BraintrustApiClient.HttpImpl
static class	BraintrustApiClient.InMemoryImpl	Implementation for test doubling
static final record	BraintrustApiClient.InsertEventsRequest
static final record	BraintrustApiClient.InsertEventsResponse
static final record	BraintrustApiClient.LoginRequest
static final record	BraintrustApiClient.LoginResponse
static final record	BraintrustApiClient.OrganizationAndProjectInfo
static final record	BraintrustApiClient.OrganizationInfo
static final record	BraintrustApiClient.Project
static final record	BraintrustApiClient.ProjectList
static final record	BraintrustApiClient.Prompt
static final record	BraintrustApiClient.PromptData
static final record	BraintrustApiClient.PromptListResponse

Method Summary

Modifier and Type	Method	Description
BraintrustApiClient.Experiment	getOrCreateExperiment(BraintrustApiClient.CreateExperimentRequest request)	Creates an experiment.
BraintrustApiClient.Project	getOrCreateProject(String projectName)	Creates or gets a project by name.
BraintrustApiClient.OrganizationAndProjectInfo	getOrCreateProjectAndOrgInfo(BraintrustConfig config)	Get project and org info for the given config.
Optional<BraintrustApiClient.Project>	getProject(String projectId)	Gets a project by ID.
Optional<BraintrustApiClient.OrganizationAndProjectInfo>	getProjectAndOrgInfo()	Get project and org info for the default project ID
Optional<BraintrustApiClient.OrganizationAndProjectInfo>	getProjectAndOrgInfo(String projectId)	Get project and org info for the given project ID
Optional<BraintrustApiClient.Prompt>	getPrompt(String projectName, String slug, String version)	Get a prompt by slug and optional version
static BraintrustApiClient	of(BraintrustConfig config)

Method Details

getOrCreateProject

BraintrustApiClient.Project getOrCreateProject(String projectName)

Creates or gets a project by name.

getProject

Optional<BraintrustApiClient.Project> getProject(String projectId)

Gets a project by ID.

getOrCreateExperiment

BraintrustApiClient.Experiment getOrCreateExperiment(BraintrustApiClient.CreateExperimentRequest request)

Creates an experiment.

getProjectAndOrgInfo

Optional<BraintrustApiClient.OrganizationAndProjectInfo> getProjectAndOrgInfo()

Get project and org info for the default project ID

getProjectAndOrgInfo

Optional<BraintrustApiClient.OrganizationAndProjectInfo> getProjectAndOrgInfo(String projectId)

Get project and org info for the given project ID

getOrCreateProjectAndOrgInfo

BraintrustApiClient.OrganizationAndProjectInfo getOrCreateProjectAndOrgInfo(BraintrustConfig config)

Get project and org info for the given config. Creating them if necessary

getPrompt

Optional<BraintrustApiClient.Prompt> getPrompt(@Nonnull
 String projectName,
 @Nonnull
 String slug,
 @Nullable
 String version)

Get a prompt by slug and optional version

of

static BraintrustApiClient of(BraintrustConfig config)