Patient-facing (coming soon)

Patient interview

Model: aug-interview · Status: Coming soon · Scope: agents:interview · Schema: interview_turn/0.1

Runs an adaptive history-taking conversation with a patient — in a chat widget, a kiosk, or WhatsApp — before or between visits. Each turn it asks the single most useful next question, chosen by the care model's ranking of missing observations (emergencies and severe outcomes first), in plain, culturally appropriate language. The result is a complete, coded observation set and a pre-visit summary for the clinician.

How a conversation works

Start a care-model session (or pass an existing one).
Send the patient's message. The model updates observations and returns the next question.
Repeat until status is complete or escalate.
Fetch the summary for the clinician (summary field on the final turn).

Request (one turn)

JSON

{
  "model": "aug-interview",
  "messages": [
    {"role": "assistant", "content": "Namaste! What problem would you like help with today?"},
    {"role": "user", "content": "Mujhe 3 din se bukhar hai aur sar dard"}
  ],
  "augsidius": {
    "audience": "patient",
    "locale": "hi-IN",
    "session": "cm_7f2…",
    "instructions": {"max_turns": 15, "reading_level": "simple", "channel": "whatsapp"}
  }
}

Response payload

JSON

{
  "status": "in_progress",
  "question": {
    "text": "Kya aapko gardan modne mein dard ya akdan mehsoos hoti hai?",
    "asks_about": {"name": "Neck stiffness", "concept_id": "…"},
    "answer_type": "yes_no_unsure",
    "quick_replies": ["Haan", "Nahin", "Pata nahin"]
  },
  "observations_added": [{"name": "Fever", "present": true, "duration": "3 days"}, {"name": "Headache", "present": true}],
  "red_flags": [],
  "turn": 2
}

When a red flag is detected, status becomes escalate and the payload contains an escalation with the advice to give and the urgency (for example go to the nearest emergency department now). Your product must show escalation advice immediately and prominently.

Final turn

JSON

{
  "status": "complete",
  "summary": {
    "for_clinician": "34M, 3 days fever and headache, neck stiffness since yesterday, no rash, no vomiting…",
    "observations": [ ],
    "open_questions": ["Level of consciousness not assessable remotely"]
  }
}

Safety behaviour (always on)

Never gives a diagnosis or medication dose to a patient.
Escalates on any red flag, regardless of other instructions.
Hands over to a human when the patient asks, is distressed, or the conversation goes off-topic.
Requires the project's patient-facing terms to be accepted in Graphite.

De-identification

Triage