Prompts

​

Overview

A prompt tells Aria what to write. “A file note for the patient record, in the past tense, with the plan as a numbered list” is a prompt. So is “a letter back to the referring doctor, one page, formal.” Every document Aria drafts comes from one. Go to Aria Intelligence then Prompts. What you see depends on your role:

• Prompts are managed for you. Your practice’s prompts are set up by whoever manages Aria for you, and you see them under Write it up when you open a recording. There is nothing to change here.
• Team prompts and My prompts tabs. You can manage the practice’s prompts, or keep some of your own, or both.

​

What Pear gives you to start with

Every practice starts with a set of prompts written for its field. A medical practice gets, among others:

• Medical practice file note
• Short phone consult note
• Results callback note, Recall call note and Triage call note for phone calls
• Letter to the referring doctor and Referral letter to a specialist

A legal practice or an IT support desk gets prompts written for that work instead. The field is set by Pear when the practice is set up. Pear keeps improving these. If your practice has not changed a Pear prompt, improvements reach you automatically. If your practice has edited one, your version stays put, and you can go back to Pear’s wording at any time.

​

Adding a prompt

On the Prompts page, click New prompt, then Start from blank. Give it a name and write what you want, in plain English. Aria reads it as instructions, so say what the document is for, who reads it, what it must always include and how it should sound. Click Save this prompt. If you would rather not write it from scratch, there are two helpers.

​

Let Aria write it

Click New prompt, then Help me write one, and answer what you can. Only the first and third really matter.

1. What do you want out of the call? Pick one of the suggestions or describe it yourself.
2. Who reads it? The patient file, a colleague, the referring doctor.
3. What must it always include? What we agreed, what the plan is, when to come back.
4. How should it sound?
5. Is there anything it must never do? For example, never record a diagnosis that was not made.
6. Anything else Aria should know?

Click Write my prompt. Aria drafts the prompt. Then you can:

• Preview it to see the wording
• Try it on this call to draft a real document with it from a recording, so you can judge the output rather than the instructions
• Adjust the prompt or Write it again if it missed the mark, with a line about what was wrong, for example “too long, and it missed the callback date”
• Keep it when it is right, giving it a name

​

Build it from letters you already send

For letters and other documents your practice already produces, the quickest way is to show Aria examples.

1. In the helper, find Build it from letters you already send.
2. Click Add example PDFs and choose two or three of the same kind of document, or paste the text of one into Paste an example instead and click Add this text.
3. Click Write the template. Aria works out the shape they have in common and ignores the patient details that differ.
4. Preview it, try it on a recording, and Keep it.

​

Managing prompts

Each prompt on the Team prompts or My prompts tab has its own card.

• Edit the wording in place and click Save. Everyone who uses that prompt gets the new wording from the next document on.
• Hide from my team (or Hide from my picker on a personal prompt) takes it out of the chooser without deleting it. A hidden prompt shows a Hidden badge, and the button becomes Show to my team.
• The bin icon removes a prompt you no longer need. The portal asks you to confirm. A prompt Pear ships cannot be removed, only hidden, so the chooser never ends up empty.
• Reset appears on a Pear prompt your practice has edited. It puts Pear’s current wording back and lets Pear’s future improvements through again.
• History lists every wording a prompt has had, with Go back to this on each, so a change that made the output worse can be undone.

​

Your usual prompt

When you write a document, ticking Make this my default prompt under the prompt chooser makes that prompt your usual one. It is chosen for you next time, and it is what batch write-up of dictations uses. Pick a different prompt on any single document and, if you like, tick the box again to change your usual one.

​

Frequently asked questions

Who sees my personal prompts? Only you. They appear under Write it up for you alone, marked yours. A team prompt changed and my notes look different. Why? Someone edited the team prompt, or Pear improved a prompt your practice had not changed. Check History on that prompt to see what changed, and go back to an earlier wording if needed. Can a prompt tell Aria to leave something out? Yes. Put it under “what it must never do”, for example “never include the patient’s address”. Aria follows it.