> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Audio environment

> Prepare background-sound settings and distinguish ambient audio from tool-call sounds and speech recognition.

An audio environment describes background sound intended to accompany a conversation. Keep it subtle enough that spoken information remains easy to understand.

<Note>
  The dashboard's **Audio environment** control belongs to the unsaved voice preview. The API accepts background-sound authoring settings, but voice publication and live background playback are not available through this guide.
</Note>

## Background-sound fields

These fields belong to `conversation_config.conversation.background_sound`.

| Field | Accepted configuration |
| - | - |
| `source_type` | `preset` or `null`. |
| `source_id` | A supported preset identifier or `null`. |
| `volume` | Number from 0.01 to 1; default 0.15. |
| `crossfade_loop` | Boolean; defaults to `true`. |

Preset identifiers include `office1`, `office2`, `restaurant`, `city`, `typing`, and `elevator1` through `elevator4`. The source type does not provide a custom audio-file upload option.

## Prepare an environment

<Steps>
  <Step title="Decide whether background sound is needed">
    Consider the listener's task and likely surroundings. A quiet environment may be easier to understand for instructions containing dates, addresses, or codes.
  </Step>

  <Step title="Choose one preset">
    Record the intended preset and a conservative volume. Keep a version without background sound in your review plan so later listening tests can compare intelligibility.
  </Step>

  <Step title="Save and inspect a draft">
    Preserve the full agent snapshot and use the [server-draft workflow](/agents-platform/deploy/versioning). Read the background-sound object back. Do not treat the unsaved dashboard preview as confirmation of stored settings.
  </Step>
</Steps>

Background sound is separate from `tool_call_sound` on a tool definition. It also does not configure noise suppression, microphone processing, or ASR recognition. Use [voice and language](/agents-platform/configure/voice-and-language/overview) for input-recognition settings.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I upload a custom background track?" id="faq-audio-environment-upload">
    The current background-sound contract supports presets. This guide does not provide a custom-track upload workflow.
  </Accordion>

  <Accordion title="Does volume change the agent's speaking volume?" id="faq-audio-environment-volume">
    This field belongs to background sound. Speech-volume controls, when offered, are model-specific TTS options and should be reviewed separately.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.