> ## Documentation Index > Fetch the complete documentation index at: https://portaldocs.peartelco.app/llms.txt > Use this file to discover all available pages before exploring further. # Prompts > The instructions Aria writes from: your practice's prompts, your own, how to add one, and how to build a template from letters you already send ## 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. > [!NOTE] > > Personal prompts are switched on per practice. If you would like your own prompts and the **My prompts** tab is not there, ask Pear to switch on personal prompts for your practice. ![Prompts page with Team prompts and My prompts tabs, a New prompt button, and the practice's prompts listed with From Pear labels](https://mintcdn.com/pearaustralia/MIB3yHJBVtOo3JBZ/images/scribe-prompts.png?fit=max\&auto=format\&n=MIB3yHJBVtOo3JBZ\&q=85\&s=24a3272e2bdd3c39ac77d1080fb7e3a9) ## 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. ![Let Aria write it page, with Build it from letters you already send at the top and the questions What do you want out of the call and Who reads it below](https://mintcdn.com/pearaustralia/MIB3yHJBVtOo3JBZ/images/scribe-prompt-help-write.png?fit=max\&auto=format\&n=MIB3yHJBVtOo3JBZ\&q=85\&s=154e1c544e90fd5f68770043c8bb1276) 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**. > [!NOTE] > > The PDF files stay on your computer. Only their text is sent to Aria, and only to work out the shape of the template. A PDF that is a scanned image has no text to read; export it from Word or your practice software instead, or paste the text. ## 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.