Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bigspin.ai/llms.txt

Use this file to discover all available pages before exploring further.

Data sources are integrations that continuously pull traces from external platforms directly into your Bigspin projects. Instead of manually exporting and uploading files, you connect your tracing tool once and Bigspin automatically ingests new traces as they appear. This keeps your project’s transcript data fresh without any ongoing manual work. Bigspin currently supports LangSmith and Braintrust as data sources, with more integrations on the way.

​
Access Data Sources

From the Projects dashboard, click the Data Sources button in the top-right corner (next to Create Project). This opens the Data Sources panel where you can see available integrations and navigate to their setup pages.

​
Set up LangSmith

LangSmith is a tracing and evaluation platform for LangChain-based applications. Connecting it lets Bigspin import your LangSmith traces as transcripts.
1

Go to Settings > Integrations

Navigate to Settings in the sidebar, then select Integrations.
2

Open the LangSmith integration

Find LangSmith in the integrations list and click to configure it.
3

Enter your LangSmith API key

Paste your LangSmith API key. LangSmith API keys follow the format:
lsv2_pt_...
You can find or create your API key in your LangSmith account settings.
4

Save the integration

Save the configuration. Bigspin validates the key and activates the integration for your workspace.

​
Set up Braintrust

Braintrust is an evaluation and tracing platform for AI applications. Connecting it lets Bigspin pull your Braintrust experiment logs and traces as transcripts.
1

Go to Settings > Integrations

Navigate to Settings in the sidebar, then select Integrations.
2

Open the Braintrust integration

Find Braintrust in the integrations list and click to configure it.
3

Enter your Braintrust API key

Paste your Braintrust API key. Braintrust API keys follow the format:
sk-...
You can find your API key in your Braintrust account settings.
4

Save the integration

Save the configuration. Bigspin validates the key and activates the integration for your workspace.

​
Transcript Filters

When a data source is connected, you can filter which traces get ingested into a specific project. Filters are configured at project creation time and are based on metadata key/value pairs attached to your traces.
1

Open the Create Project dialog

Click Create Project from the Projects dashboard.
2

Add filter conditions

In the Transcript Filters section, click Add Filter. Select a metadata key from the dropdown (populated from your connected data source), then enter or select a matching value.Add as many conditions as you need by clicking Add condition. All conditions must match for a transcript to be included (AND logic).
3

Check the preview count

As you configure filters, Bigspin displays a preview count showing how many transcripts currently match your criteria. Use this to confirm your filters are scoped correctly before creating the project.
4

Create the project

Click Create Project. The filters are saved with the project and applied to all future syncs.
If no metadata keys appear in the dropdown, make sure your traces include metadata fields in your LangSmith or Braintrust setup. Bigspin reads available keys directly from your connected source.

​
Continuous sync

Once a data source is connected and a project is configured, Bigspin automatically ingests new traces as they arrive. You don’t need to trigger imports manually — your project stays up to date as your AI application produces new conversations.
Transcript Filters set during project creation continue to apply to all incoming traces. Only traces that match the filter criteria are added to the project.

​
Available integrations

LangSmith

Connect your LangSmith workspace to sync traces from LangChain-based applications. API key format: lsv2_pt_...

Braintrust

Connect your Braintrust account to sync experiment logs and traces. API key format: sk-...
Additional integrations are in development. Check the Data Sources panel for the latest available options.