Pipeline de triage

​

Paso 1 — Inspeccionar el caso de uso

1. Listar pacientes con nivel de riesgo rojo. El endpoint paciente list acepta el flag --riesgo (color del semáforo) y pagina los resultados con --page-size. La documentación del recurso está en cli/src/tecsas3_cli/resources/paciente.py:165-203.
2. Pasar la lista a ia ai-query. El recurso ia expone ai-query (ia.py:389-402) que recibe un prompt libre vía --pregunta y devuelve la respuesta del proveedor configurado (Gemini por defecto).
3. Exportar a FHIR. fhir export (fhir.py:120-138) acepta --formato fhir y opcionalmente --paciente (UUID) o --save para guardar a disco.

​

Paso 2 — Crear el archivo del pipeline

# Pipeline: triage de pacientes de alto riesgo -> resumen IA -> export FHIR
# Requiere: tenant con agente y plan configurados para /api/ia/v2/
steps:
  - id: high_risk_patients
    resource: paciente
    command: list
    args:
      _positional: []
      page-size: 50
      riesgo: rojo

  - id: triage_summary
    resource: ia
    command: ai-query
    args:
      pregunta: |
        Resume la siguiente lista de pacientes de riesgo rojo,
        identifica patrones y sugiere prioridades de atención:
        ${high_risk_patients}

  - id: export_fhir
    resource: fhir
    command: export
    args:
      formato: fhir
      save: true
    env:
      TECSAS3_TENANT: "${env.TECSAS3_TENANT}"
    continue_on_error: true   # el export no debe abortar el resumen IA

• id: en lugar de name: — el validador (pipeline.py:109-123) exige {"id", "resource", "command"} como mínimo. Renombrar name a id es la primera acción obligatoria.
• args: como mapa, no como lista — el orquestador expande cada par clave: valor a --clave valor (ver _args_to_argv() en pipeline.py:84-106). Pasar una lista desnuda con strings sueltos no llega al parser de Typer.
• continue_on_error: true en el export — si el export FHIR falla por un 404 paciente_no_encontrado, queremos que el resumen IA siga siendo entregado.

​

Paso 3 — Validar antes de ejecutar

tecsas3 --json --no-input pipe validate triage.yml

{
  "valid": true,
  "steps": 3,
  "ids": ["high_risk_patients", "triage_summary", "export_fhir"]
}

$ tecsas3 pipe validate triage.yml
# Error: Paso 0 (None) falta: command, id, resource

​

Paso 4 — Ejecutar y capturar todos los outputs

# Ejecución con output completo de los tres steps
tecsas3 --json --no-input pipe run triage.yml --output-all

# Si solo quieres ver el último step (el export FHIR), omite --output-all
tecsas3 --json --no-input pipe run triage.yml

# En modo dry-run imprime el plan sin invocar la API
tecsas3 pipe run --dry-run triage.yml

[
  {
    "id": "high_risk_patients",
    "status": "success",
    "exit_code": 0,
    "result": [
      {"id": 42, "nombre_completo": "Juan Pérez", "nivel_riesgo": "rojo"},
      {"id": 87, "nombre_completo": "Ana Gómez", "nivel_riesgo": "rojo"}
    ]
  },
  {
    "id": "triage_summary",
    "status": "success",
    "exit_code": 0,
    "result": {"respuesta": "Patrón identificado: 2 pacientes con HTA descompensada..."}
  },
  {
    "id": "export_fhir",
    "status": "success",
    "exit_code": 0,
    "result": {"bundle_type": "collection", "entries": 2}
  }
]

​

Paso 5 — Iterar y depurar

tecsas3 --json --no-input pipe run triage.yml --output-all \
  | jq '.[] | select(.status == "error")'

​

Errores comunes y cómo se manifiestan

​

Próximos pasos

• Combina este pipeline con batch run para ingestar los pacientes resultantes en otro tenant.
• Versiona los pipelines en git y valídalos en CI con tecsas3 pipe validate.
• Para prompts ricos, pasa el output completo como string multilínea con YAML | (como en el ejemplo de triage_summary).

​

Referencias

• cli/src/tecsas3_cli/resources/pipeline.py:46-65 — resolución de placeholders
• cli/src/tecsas3_cli/resources/pipeline.py:109-123 — _validate_steps() (campos mínimos)
• cli/src/tecsas3_cli/resources/paciente.py:165-203 — paciente list con --riesgo
• cli/src/tecsas3_cli/resources/ia.py:389-402 — ia ai-query
• cli/src/tecsas3_cli/resources/fhir.py:120-138 — fhir export con --formato fhir
• cli/data/pipeline_examples/triage.yml — origen del pipeline (con bug a corregir)