Getting Started

Launch reporting

Once integrated, you will launch reporting from your RIS/PACS.

Learn about user roles

Site admin

Site admins can access the site admin settings to manage site and location configurations, including but not limited to:

viewing all reports
updating system templates and site clinical guidelines
setting the final report format
managing site users
creating prelim workflows
viewing site HL7 messages
checking site usage dashboard

User

Regular users do not have access to the site admin settings and can:

draft or sign reports
take over others' reports if they have access to the same studies from the worklist
view finalized reports signed by others if the same access is granted

Prelim user / prelim reviewer

Both site admins and regular users can be assigned as prelim reviewers or prelim users. Learn more about prelim workflows and user roles here.

AI key findings mode

Use the AI key findings mode to accelerate your reporting.

Dictate a set of key findings.

Click or press Ctrl + G to let AI auto-select the best template, map the key findings to the template, compare with the selected prior report(s), and generate an impression.

You can also manually apply a template by using the voice command "Apply Template 1" (or any template number you want), or by clicking the "Apply Key Findings" button next to a template in the user interface.

Review the draft structured report with highlighted key findings and choose to keep/undo.

Auto-compare prior findings

Automatic comparison of prior findings across existing prior reports is an optional feature. You can enable or disable it using the toggle switch:

Prior finding trends

Track the progression of lesions or diseases over time. This feature allows you to monitor trends of key findings during the reporting process and automatically includes this information in your final report.

Basic reporting mode

Templates

Start with a template: You can select a template manually from the list, use a voice command to apply one, or simply click the AI button to automatically insert the most appropriate template based on the current study information.

Filtering your templates list

Toggle the clinical info filter on or off to view either all available templates or only those specifically suggested for your current active report.

Template types

My Templates: Personal templates that you can create and edit
System Templates: Templates available to all users that can only be modified by site administrators

Your templates will always be displayed first:

Navigate through the fields in a template using keyboard shortcuts:

Forward: Tab
Backward: Shift + Tab

Dictation

To start dictation within any bracketed field, click or (short) press Ctrl + S. Click or (short) press Ctrl + S again to stop recording.

Auto-generate impression

To auto-generate an impression based on the report body, click on the AI button .

DICOM SR / AI results

MD.ai Reporting can receive measurements from DICOM SR files or AI outputs directly, pre-populate these measurements in a report, and map them to a template. Contact your PACS or RIS provider to get this feature configured properly.

Key images

To attach key images, simply drag and drop them into the report. There is a current limit of 1 GB per report.

Finalize report

Click the "Sign" button to finalize the report. There will be a period of time available to revert the report back to draft status.

Manage templates

User templates

System templates

System templates are configured by site admins at the site level using the system configuration spreadsheet.

Each site is equipped with its own configuration spreadsheet, allowing site administrators to efficiently manage system templates. These templates are accessible to all users within the same site. Any modifications made in the spreadsheet are automatically reflected in the user interface when users reload the page after the changes have been saved.

Clinical guidelines

Method 1: View and select any available site guidelines you would like to apply to a report:

Method 2: If a clinical guideline is attached to a particular template, when you apply the template, the corresponding guideline will automatically be included in the report.

Manage clinical guidelines

Site clinical guidelines

These are configured by site admins only and are available for all users on the same site/location.

User clinical guidelines

These are configured by individual users and can be customized according to personal preferences.

Associating clinical guidelines to a template

Clinical guidelines can be associated with a template. See also the section on how to add user templates.

Customize report sign workflow

The report sign workflow can be customized in User Settings, which can be accessed by clicking the button next to your profile picture in the top right corner.

Billing codes generation

upon signing a report, ICD and CPT codes are automatically generated and saved under the final report. This can be turned off in user settings.

Addendum

After a report is finalized, it will no longer be editable. However, in the final report viewer, a button will appear that allows you to add an addendum.

Voice commands and keyboard shortcuts

To activate a voice command, long press and dictate to execute a voice command on release.

Voice commands	Function	Keyboard shortcuts / UI buttons
Macro number # ex: 'Macro number 1' or Select template [template name] ex: 'Select template AP Chest'	To insert a template	Click "Select Template" to insert a template
Apply number # ex: 'Apply number 1'	To apply key findings to a selected template	Click "Apply Key Findings" next to a template in the templates list
Undo	Undo	`⌘/Ctrl + Z`
Redo	Redo	`⌘/Ctrl + Y`
Cut It	Cut the selected text
Copy It	Copy the selected text
Paste It	Paste
Select All	Select all the text
Capitalize It	Capitalize the selected text
Bold It	Bold the selected text
Underline It	Underline selected text
Abracadabra / Generate	Run the AI button	`Ctrl + G` `Ctrl + Shift + Left`
Sign Report	Sign the report	Custom mapping is required

Note that there are also certain words or phrases, when spoken during dictation, that will insert punctuation or formatting. This is a non-exhaustive list:

Speech	Transcription
comma	`,`
period	`.`
colon	`:`
new line	New line
new paragraph / paragraph	New paragraph

Real-time sync

Real-time synchronization across devices can be activated via a QR code or 4-digit pin code.

Use your phone as a speech mic

Dictate on your phone and edit on a computer. Click on the QR code to enlarge the image, or scan the QR code with your phone.

Edit reports from any workstation or remotely

Transfer report ownership

Enabling report ownership transfer allows for second opinion or transcriptionist workflows. For more advanced workflows requiring prelim reports, please see the prelim workflows section.

User A who drafts a report can simply close the report without signing it. The draft is automatically saved.

User B who has access to the same exams from the same worklist can take over the draft report to review or edit. For example:

After User B is done reviewing, they can either sign the report or simply close the reporting window. All changes are saved in real-time for User A to review or sign.

If enabled, in addition to sharing report text back via HL7, you can generate a report share link to share reports with referring providers or patients.

Philips speech microphone

We support the Philips SpeechMike SMP3700. See setup instructions.

Other user settings

User Settings can be accessed by clicking the button next to your profile picture in the top right corner.

App settings

App theme: light or dark mode
App language: change to your preferred UI language
Speech-to-text language: dictate reports in your preferred language
Chat: open chat panel to interact with HIPAA-compliant large language models (LLMs)
Chat model: select a LLM to use in the chat panel (note: this does not affect the report AI models)
Report AI response mode:
- Streaming - see the process of key findings mapping
- Instant - only see the final results

On this page