Skip to main content
A Smart Template is a map of sections. Each section is a node with this shape: 
{
  "instructionSet": { "telepatiaPromptId": "...", "values": { /* ... */ } }, // optional
  "systemPrompt": "...",                                                     // optional
  "schema": { /* OutputSchema */ }                                           // required
}

​
Prompt resolution (first-match-wins waterfall)

For each node, Telepatia picks the prompt in this order:
  1. systemPrompt — your own inline prompt (Custom node).
  2. instructionSet.telepatiaPromptId — a curated Telepatia prompt (Telepatia node — recommended).
  3. Generic fallback — no prompt; extraction is driven only by schema.instructions.
Prefer Telepatia nodes when one fits. Telepatia’s clinical team curates and updates the prompts behind each telepatiaPromptId. You get clinical quality without owning prompt-engineering. See the Telepatia Nodes catalog.
Nodes run in parallel. A failed node does not block the others — it simply comes back with status: "failed" and an error message. Reference a curated prompt by id. Optionally pass values to tune behavior (see the catalog for available knobs). 
"chiefComplaint": {
  "instructionSet": {
    "telepatiaPromptId": "CHIEF_COMPLAINT",
    "values": { "language_type": "quotes" }
  },
  "schema": {
    "type": "object",
    "instructions": "Extract the chief complaint",
    "properties": {
      "chiefComplaint": { "type": "string", "instructions": "Patient's own words" }
    }
  }
}

​
Custom node

Write your own prompt. Full control — and full ownership. 
"dischargeSummary": {
  "systemPrompt": "Generate a discharge summary based on the encounter.",
  "schema": {
    "type": "object",
    "instructions": "Discharge summary",
    "properties": {
      "summary": { "type": "string", "instructions": "Concise discharge text" }
    }
  }
}
Use Custom nodes when:
  • The section isn’t covered by a Telepatia node.
  • You need institution-specific phrasing or formatting.
  • You’re matching a proprietary EHR schema verbatim.
Finding yourself authoring the same Custom prompt across many templates? Reach out — it’s a candidate for becoming a Telepatia node.

​
Generic fallback

If you provide neither systemPrompt nor instructionSet, Telepatia extracts the field best-effort from the transcript using only schema.instructions. 
"weightKg": {
  "schema": { "type": "number", "instructions": "Patient weight in kg" }
}
Use this only for simple, unambiguous fields. For anything clinical, prefer a Telepatia node.

​
Mixing modes

You can mix Telepatia nodes, Custom nodes, and fallback nodes in the same Smart Template. Each section resolves independently.