Un Smart Template es un mapa de secciones. Cada sección es un nodo con esta forma:
{
"instructionSet": { "telepatiaPromptId": "...", "values": { /* ... */ } }, // opcional
"systemPrompt": "...", // opcional
"schema": { /* OutputSchema */ } // requerido
}
Resolución de prompt (cascada gana-el-primero)
Para cada nodo, Telepatia elige el prompt en este orden:
systemPrompt — su propio prompt inline (Nodo Custom).
instructionSet.telepatiaPromptId — un prompt Telepatia curado (Nodo Telepatia — recomendado).
- Fallback genérico — sin prompt; la extracción es guiada solo por
schema.instructions.
Prefiera nodos Telepatia cuando aplique. El equipo clínico de Telepatia cura y actualiza los prompts detrás de cada telepatiaPromptId. Obtiene calidad clínica sin asumir prompt-engineering. Vea el Catálogo de Nodos Telepatia.
Los nodos corren en paralelo. Un nodo fallido no bloquea a los otros — simplemente regresa con status: "failed" y un mensaje de error.
Nodo Telepatia (recomendado)
Referencie un prompt curado por id. Opcionalmente pase values para ajustar el comportamiento (vea el catálogo para los parámetros disponibles).
"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" }
}
}
}
Nodo Custom
Escriba su propio prompt. Control total — y responsabilidad total.
"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 nodos Custom cuando:
- La sección no está cubierta por un nodo Telepatia.
- Necesita formulación o formato específico de la institución.
- Está mapeando literalmente un esquema EHR propietario.
¿Se ve escribiendo el mismo prompt Custom en muchos templates? Contáctenos — es candidato a convertirse en nodo Telepatia.
Fallback genérico
Si no proporciona ni systemPrompt ni instructionSet, Telepatia extrae el campo de la transcripción usando solo schema.instructions.
"weightKg": {
"schema": { "type": "number", "instructions": "Patient weight in kg" }
}
Úselo solo para campos simples e inequívocos. Para cualquier cosa clínica, prefiera un nodo Telepatia.
Mezclando modos
Puede mezclar nodos Telepatia, Custom y fallback en el mismo Smart Template. Cada sección resuelve independientemente.