GraphiteGraphite by Augsidius
Live models

Clinical entity extraction

Model: aug-extract · Status: Preview · Scope: agents:extract · Sessions: no

Finds the clinical content in any text — notes, case summaries, referral letters, transcripts, patient messages — and returns it as structured entities: what was said, where, whether it is present or ruled out, when, with values, linked to a clinical concept and to standard codes where mapped.

Request

JSON
{
  "model": "aug-extract",
  "messages": [{"role": "user", "content": "58 year old man, known T2DM on metformin 1g BD and ramipril. 2 days of fever 39.2, severe headache and neck stiffness, no rash. Vomited twice. eGFR 25. BP 150/90."}]
}

Abbreviations common in Indian clinical writing (k/c/o, c/o, x 2 days, R/E, OD/BD/TDS, SOS) are understood. Input up to about 4,000 tokens per call; up to 150 entities are returned.

Response

message.content is JSONL — one extraction.entity per line, in the order they appear:

Text
{"object":"extraction.entity","text":"T2DM","span":[23,27],"category":"history","status":"present","temporality":"current","value":null,"unit":null,"concept":{"id":"c_dcab…","name":"Type 2 diabetes mellitus","kind":"condition"},"codes":[]}
{"object":"extraction.entity","text":"metformin","span":[31,40],"category":"drug","status":"present","temporality":"current","value":"1g BD","unit":null,"concept":{"id":"c_wibi…","name":"Metformin","kind":"drug"},"codes":[]}
{"object":"extraction.entity","text":"fever 39.2","span":[71,81],"category":"measurement","status":"present","temporality":"current","value":"39.2","unit":"C","concept":{"id":"c_qbxn…","name":"Fever","kind":"clinical_measurement_finding"},"codes":[]}
{"object":"extraction.entity","text":"rash","span":[122,126],"category":"sign","status":"absent","temporality":"current","value":null,"unit":null,"concept":{"id":"c_g7dh…","name":"Rash","kind":"examination_finding"},"codes":[]}
{"object":"extraction.entity","text":"Vomited","span":[128,135],"category":"symptom","status":"present","temporality":"current","value":"twice","unit":null,"concept":{"id":"c_sypy…","name":"Vomiting","kind":"complaint"},"codes":[{"system":"http://snomed.info/sct","code":"422400008","status":"provisional"}]}
{"object":"extraction.entity","text":"eGFR 25","span":[143,150],"category":"lab","status":"present","temporality":"current","value":"25","unit":"mL/min/1.73m2","concept":{"id":"c_qosl…","name":"Decreased glomerular filtration rate","kind":"clinical_measurement_finding"},"codes":[]}

The summary (message.augsidius, or the last NDJSON line):

JSON
{"object": "extraction.summary", "demographics": {"age_years": 58, "sex": "male", "pregnant": false},
 "entities": 10, "linked": 10, "coded": 3}

extraction.entity

Field Values
text Exactly as written in your input.
span [start, end] character offsets in the joined user text, or null if the text could not be located.
category See below.
status present, absent (negated: "no rash", "denies chest pain"), possible (suspected, to be excluded, or a medicine being considered).
temporality current, past (resolved or previous) or family (in a relative).
value, unit Measurement values, results, doses and frequencies ("1g BD").
concept The matched concept, or null. Abnormal values are interpreted: "eGFR 25" → Decreased glomerular filtration rate, "temp 39.2" → Fever.
codes Codings for SNOMED CT and ICD-11 where mapped.

Categories

category Covers Example
condition Diagnoses and disorders pneumonia
symptom What the patient reports headache, burning micturition
sign Examination findings neck stiffness, pallor
measurement Vital signs, bedside measurements BP 150/90, SpO2 88%
lab Laboratory results eGFR 25, K 5.9
test Investigations mentioned without a result CT head planned
drug Medicines (generic name in concept) metformin 1g BD
procedure Procedures and therapies appendicectomy
history Past history and known conditions k/c/o T2DM
risk_factor Exposures, habits, demographics smoker, travel to endemic area
allergy Allergies and intolerances allergic to sulpha

About codes

Codes are returned only where a mapping exists, and in this preview every code is marked "status": "provisional". Mapped coverage today is mainly conditions and common findings. Verification against the official SNOMED CT and ICD-11 releases is in progress; verified codes will say "verified", and coverage will grow without any change to the response shape. Until then, review codes before using them for billing, registries or claims, and rely on the concept id for matching inside Augsidius.

Using the output

  • Entities with status present or absent can be sent to a care-model session as observations, using concept.id.
  • Highlight span ranges in the source text so users can see what was understood.
  • Show absent and family entities distinctly — they are not the patient's current findings.

Price: 15 units per call per 500 input tokens — see Plans & billing.