> ## 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.

# LangSmith Integration: Sync Traces into Bigspin

> Link your LangSmith account to Bigspin to automatically import traces as transcripts. Apply metadata filters to scope which traces each project ingests.

Connecting LangSmith to Bigspin lets you pull your LangSmith traces directly into Bigspin projects without any manual exporting or uploading. Once the integration is active, you can create projects that source data from your LangSmith workspace, apply metadata filters to scope which traces you want to analyze, and let Bigspin handle ingestion automatically.

## Connect your LangSmith account

<Steps>
  <Step title="Open Integrations settings">
    In the Bigspin dashboard, go to **Settings** > **Integrations**.
  </Step>

  <Step title="Select LangSmith">
    Click the **LangSmith** card to open the connection form.
  </Step>

  <Step title="Enter your API key">
    Paste your LangSmith API key into the field. LangSmith API keys follow the format:

    ```text theme={null}
    lsv2_pt_...
    ```

    If you don't have a key yet, follow the [LangSmith API key guide](https://docs.langchain.com/langsmith/api-key) to generate one.
  </Step>

  <Step title="Validate and connect">
    Bigspin validates the key against your LangSmith account before saving. If validation succeeds, the integration appears as connected on the Integrations page.

    <Note>
      Validation happens automatically when you submit the form. Bigspin does not store your key until the check passes.
    </Note>
  </Step>
</Steps>

## Create a project with LangSmith as the data source

Once the integration is connected, you can create Bigspin projects that pull from your LangSmith workspace.

<Steps>
  <Step title="Go to Projects">
    Navigate to **Projects** in the Bigspin dashboard.
  </Step>

  <Step title="Open Data Sources">
    Click **Data Sources** when setting up a new project.
  </Step>

  <Step title="Select LangSmith">
    Choose **LangSmith** from the list of available sources.
  </Step>

  <Step title="Apply metadata filters (optional)">
    Bigspin fetches the metadata keys available in your LangSmith workspace and displays them in a filter panel. For each key you want to filter on:

    * Select the metadata key from the dropdown.
    * Choose or type the value to match. Bigspin shows sample values pulled from your workspace to help you pick the right one.
    * Review the **preview count** — Bigspin shows how many traces match your current filter combination before you finalize the project.

    <Tip>
      Use metadata filters to scope ingestion to a specific model, environment, or user segment. Narrowing the filter set keeps your project focused and speeds up analysis.
    </Tip>

    You can add multiple key/value filters. Bigspin applies them together, ingesting only traces that match all conditions.
  </Step>

  <Step title="Finish creating the project">
    Complete the remaining project setup steps. Bigspin begins ingesting matching LangSmith traces automatically.
  </Step>
</Steps>

## Ongoing ingestion

After initial setup, Bigspin ingests traces from LangSmith automatically. You do not need to trigger syncs manually or re-export data from LangSmith.

<Note>
  If you rotate your LangSmith API key, return to **Settings** > **Integrations** and update the key so ingestion continues without interruption.
</Note>