Shelly is your data wizard, but she’s not a mind reader! While Shelly will try to guide you she is also a people pleaser, thus asking the right questions remains your responsibility.
In a nutshell, this is our guidance:
Give context, specify the scope of your question, be specific and be patient 💪
Let's unpack that in greater detail in the following sections.
Note: If you've skipped the article about the general functionality of Shelly; what she can help with or where to find her, catch-up in this article.
#1 Give enough context
Shelly doesn't have your (business) context. If you know a step in your care flow signifies a tangible result, insert that information in your question. Use your expertise to help her help you.
If you're unsure, Shelly will try to find the data and ask for clarification. You can also start with broader questions and then ask follow-up questions. Shelly loves to chat!
More context:
❌"Give me the breakdown of my patients?"
try instead
✅ "How many of my patients completed the Diabetes care flow in the last month?"
Follow-up questions:
✅ “What steps are present in my Diabetes care flow?”
followed by
✅ “How many patients completed the Diabetes Medication step?”
#2 Specify your care flow
Shelly will try to distinguish between questions related to a specific care flow or across all care flows, but it helps if you specify the scope of your question.
If you know the exact care flow name or the care flow definition ID, then use that information to compose your question. If Shelly needs more clarification, she will try to get it from you.
If you don't know the exact care flow name, you can always ask Shelly what care flows you have in your organization and go from there.
If the question spans across all care flows, then simply mention "check across all care flows"
❌"What steps are completed?"
try instead
✅ "Give me the breakdown of completed steps for the Knee replacement with care flow ID: Ub5ElGPoQHdy?"
#3 Be specific & avoid ambiguity
Vague questions get vague answers. If you are in need of specifics, ask for it:
❌"What are the results?"
try instead
✅"What are the blood test results for patients in the hypertension care flow?"
At the same time ambiguous questions can be tricky. If Shelly’ could be interpreting the question in more then one way, you might not get what you’re looking for.
❌"Give me the state of heart health?"
try instead
✅"How many heart health care flows completed last month?"
#4 Be patient
Good things come to those who wait. Complex requests might take a bit longer for Shelly to figure out. Be patient, and trust that Shelly is working hard to bring you the best answer. If she does not get it the first time, check your question - are you asking what you think you are asking?
If your question is too complex Shelly will bend over backwards to answer everything in one go. Try to break it down into several follow-up questions and start back at the top of this guide 🔝.
Give context, specify the scope of your question, be specific and be patient 💪
❌"I'm interested in understanding how many care flows were completed this month, compared against the same month last year, for those patients where the PHQ-9 resulted in severe depression minus those test patients which you can find because they went through the step "Test case"?"
try instead
✅"How many care flows were completed this month, for patients with a PHQ-9 score equal or higher than 20?"
followed by
✅ "Of that number, how many of those patients were test patients? This is represented in the care flow by the patients going through the step "Test case"?"
Practical examples of good questions
Structure your prompts as questions, "How many ...", "What is ..."
Show me the MAP count for the last 3 months.
How many patients completed the Intake care flow in April this year?
What is the completion rate of Onboarding step in Hypertension care flow?
How many patients filled out the Depression Screening form in the last quarter?
What is the average PHQ-9 score for patients in the Anxiety care flow?