Skip to content

Search documentation

Find a documentation page by the words on it.

Documentation

Reviewing Chart Changes the Agent Proposes

The agent can propose new entries for the chart and corrections to entries already there. It never writes them itself. You see every proposal in one review, untick what you do not want, fix what is wrong, and approve the rest.

Step 1: Ask for the entries

Tell the agent what to add or change, or point it at a document:

Add the medications from this discharge summary.

Mark the pneumonia resolved.

The lisinopril dose is 20 mg now.

The agent proposes entries only from what you tell it or from a document you ask it to add from. It checks the chart first and leaves out what is already there. If it has not been told to add something yet, it asks before preparing the proposal. New entries can be of any type except insurance coverage, such as conditions, medications, allergies, procedures, results, immunizations, family and social history, care plans, goals and devices. One proposal holds up to fifty entries. With more, the agent proposes fifty and offers the rest once you have reviewed those.

Step 2: Open the review

The proposal opens in the Chart changes tab, in the pane beside the chat, so you can keep talking to the agent while you review. The title reads Review proposed chart entries (3), or Review chart changes (5) when edits are included. If you close the tab, the card's chip in the chat reopens it with nothing lost.

New entries are listed with their Type, Entry, Code, Status, Started and Details. Edits to existing entries have their own table with Type, Entry and Proposed changes, showing the current and proposed values. When a review has both, the tables are headed Add to the chart and Change what's in the chart. Every row starts ticked.

Step 3: Check and fix each row

  • Untick any row you do not want.
  • Edit in the row. You can change the description, the code, the status and the start date directly.
  • Open Edit on a row for every field, including dose, frequency, values, end date and the detail fields for that type. Changes there apply to the proposal only.

Check the code on each row. The agent attaches the best match from the same search the Add dialog uses, and a badge shows how sure it is:

Badge Meaning
Exact match The code's name matches what was proposed
Suggested: check The top search hit, not an exact match. Confirm it or choose another with Change
Picked A code you chose
No code exists The search found nothing, so the entry is added as free text

When a code replaced the agent's wording, the row also shows what the assistant originally wrote. Start dates come from what you or the source document stated. With no date stated, the field is left blank, never filled with today's date.

Step 4: Approve the ticked rows

Select Add selected (n), or Approve selected (n) when edits are included, where n is the number of ticked rows. Each ticked row is saved the same way as if you had added it by hand. If a row fails, the review stays open with a message such as "1 change was not saved. Fix or untick it and try again." Rows that were saved are not offered again. Cancel closes the review and saves nothing.

Afterward the chip in the chat reads Added to the chart, Partly added to the chart or Not added, and the agent is told how many went through.

Good to know

  • You need permission to edit the chart. Admin, Physician, Physician Assistant and Medical Assistant have it by default. Without it you see a notice instead of the table.
  • An edit to a claim that is part of a pending merge shows In a pending merge. It is a warning, not a block.
  • A change to an entry's status, notes or relationship is refused if the entry changed after the agent prepared the proposal. Ask the agent to prepare it again.
  • Two entries that record the same thing are duplicates, not edits. See Cleaning Up Duplicate Claims with the Agent.