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

> Run ambient sessions in the Web SDK: start recording, track session status, retrieve generated notes, and handle errors

<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">August 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" href="/web-sdk/guides/ambient-implementation#create-a-controlled-session" arrow={true}>
    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>

## Available cookbooks

<div className="hp-io-method-grid tut-hub-card-grid" data-cookbook-related-grid>
  <a className="hp-io-method-card tut-hub-method-card" href="/documentation/cookbooks/pass-emr-encounter-id">
    <div className="tut-hub-card-media" aria-hidden="true" />

    <div className="hp-io-method-card-body">
      <div className="tut-hub-card-badges">
        <span className="hp-wn-badge hp-wn-badge-new">Ambient</span>
        <span className="hp-wn-badge cookbook-hub-badge-surface cookbook-hub-badge-surface--api">API</span>
      </div>

      <h3 className="hp-io-method-card-title">Share One Note Across Products</h3>

      <p className="hp-io-method-card-desc cookbook-hub-card-desc">
        Share one note with emr\_encounter\_id.
      </p>

      <div className="hp-io-method-card-meta tut-hub-card-foot" aria-label="5 min">
        <div className="tut-hub-card-foot-meta">
          <span className="hp-io-method-card-meta-time">5 min</span>
        </div>
      </div>
    </div>
  </a>

  <a className="hp-io-method-card tut-hub-method-card" href="/documentation/cookbooks/seed-patient-context-for-web-sdk">
    <div className="tut-hub-card-media tut-hub-card-media--blue" aria-hidden="true" />

    <div className="hp-io-method-card-body">
      <div className="tut-hub-card-badges">
        <span className="hp-wn-badge hp-wn-badge-new">Ambient</span>
        <span className="hp-wn-badge cookbook-hub-badge-surface cookbook-hub-badge-surface--sdk">Web SDK</span>
      </div>

      <h3 className="hp-io-method-card-title">Seed Patient Context for the Web SDK</h3>

      <p className="hp-io-method-card-desc cookbook-hub-card-desc">
        Seed patient context for Web SDK.
      </p>

      <div className="hp-io-method-card-meta tut-hub-card-foot" aria-label="5 min">
        <div className="tut-hub-card-foot-meta">
          <span className="hp-io-method-card-meta-time">5 min</span>
        </div>
      </div>
    </div>
  </a>
</div>

## Available tutorials

<div className="hp-io-method-grid tut-hub-card-grid">
  <a className="hp-io-method-card tut-hub-method-card" href="/documentation/tutorials/web-sdk-ambient-react">
    <div className="tut-hub-card-media" aria-hidden="true" />

    <div className="hp-io-method-card-body">
      <span className="hp-wn-badge hp-wn-badge-new">Web SDK</span>
      <h3 className="hp-io-method-card-title">Build a Web SDK Ambient Session</h3>

      <p className="hp-io-method-card-desc">
        Authenticate, initialize the Web SDK in React, and mount SukiAssistant for an ambient encounter.
      </p>

      <div className="hp-io-method-card-meta tut-hub-card-foot" aria-label="15 min, Intermediate">
        <div className="tut-hub-card-foot-meta">
          <span className="hp-io-method-card-meta-time">15 min</span>
          <span className="tut-hub-level">Intermediate</span>
        </div>
      </div>
    </div>
  </a>

  <a className="hp-io-method-card tut-hub-method-card" href="/documentation/tutorials/web-sdk-pbc-ambient">
    <div className="tut-hub-card-media tut-hub-card-media--blue" aria-hidden="true" />

    <div className="hp-io-method-card-body">
      <span className="hp-wn-badge hp-wn-badge-new">Web SDK</span>
      <h3 className="hp-io-method-card-title">Build Problem-Based Charting in Web SDK</h3>

      <p className="hp-io-method-card-desc">
        Mount Web SDK ambient with a PBN section and seed EMR diagnoses for problem-based notes.
      </p>

      <div className="hp-io-method-card-meta tut-hub-card-foot" aria-label="20 min, Intermediate">
        <div className="tut-hub-card-foot-meta">
          <span className="hp-io-method-card-meta-time">20 min</span>
          <span className="tut-hub-level">Intermediate</span>
        </div>
      </div>
    </div>
  </a>
</div>
