Per-section note customization options
This feature is currently Only available in English.
In addition to specifying a template that the generated note will conform to, you can also customize each section's content such as style (paragraph vs bullet points) or level of detail (concise or detailed). All those customization options are optional: you can specify only the ones that you are interested in.
Following are the currently supported per-section customization options.
Customization option | Description | Availability |
---|---|---|
Style | Whether you prefer bullet points formatting or a paragraph-like one. In some cases, for instance if the content of the section is very brief, requesting a "bullet points" style will still yield a paragraph because bullet points won't make sense. | Style (paragraph or bullet points) is supported for all sections of all templates. |
Custom instruction | Allow to customize a note section by providing specific guidelines. These guidelines must be as clear and concise as possible for best results. | Custom instruction is supported for all sections of all templates. |
Level of Detail | Whether you prefer the default section level of detail or rich and more detailed one. Use 'detailed' to get more details in the note section content. | Applies for:
Please note that templates DIET , PSYCHOLOGY_MULTIPLE_SECTIONS , and PSYCHIATRY_MULTIPLE_SECTIONS are not supported for level of detail customization at this time. |
Split by Problem | For structuring the section content according to distinct clinical problems or topics addressed during the consultation. This format aims to enhance the clarity and organization of the clinical note, making it easier to read and understand the different issues discussed during the consultation. When this flag is enabled, the section text is organized into subsections, each corresponding to a specific problem or topic. The subsections are separated using a human-readable formatting with-in the same single string-typed field, so this flag does not change the section's API schema. |
Example customization codeโ
Following is a Typescript code snippet demonstrating how to customize the sections within the GENERIC_MULTIPLE_SECTIONS_AP_MERGED
template.
const generateNoteRequestBody = {
...otherFields, // transcript, etc.
note_locale: "ENGLISH_US",
note_template: "GENERIC_MULTIPLE_SECTIONS_AP_MERGED", // to generate a note following the GENERAL_MEDICINE_AP_MERGED template
note_sections_customization: [
// in which 'History Of Present Illness' section is detailed and split by problem.
{
section_key: "HISTORY_OF_PRESENT_ILLNESS",
level_of_detail: "DETAILED",
split_by_problem: true,
},
// Also, 'Vitals' and 'Allergies' are formatted in bullet points, with custom instructions.
{
section_key: "VITALS",
custom_instruction:
"Include discussion about the patient's diet and nutritional concerns",
style: "BULLET_POINTS",
},
{
section_key: "ALLERGIES",
style: "BULLET_POINTS",
},
],
};
You should:
- only specify sections that apply for the given template (check the Templates and sections);
- only specify customization options that are supported for the given section and template (check the compatibility table below);
- also, there should be at most one customization options object per section in the list.
Customization options compatibility matrixโ
As mentioned above, some customization options are only available for specific templates and specific sections. Following is the exhaustive matrix of availability.
- GENERIC_MULTIPLE_SECTIONS
- GENERIC_MULTIPLE_SECTIONS_AP_MERGED
- GENERIC_SOAP
- CARDIOLOGY_MULTIPLE_SECTIONS
- PSYCHIATRY_MULTIPLE_SECTIONS
- DIET_MULTIPLE_SECTIONS
- PSYCHOLOGY_MULTIPLE_SECTIONS
- WCC_MULTIPLE_SECTIONS
- WCC_SOAP
- EMERGENCY_MULTIPLE_SECTIONS
- EMERGENCY_SOAP
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
CHIEF_COMPLAINT | โ | โ | - | - |
HISTORY_OF_PRESENT_ILLNESS | โ | โ | โ | โ |
PAST_MEDICAL_HISTORY | โ | โ | - | - |
PAST_SURGICAL_HISTORY | โ | โ | - | - |
PAST_OBSTETRIC_HISTORY | โ | โ | - | - |
FAMILY_HISTORY | โ | โ | - | - |
SOCIAL_HISTORY | โ | โ | - | - |
ALLERGIES | โ | โ | - | - |
CURRENT_MEDICATIONS | โ | โ | - | - |
IMMUNIZATIONS | โ | โ | - | - |
VITALS | โ | โ | - | - |
LAB_RESULTS | โ | โ | - | - |
IMAGING_RESULTS | โ | โ | - | - |
PHYSICAL_EXAM | โ | โ | - | - |
ASSESSMENT | โ | โ | - | - |
PLAN | โ | โ | - | - |
PRESCRIPTION | โ | โ | - | - |
APPOINTMENTS | โ | โ | - | - |
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
CHIEF_COMPLAINT | โ | โ | - | - |
HISTORY_OF_PRESENT_ILLNESS | โ | โ | โ | โ |
PAST_MEDICAL_HISTORY | โ | โ | - | - |
PAST_SURGICAL_HISTORY | โ | โ | - | - |
PAST_OBSTETRIC_HISTORY | โ | โ | - | - |
FAMILY_HISTORY | โ | โ | - | - |
SOCIAL_HISTORY | โ | โ | - | - |
ALLERGIES | โ | โ | - | - |
CURRENT_MEDICATIONS | โ | โ | - | - |
IMMUNIZATIONS | โ | โ | - | - |
VITALS | โ | โ | - | - |
LAB_RESULTS | โ | โ | - | - |
IMAGING_RESULTS | โ | โ | - | - |
PHYSICAL_EXAM | โ | โ | - | - |
ASSESSMENT_AND_PLAN | โ | โ | - | - |
PRESCRIPTION | โ | โ | - | - |
APPOINTMENTS | โ | โ | - | - |
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
SOAP_SUBJECTIVE | โ | โ | โ | โ |
SOAP_OBJECTIVE | โ | โ | - | - |
SOAP_ASSESSMENT | โ | โ | - | - |
SOAP_PLAN | โ | โ | - | - |
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
CHIEF_COMPLAINT | โ | โ | - | - |
HISTORY_OF_PRESENT_ILLNESS | โ | โ | โ | โ |
CARDIOVASCULAR_RISKS | โ | โ | - | - |
PAST_MEDICAL_HISTORY | โ | โ | - | - |
PAST_SURGICAL_HISTORY | โ | โ | - | - |
PAST_OBSTETRIC_HISTORY | โ | โ | - | - |
FAMILY_HISTORY | โ | โ | - | - |
SOCIAL_HISTORY | โ | โ | - | - |
ALLERGIES | โ | โ | - | - |
CURRENT_MEDICATIONS | โ | โ | - | - |
VITALS | โ | โ | - | - |
IMMUNIZATIONS | โ | โ | - | - |
PHYSICAL_EXAM | โ | โ | - | - |
LAB_RESULTS | โ | โ | - | - |
IMAGING_RESULTS | โ | โ | - | - |
ASSESSMENT | โ | โ | - | - |
PLAN | โ | โ | - | - |
PRESCRIPTION | โ | โ | - | - |
APPOINTMENTS | โ | โ | - | - |
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
CHIEF_COMPLAINT | โ | โ | - | - |
HISTORY_OF_PRESENT_ILLNESS | โ | โ | - | - |
PAST_MEDICAL_HISTORY | โ | โ | - | - |
PAST_SURGICAL_HISTORY | โ | โ | - | - |
PAST_OBSTETRIC_HISTORY | โ | โ | - | - |
FAMILY_HISTORY | โ | โ | - | - |
SOCIAL_HISTORY | โ | โ | - | - |
ALLERGIES | โ | โ | - | - |
CURRENT_MEDICATIONS | โ | โ | - | - |
VITALS | โ | โ | - | - |
IMMUNIZATIONS | โ | โ | - | - |
PHYSICAL_EXAM | โ | โ | - | - |
LAB_RESULTS | โ | โ | - | - |
IMAGING_RESULTS | โ | โ | - | - |
MENTAL_HEALTH_EXAM | โ | โ | - | - |
ASSESSMENT | โ | โ | - | - |
PLAN | โ | โ | - | - |
PRESCRIPTION | โ | โ | - | - |
APPOINTMENTS | โ | โ | - | - |
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
DIET_LIFESTYLE | โ | โ | - | - |
DIET_MEDICAL_HISTORY | โ | โ | - | - |
DIET_CHIEF_COMPLAINT | โ | โ | - | - |
DIET_VITALS | โ | โ | - | - |
DIET_HABITS | โ | โ | - | - |
DIET_OBJECTIVES | โ | โ | - | - |
DIET_APPOINTMENTS | โ | โ | - | - |
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
CHIEF_COMPLAINT | โ | โ | - | - |
PSYCHOLOGY_HISTORY_OF_COMPLAINT | โ | โ | - | - |
MENTAL_HEALTH_HISTORY | โ | โ | - | - |
SOCIAL_HISTORY | โ | โ | - | - |
MENTAL_HEALTH_EXAM | โ | โ | - | - |
ASSESSMENT | โ | โ | - | - |
PLAN | โ | โ | - | - |
APPOINTMENTS | โ | โ | - | - |
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
CHIEF_COMPLAINT | โ | โ | - | - |
HISTORY_OF_PRESENT_ILLNESS | โ | โ | โ | โ |
WELL_CHILD_CARE | โ | โ | - | - |
PAST_MEDICAL_HISTORY | โ | โ | - | - |
PAST_SURGICAL_HISTORY | โ | โ | - | - |
PAST_OBSTETRIC_HISTORY | โ | โ | - | - |
FAMILY_HISTORY | โ | โ | - | - |
SOCIAL_HISTORY | โ | โ | - | - |
ALLERGIES | โ | โ | - | - |
CURRENT_MEDICATIONS | โ | โ | - | - |
IMMUNIZATIONS | โ | โ | - | - |
VITALS | โ | โ | - | - |
LAB_RESULTS | โ | โ | - | - |
IMAGING_RESULTS | โ | โ | - | - |
PHYSICAL_EXAM | โ | โ | - | - |
ASSESSMENT | โ | โ | - | - |
PLAN | โ | โ | - | - |
PRESCRIPTION | โ | โ | - | - |
APPOINTMENTS | โ | โ | - | - |
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
SOAP_SUBJECTIVE | โ | โ | โ | โ |
WELL_CHILD_CARE | โ | โ | - | - |
SOAP_OBJECTIVE | โ | โ | - | - |
SOAP_ASSESSMENT | โ | โ | - | - |
SOAP_PLAN | โ | โ | - | - |
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
CHIEF_COMPLAINT | โ | โ | - | - |
HISTORY_OF_PRESENT_ILLNESS | โ | โ | โ | โ |
PAST_MEDICAL_HISTORY | โ | โ | - | - |
PAST_SURGICAL_HISTORY | โ | โ | - | - |
PAST_OBSTETRIC_HISTORY | โ | โ | - | - |
FAMILY_HISTORY | โ | โ | - | - |
SOCIAL_HISTORY | โ | โ | - | - |
ALLERGIES | โ | โ | - | - |
CURRENT_MEDICATIONS | โ | โ | - | - |
IMMUNIZATIONS | โ | โ | - | - |
VITALS | โ | โ | - | - |
LAB_RESULTS | โ | โ | - | - |
IMAGING_RESULTS | โ | โ | - | - |
PHYSICAL_EXAM | โ | โ | - | - |
ASSESSMENT | โ | โ | - | - |
PLAN | โ | โ | - | - |
PRESCRIPTION | โ | โ | - | - |
APPOINTMENTS | โ | โ | - | - |
Section | Customization options | |||
---|---|---|---|---|
Style | Custom instruction | Level of Detail | Split by Problem | |
SOAP_SUBJECTIVE | โ | โ | โ | โ |
SOAP_OBJECTIVE | โ | โ | - | - |
SOAP_ASSESSMENT | โ | โ | - | - |
SOAP_PLAN | โ | โ | - | - |