Search documentation
Find a documentation page by the words on it.
Documentation
Sub-Agents Across a Cohort
Some questions cannot be answered from codes and text alone, such as whether each chart documents a particular exam. A sub-agent run has the Practice Agent start one chart-reading assistant per patient in a cohort. They work in the background and you read each patient's result and transcript.
This feature is controlled by the Population sub-agents 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.
What you need
- The Practice Agent and sub-agent runs both turned on for your clinic.
- Permission to use the Practice Agent, which is Admin only by default, and permission to read charts.
Step 1: Start from a cohort
Build a cohort in Practice Agent, as in Practice Agent and Cohorts. A run covers up to 100 patients who are still on your panel and whose chart you can open. A larger cohort is refused, not trimmed, so narrow the cohort first.
Step 2: Describe the question
Review each patient in this cohort and tell me whether the chart documents a retinal eye exam.
Write the task in words. A task that contains an identifier or a numeric date is refused. The agent prepares a card and does not start anything.
Step 3: Check the card and approve
The card shows the task exactly as the assistants will receive it, how many patients will run and how many were skipped, which assistant runs, what it may do, the model, and the most work it can use. It states that the output is AI-generated and unverified and should be confirmed in the chart, and that this version cannot draft notes or addenda.
A run reads charts only by default. If you ask for proposals, an assistant can also prepare an email, a patient record edit, a status change, an order or an appointment change for you to approve. Select Approve to start, or Cancel to start nothing.
Step 4: Follow the run
Approving opens a Sub-agents tab beside the chat. The header shows the state (Waiting to start, Reviewing patients, Finished, Did not finish or Stopped), a count such as "12 of 40 patients done", and a progress bar. Four patients run at a time.
The table lists each patient with a status, a short outcome, a plain-text note and the number of proposals. Select a patient to read the transcript of what that assistant looked at and said. It is read-only.
- Stop ends the run. It is available while the run is going.
- Resume starts a new run for the patients an earlier run did not finish.
- If the connection to the run is lost, Reconnect starts following it again.
Step 5: Act on what it prepared
Anything a run prepares appears as an ordinary approval card in that patient's record. You approve each one by itself. Nothing is sent to the chat when a run finishes. When you want a summary, ask the Practice Agent how it went, and it reads the results once, with counts first.
In a patient's own chart, a Sub-agents button on the Agent tab's second row opens a panel of your runs on that patient. It shows only when you have runs for that patient.
Good to know
- Results are AI screening notes, not clinical findings. Confirm each one in the chart before you act.
- Each assistant works only with your permissions and only on its own patient. If you lose access, or a patient's chart is no longer available to you, that patient's run stops.
- An assistant cannot start other runs, write notes or addenda, or text a patient. Runs and their transcripts are kept for a limited time, currently thirty days.
- You can see only the runs you started.