> For the complete documentation index, see [llms.txt](https://docs.borndigital.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.borndigital.ai/insights/workspace/upload/data-sources-audio.md).

# Data sources (Audio)

This section is used for data sourcing using the manual upload option or integration with other data sources.

## Choose a data-source method

Choose one data-source method per project.

* Configure **Sourcing from Azure** when the project uses an Azure source.
* Use **Upload audio files** to add audio files manually.
* Use **Copy data from another project** to bring data from another Audio project.

Uploading, copying data, and saving settings change project data or configuration.

<figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2FFzg5kO4m8OR1SQIwwcaK%2Fimage.png?alt=media&#x26;token=bb95b1df-1d6b-4c0e-8202-55bb1a5a2e57" alt=""><figcaption></figcaption></figure>

On-screen elements:

### Sourcing from Azure

* **Sourcing from Azure**: switch for enabling sourcing from Born Digital's Azure bucket, also called blob storage.

{% hint style="info" %}
The data that is to be sourced using this method needs to be present in the Dev Azure Resource Manager in its Storage account that is used by the Digital Studio environment.\
​\
There, the data has to be placed in the "sourcing" folder that is part of the same organisation and project folder structure as the project you are enabling "Sourcing from Azure" for in the Digital Studio. See the path of the structure below:

\<Storage account> → \<Organisation folder> → \<Project folder> → \<sourcing folder>

For uploading the data use "Azure Storage Explorer".
{% endhint %}

***

### Provider (STT)

* **Provider**: drop-down field with values "Azure", "Azure Premium", "ElevenLabs" for STT (speech to text) processing of audio files as described below in "Processing options". It works independently on the selected data source; any of them use it for processing data.

<details>

<summary>Processing options</summary>

* **Azure**: excels in processing dual-channel recordings
* **Azure Premium**: is an expanded version of the Azure option
* **ElevenLabs**: excels in processing single-channel recordings

</details>

* **Display type**: drop-down field with values "lexical", "display", "itn", "maskedITN" described below

<details>

<summary>Transcription types</summary>

* **lexical**: is the raw text exactly as recognized, without punctuation, capitalization, or formatting
  * *Example: “I spent twenty dollars” → “i spent twenty dollars”*
* **display**: is the most human-readable version—it includes punctuation, capitalization, and applies ITN plus additional formatting.
  * *Example: “i spent twenty dollars” → “I spent $20.”*
* **itn**: converts spoken words to their symbolic or numeric equivalents.
  * *Example: turning “twenty dollars” into “$20” or “two o’clock” into “2:00”.*
* **maskedITN**: is similar to ITN but hides or redacts sensitive elements, such as numbers or personally identifiable information (PII).
  * *Example: “I spent $20 on 555-1234” → “I spent $\*\* on -\*”*

</details>

***

### **Upload audio files**

feature is suitable for uploading a smaller batch of recordings (ca up to 50), rather for testing or POC cases.

* **Upload**: button for manual upload of data files for processing in formats .wav, .mp3, .ogg, .flac
* **Metadata**: switch for displaying a JSON metadata editor underneath it. Once activated, the editor's value applies exclusively to a single audio file for upload.

{% hint style="info" %}
Metadata accompanies uploaded audio files, resulting in improved visibility and extending filter options in dashboards; its data can also be utilized in [parameter conditions](/insights/workspace/design/parameters.md) and [Digital Agent flows](/digital-agent/conversation-flow.md).
{% endhint %}

***

### Copy data from another project

Use this feature to copy selected audio results from another project into the current project. This can help you test or fine-tune parameters and prompts without changing the source project.

* **Project**: drop-down field for selecting the source **Insight → Audio** project. Only other Audio projects from the active organization are available; the current project is excluded.
  * The source and target projects must belong to the same organization, and you must have the required access to the source project.
* **Version**: drop-down field for selecting the source result version. Selecting a version is strongly recommended. If no version is selected, the operation is not restricted to one specific source version.
* **From (UTC)**: optional lower date and time boundary for the audio results to be copied.
* **To (UTC)**: optional upper date and time boundary for the audio results to be copied.
* Either date boundary can be used independently. If both are specified, **From (UTC)** must be earlier than **To (UTC)**.

#### Additional filters

Use these controls to further limit the results copied from the selected project. Filters are applied together with the selected version and UTC date range.

* **Level 1–3**: identifies the nesting level of a condition group. Filters support up to three levels.
* **AND** + **OR**: choose whether all conditions in the current group must match (**AND**) or whether at least one can match (**OR**).
* **Parameter**: enter the result parameter whose value you want to filter. Spaces are automatically removed from the entered parameter name.
* **Operator**: select how the parameter value is compared. Available options depend on the selected value type: **Equal**, **Not equal**, **>**, **>=**, **<**, **<=**, **Is in**, **Is not in**, and **RegEx**.
* **Value**: enter the value against which the parameter is compared. The input control changes according to the selected type and operator. For **Is in** and **Is not in**, you can enter multiple values.
* **Type**: select **String**, **Integer**, **Float**, **Date**, or **Bool**. Not every operator supports every type; for example, **RegEx** is available only for **String**, while ordering operators are available for numbers and dates.
* **Bin**: removes the current condition or nested group.
* **Condition**: adds another condition to the current group.
* **Nested group**: adds another group of conditions inside the current group, up to Level 3.
* **Preview**: displays the generated filter definition. It does not execute the filter or calculate the number of matching results.

#### Floating buttons

* **Check**: calculates how many audio results match the selected project, version, date range, and additional filters. The result is displayed below the filters.

  <figure><img src="https://4261467870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6iQTvxgRZRwPS1NgIGEb%2Fuploads%2FTBGZ62vp5BvqfYZl58cp%2Fimage.png?alt=media&#x26;token=632fa3d5-bd4a-4d82-9064-ae6087e6eecd" alt=""><figcaption></figcaption></figure>

  If you change the project, version, date range, or filters after **Check**, the displayed count becomes outdated. A warning is shown, and you must run **Check** again.
* **Copy**: starts copying the checked audio results into a new result version of the current project. The operation runs asynchronously; the confirmation message means that copying has started, not that it has completed.
  * **Copy** is enabled only after **Check** successfully returns at least one matching result.
* **Save**: saves the general Data sources configuration of the current project. It does not save the selected source project, version, date range, or additional filters.

Audio results are copied with their analytical results, transcripts, utterance data, associated recording archive data, and metadata.

{% hint style="warning" %}
Select a source version unless you intentionally want to copy results without restricting the operation to one version. Always use **Check** to verify the final number of matching results before starting the copy.
{% endhint %}
