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

# Ambient Session Overview

> Learn how to implement Ambient sessions with the Web SDK

<div className="quick-summary-wrapper">
  <div className="quick-summary-header">
    <span className="quick-summary-icon" aria-hidden="true" />

    <span className="quick-summary-title">Quick summary</span>
  </div>

  <div className="quick-summary-content">
    An ambient session captures patient-provider conversations and generates clinical notes in real-time. The SDK handles recording, note generation, and error handling automatically.

    <br />

    <br />

    Manage sessions in two ways: uncontrolled mode where users interact only with SDK UI controls, or controlled mode where your EHR system controls when sessions start and stop through external triggers.
  </div>

  <div className="quick-summary-footer">
    <span className="quick-summary-footer-icon" aria-hidden="true" />

    <span className="quick-summary-footer-text">Last updated:</span>
    <span className="quick-summary-footer-date">July 2026</span>
  </div>
</div>

An ambient session captures patient-provider conversations and generates clinical notes in real-time. The SDK handles recording, note generation, and error handling automatically.

To generate notes, you must configure sections that organize the content. Use either predefined note types or [LOINC codes](/documentation/concepts/ambient-clinical-notes/note-sections). The SDK creates notes from the conversation using these configured sections.

<Note>
  LOINC code support is available in **version 2.0** and above. See the [note sections documentation](/documentation/concepts/ambient-clinical-notes/note-sections) for supported codes. For older versions, contact support to configure note types.
</Note>

## Session management in Web SDK

Manage ambient sessions in the Web SDK in two ways:

<CardGroup cols={2}>
  <Card title="Uncontrolled Mode" icon="circle-play">
    Users interact only with SDK UI controls. The SDK manages the session lifecycle automatically.
  </Card>

  <Card title="Controlled Mode" icon="sliders">
    Your EHR system controls the session lifecycle (start, stop, resume) through external triggers. The SDK handles recording and note generation while your app controls when sessions start and stop.
  </Card>
</CardGroup>

## Ambient guides

<CardGroup cols={2}>
  <Card title="Create Session" icon="plus" href="/web-sdk/guides/ambient-implementation" arrow={true}>
    Create an ambient session and provide session context.
  </Card>

  <Card title="Interoperability" icon="arrows-rotate" href="/web-sdk/guides/ambient-interoperability" arrow={true}>
    Share one ambient note across Web SDK and other Suki ambient products.
  </Card>

  <Card title="Session Status" icon="waveform" href="/web-sdk/guides/ambient-session-status" arrow={true}>
    Lifecycle events and status flags for ambient sessions.
  </Card>

  <Card title="Problem-Based Charting" icon="list" href="/web-sdk/guides/ambient-problem-based-charting" arrow={true}>
    Enable PBC and pass existing patient diagnoses.
  </Card>

  <Card title="Multilingual Support" icon="language" href="/web-sdk/guides/ambient-multilingual" arrow={true}>
    Use multiple languages in ambient sessions.
  </Card>

  <Card title="Offline Mode" icon="wifi" href="/web-sdk/guides/ambient-offline-mode" arrow={true}>
    How sessions behave during network interruptions.
  </Card>

  <Card title="Re-Ambient & Recovery" icon="rotate" href="/web-sdk/guides/ambient-session-recovery" arrow={true}>
    Continue existing notes and recover abandoned sessions.
  </Card>
</CardGroup>