Seed Patient Context for the Web SDK

Problem: You start ambient with only emr_encounter_id, then open the Web SDK and the patient profile is empty. Solution: Seed ambient session context with patient_id, name, dob, and sex before mount. Open the Web SDK with the same encounter.identifier.

This cookbook assumes you already have your Partner ID, authentication tokens, and the other prerequisites for Ambient APIs and the Web SDK.

Seed context

CURL
Python
TypeScript

curl --request POST \
  --url https://sdp.suki.ai/api/v1/ambient/session/<ambient_session_id>/context \
  --header 'Content-Type: application/json' \
  --header 'sdp_suki_token: <sdp_suki_token>' \
  --header 'sdp_provider_id: <sdp_provider_id>' \
  --data '{
    "patient": {
      "patient_id": "905c2521-25eb-4324-9978-724636df3436",
      "name": {
        "given": ["Alex"],
        "family": "Patient"
      },
      "dob": "2000-01-01",
      "sex": "female"
    }
  }'

import requests

response = requests.post(
    f"https://sdp.suki.ai/api/v1/ambient/session/{ambient_session_id}/context",
    headers={
        "Content-Type": "application/json",
        "sdp_suki_token": sdp_suki_token,
        "sdp_provider_id": sdp_provider_id,
    },
    json={
        "patient": {
            "patient_id": "905c2521-25eb-4324-9978-724636df3436",
            "name": {"given": ["Alex"], "family": "Patient"},
            "dob": "2000-01-01",
            "sex": "female",
        },
    },
)
response.raise_for_status()

const response = await fetch(
  `https://sdp.suki.ai/api/v1/ambient/session/${ambientSessionId}/context`,
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      sdp_suki_token: sdpSukiToken,
      sdp_provider_id: sdpProviderId,
    },
    body: JSON.stringify({
      patient: {
        patient_id: "905c2521-25eb-4324-9978-724636df3436",
        name: { given: ["Alex"], family: "Patient" },
        dob: "2000-01-01",
        sex: "female",
      },
    }),
  }
);

if (!response.ok) {
  throw new Error(`Seed ambient session context failed: ${response.status}`);
}

Open Web SDK

React

<SukiAssistant
  encounter={{
    identifier: "6ec3920f-b0b1-499d-a4e9-889bf788e5ab", // same emr_encounter_id
    patient: {
      identifier: "905c2521-25eb-4324-9978-724636df3436",
      name: {
        use: "official",
        family: "Patient",
        given: ["Alex"],
        suffix: [],
      },
      birthDate: "2000-01-01",
      gender: "FEMALE",
    },
  }}
/>

Common mistakes

Seed before the Web SDK opens.
Keep encounter.identifier identical to emr_encounter_id.

Other cookbooks

AmbientAPI

Share one note with emr_encounter_id.

5 min

AmbientAPI

Fetch Note Content with composition_id

Retrieve the note with composition_id.

5 min

​Seed context

​Open Web SDK

​Common mistakes

​Other cookbooks

​Share One Note Across Products

​Fetch Note Content with composition_id

Seed context

Open Web SDK

Common mistakes

Other cookbooks

Share One Note Across Products

Fetch Note Content with composition_id