Search documentation
Find a documentation page by the words on it.
Documentation
Practice Agent Question Types
The Practice Agent turns a question about your whole patient panel into a list of matching patients. This page shows the kinds of question it understands, how to combine them, and what it will tell you about its answer. To open it and save results, see Practice Agent and Cohorts.
This feature is controlled by the Practice Agent feature flag. If you do not see it in your clinic, contact Serelora at support@serelora.com and ask for it to be turned on.
The five kinds of question
| Kind | What you can ask about | Examples |
|---|---|---|
| Conditions & Diagnoses | Diagnoses by name or code, active or past, and when they started | Patients with an active diagnosis of hypertension. Patients with both type 2 diabetes and chronic kidney disease. |
| Medications | A drug, a brand or a drug class, and whether it is current | Patients currently taking metformin. Patients on an ACE inhibitor or an ARB. |
| Labs & Vitals | A result's value against a limit, the latest result or any result, in a time window. Vitals are BMI, blood pressure and weight | Patients whose most recent LDL was over 160 mg/dL. Patients with a BMI of 30 or more. |
| Care Gaps & Visits | The lack of something in a window, such as a test or a visit, and booked or missed appointments | Patients with diabetes and no A1c in the last 12 months. Patients with an appointment booked in the next 30 days. |
| Registration & Demographics | Age, sex, and portal and intake status, including who has an email on file or has opted out | Patients who have never registered for the portal. Female patients aged 65 and older. |
You can also ask about other chart entries, such as allergies, immunizations, procedures, and family or social history. The suggestion chips for each kind are listed in Suggestion Chips and Starter Prompts.
Combine them
Put everything in one question. The agent turns it into one search, so you do not have to intersect lists yourself.
Women aged 50 to 74 with type 2 diabetes and no A1c in the last 12 months
A question can combine up to 20 filters. You can ask for "this or that", and for "not". Windows can be relative, such as the last 12 months or the next 30 days, and are worked out in your clinic's time zone on the day you ask.
Narrow, count and compare
- Narrow. Ask "Of those, only the ones on a statin" and the agent searches inside the earlier list instead of starting over.
- Break down. Ask "Break down this cohort by age and sex." You can group by age band (0 to 17, 18 to 39, 40 to 64, 65 and over, unknown), by sex, by which filter matched, by time since the last visit, or by registration status. This gives counts, not patients.
- Look closer at one patient. Ask "Why is Jane Sample in this list?" The agent can look at that one patient's chart and visits, but only for a patient who appeared in a result. This also needs permission to view charts.
- Check the schedule. Ask "Who is on the schedule tomorrow?" The Practice Agent can read appointments but cannot book, move or cancel them.
- Ask for evidence. Ask what a guideline recommends, such as a screening interval. See Literature Answers and Citations.
- Act on the list. Save it, export it, invite it to finish intake, or review each chart. See Managing Saved Cohorts, Intake Campaigns from a Cohort and Sub-Agents Across a Cohort.
Open a patient from an answer
In the agent's answer each patient's name is a link. Hover over it for a small card with the patient's age, sex, date of birth, record number and last visit, with an Open chart link. Select the name to open the chart in a new browser tab. Each preview is recorded as a read of that patient's record.
What the agent tells you about its answer
Every answer leads with the count and the search in plain words. Then it reports:
- Who was left out, and why: no date of birth, a unit that could not be converted, a non-numeric result such as "pending", or only undated results.
- Who matches on an assumption. A medication with no stated status is presumed active, and the agent says how many matches rest on that.
- What a drug class means. When you name a class, such as statins, the agent lists the ingredients and brands it searched for. A class is approximated by its members, so a drug missing from that list is missed.
- Results are compared in the same units. A result in a different unit is converted when Serelora knows how, and left out when it does not.
Limits
- It cannot search a panel of more than 20,000 patients. It says "This clinic's panel is larger than 20,000 patients, which the Practice Agent can't search yet."
- A question that depends on reading free text across every chart is not a search. Use a patient-by-patient review run instead. See Sub-Agents Across a Cohort.
- Gender identity cannot be used as a filter.
- Diagnoses are matched by code and by words, without a family tree of related conditions. Ask for related diagnoses by name if you want them.
- It never counts entries marked refuted or entered in error.
- The agent never estimates a number. Every count and every name comes from a search it ran.
If you describe your request as finding patients for research, the agent adds a short note that contacting patients for research may need IRB approval or a waiver. It still answers.
Who can use it
The Practice Agent is for Admins by default, and a clinic admin can give it to other roles. Looking closer at one patient needs permission to view charts as well. See AI Agent Features Not Available if it is missing, and Practice Agent Search Problems if a search does not behave as you expect.