Search documentation
Find a documentation page by the words on it.
Documentation
Charts from the Chart Agent
Ask the chart agent to draw a picture of the numbers in a chart and it opens the chart in a tab beside the conversation. Use it to see a trend, compare two measures, check how a set of readings is spread, or lay out events on a timeline.
Step 1: Ask for the chart
Say what you want to see and over what.
Plot her A1c over time.
Show her A1c and weight on the same chart.
Plot her A1c against her BMI.
Show how her systolic blood pressure readings are spread out.
Make a timeline of her hospital stays and procedures.
The agent first reads the values it needs from the chart. It draws only numbers it has read or numbers you give it in your message. It does not look anything up while drawing, so if the chart holds nothing to plot, there is no chart to draw.
Step 2: Pick the kind of chart
The agent chooses from four kinds. You can name one in your request.
| Kind | Use it for | Example |
|---|---|---|
| Line | One measure over time, or two measures over the same dates with separate left and right axes | A1c and weight |
| Scatter | How two measures relate, each point one pair of values | A1c against BMI |
| Distribution | How a set of readings is spread, drawn as a smooth curve | Blood pressure readings |
| Timeline | Dated events in order, in rows by category | Visits, procedures and results |
Values the chart does not have show as gaps on a line chart.
Step 3: Open and read the chart
The agent replies "Plotted the chart in the workspace. Open it from the activity panel to review it." The chart opens in a tab named for the chart's title. You can open it again later from the chat's activity panel.
Under a line, scatter or distribution chart is a legend. Select a series in the legend to hide it, and select it again to show it. Hover over the chart for the values.
A timeline shows one row for each category, such as Medication or Procedure, and columns for stretches of time, with an Undated column when an event has no date. Each event is a chip with its title and date. Select a chip to open the document the event came from. If an event has no linked document, you see "No source document linked for this event." Select Full screen to enlarge the timeline, and press Esc to return.
Limits
- A line chart holds up to 500 points. A scatter chart holds up to 500 points in all, and a scatter or distribution chart up to four series.
- A distribution chart takes up to 5,000 readings, and it needs at least two for each series.
- A timeline holds up to 200 events, and each event needs a source document in the chart.
- A line chart can show two measures. It needs a label for the right-hand axis when it does.
- The chart tab is for looking. To keep a picture in a document, ask the agent for a report, which can draw charts inside the PDF. See Generating PDF Reports.
Who can use it
Anyone who can use the chart agent can ask for a chart. The numbers come from chart reads, so the agent can plot only what your role may view. The Practice Agent does not draw these charts. It counts and breaks down groups of patients instead. See Practice Agent Question Types.
Good to know
- Check a plot against the patient's record before you rely on it. The agent draws what it was given, so a wrong or missing value on the plot means a wrong or missing value in what it read.
- A plot is not saved to the patient's record. It stays with the conversation that made it.