Recetario de campos

Ya conoces tu pantalla del EMR como un conjunto de campos de formulario — una caja de texto, un número, un dropdown, un checkbox. Un Smart Template es esa misma pantalla expresada como JSON: cada campo se convierte en una propiedad del OutputSchema de una sección. Esta página te da el JSON de cada tipo de campo y luego te guía para armar una plantilla completa.

Todo campo necesita instructions — ese es el prompt que el modelo usa para llenar el slot. Escríbelo como si instruyeras a un escriba: “el motivo principal de consulta, en palabras del paciente”.

Texto

Una entrada de texto libre o textarea.

<input type="text" name="chiefComplaint" />

{
  "type": "string",
  "instructions": "Chief complaint in the patient's own words",
  "maxLength": 500
}

Número

Una entrada numérica. Usa integer para enteros, number para decimales; acota con minimum / maximum.

<input type="number" name="weightKg" min="0" max="500" />

{
  "type": "number",
  "instructions": "Body weight in kilograms",
  "minimum": 0,
  "maximum": 500
}

Un <select> o un grupo de radio buttons — elige exactamente una opción. Usa { label, value } para almacenar un código estable y poder renombrar o traducir el label libremente. La generación retorna el value.

<select name="visitType">
  <option value="FIRST_VISIT">First visit</option>
  <option value="FOLLOW_UP">Follow-up</option>
</select>

{
  "type": "string",
  "instructions": "Type of visit",
  "enum": [
    { "label": "First visit", "value": "FIRST_VISIT" },
    { "label": "Follow-up",   "value": "FOLLOW_UP" }
  ]
}

Selección múltiple (grupo de checkboxes)

Un grupo de checkboxes donde se pueden seleccionar varias opciones a la vez — un array cuyos items llevan el enum.

<input type="checkbox" name="symptoms" value="FEVER" /> Fever
<input type="checkbox" name="symptoms" value="COUGH" /> Cough

{
  "type": "array",
  "instructions": "All symptoms the patient reports",
  "items": {
    "type": "string",
    "enum": [
      { "label": "Fever", "value": "FEVER" },
      { "label": "Cough", "value": "COUGH" }
    ]
  }
}

Sí / No (checkbox)

Un checkbox único es un boolean.

<input type="checkbox" name="followUpNeeded" /> Follow-up needed

{
  "type": "boolean",
  "instructions": "Whether a follow-up appointment is needed"
}

Fecha y hora

Una entrada de fecha u hora — un string con un format. El valor se retorna como ISO 8601.

<input type="date" name="visitDate" />

{
  "type": "string",
  "instructions": "Date of the visit",
  "format": "date"
}

Campo opcional

Por defecto todo campo es required: true (el modelo siempre produce un valor). Pon required: false para que retorne null cuando el encuentro no lo menciona.

{
  "type": "string",
  "instructions": "Secondary diagnosis, if any",
  "required": false
}

Valor por defecto

Combina required: false con default para garantizar un respaldo. Para un enum, el default debe ser uno de los value.

{
  "type": "string",
  "instructions": "Triage priority",
  "enum": [
    { "label": "Routine", "value": "ROUTINE" },
    { "label": "Urgent",  "value": "URGENT" }
  ],
  "required": false,
  "default": "ROUTINE"
}

No soportado

No hay lógica condicional en un Smart Template — nada de “mostrar el campo B solo si el campo A es X”. Keywords como anyOf, if/then/else, pattern y minItems se descartan silenciosamente. Modela la opcionalidad con required: false + default; pon la ramificación en la capa RPA. Lista completa: OutputSchema → No soportado.

Construye una plantilla, campo por campo

Lista los campos de tu pantalla

Anota cada campo del formulario y su tipo (texto, número, selección, checkbox, fecha).

Elige el JSON de cada uno

Usa el recetario de arriba para convertir cada campo en un OutputSchema.

Agrúpalos en una sección

Una sección es un object cuyas properties son tus campos — una sección por cada parte del registro.

{
  "type": "object",
  "instructions": "Consultation summary",
  "properties": {
    "chiefComplaint": { "type": "string", "instructions": "Main complaint" },
    "followUpNeeded": { "type": "boolean", "instructions": "Follow-up needed" }
  }
}

Adjunta una estrategia de prompt

Dale a la sección un telepatiaPromptId curado, o tu propio systemPrompt. Ver Secciones.

Créala y luego referénciala

POST /v1/medical-record-configurations (idempotente — contenido idéntico retorna el mismo id), luego pasa medicalRecordConfigurationId en set-consultation-context.

Receta completa: una plantilla de prescripción

Una plantilla completa que cubre cada tipo de campo — texto, número, selección única, selección múltiple, boolean y una fecha opcional con default:

curl -X POST https://scribe-api.telepatia.ai/v1/medical-record-configurations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Prescription",
    "configuration": {
      "prescription": {
        "systemPrompt": "Extract the prescription details from the consultation.",
        "schema": {
          "type": "object",
          "instructions": "Prescription issued during the visit",
          "properties": {
            "patientName": {
              "type": "string",
              "instructions": "Full name of the patient",
              "maxLength": 200
            },
            "itemCount": {
              "type": "integer",
              "instructions": "Number of medications prescribed",
              "minimum": 0,
              "maximum": 50
            },
            "visitType": {
              "type": "string",
              "instructions": "Type of visit",
              "enum": [
                { "label": "First visit", "value": "FIRST_VISIT" },
                { "label": "Follow-up",   "value": "FOLLOW_UP" }
              ]
            },
            "medications": {
              "type": "array",
              "instructions": "Medications prescribed, with dose",
              "items": {
                "type": "object",
                "instructions": "One medication entry",
                "properties": {
                  "name": { "type": "string", "instructions": "Generic or brand name" },
                  "dose": { "type": "string", "instructions": "Dose with unit, e.g. 500 mg" }
                }
              }
            },
            "followUpNeeded": {
              "type": "boolean",
              "instructions": "Whether a follow-up is needed"
            },
            "visitDate": {
              "type": "string",
              "instructions": "Date of the visit",
              "format": "date",
              "required": false,
              "default": "1970-01-01"
            }
          }
        }
      }
    }
  }'

Primeros Pasos

Consultas

Sesiones de Scribe

Soporte a la Decisión Clínica

Webhooks

Smart Templates

Plantillas de Sesión

Cuentas

Pacientes

Referencia

Recetario de campos