Programación agéntica y FHIR
La programación agéntica introduce una nueva variable en el diseño de sistemas: el agente se convierte en un componente productor de código que debe operar dentro de límites arquitectónicos estrictos.
Muchas personas que experimentan con la programación agéntica coinciden en un principio clave: es imprescindible mantener el control sobre el agente. Sin una estructura y restricciones claras, un proyecto dirigido por agentes puede volverse rápidamente imposible de mantener.
Creemos que construir aplicaciones nativas en FHIR y utilizar FHIR como marco para la programación agéntica en el ámbito sanitario aumenta significativamente el nivel de control que se tiene sobre la arquitectura del sistema.
FHIR proporciona salvaguardas sólidas en varias áreas críticas.
Modelo de datos
Esta es una de las partes más fundamentales de cualquier aplicación. Cuando se utiliza un servidor FHIR como backend, se puede tener la certeza de que todos los datos producidos por el agente se almacenan como recursos FHIR válidos. El agente no crea formatos de datos personalizados. Todos los datos generados deben ajustarse a las estructuras estándar de recursos FHIR.
Patrones de interacción
Las especificaciones FHIR, como Subscriptions y SQL on FHIR, definen formas estandarizadas de interacción entre componentes. Esto reduce la ambigüedad en la lógica de integración e impide que el agente invente patrones de comunicación propios.
Terminology
FHIR fomenta el uso de sistemas de codificación bien conocidos, garantizando que la aplicación modele los datos mediante vocabularios interoperables y estandarizados.
Interoperabilidad por diseño
Los principios de diseño fundamentales de FHIR hacen de la interoperabilidad un comportamiento predeterminado y no algo que se añade a posteriori.
En esta entrada, presentamos un pequeño ejemplo de cómo aprovechar las capacidades agénticas para ocultar la complejidad de FHIR sin perder el control arquitectónico.
Ejemplo: creación de un dashboard de Peso del Paciente
Imagine una aplicación que utiliza un servidor FHIR para el almacenamiento. Por simplicidad, supongamos que solo tenemos dos tipos de recursos:
- Patient
- Observation (para el peso corporal)
Ahora queremos implementar una nueva funcionalidad mediante programación agéntica.
Objetivo
Implementar un dashboard de pacientes donde cada paciente pueda consultar la evolución de su peso corporal a lo largo del tiempo, basándose en los datos de Observation ya existentes.
Prompt
/aidbox-dashboard Let's implement a patient dashboard where each patient can view their body weight over time, based on
the Observation data we already have.
Resultado
Tras aproximadamente dos minutos de ejecución del agente, obtenemos un dashboard funcional.
Cómo funciona internamente
/aidbox-dashboard
es una habilidad de Claude definida en el repositorio que enseña al agente a construir dashboards.
La habilidad indica al agente que debe:
- Crear un recurso FHIR ViewDefinition
- Materializar el ViewDefinition en una vista de base de datos real
- Generar código de backend que consulte la vista directamente mediante SQL
- Construir código de frontend para renderizar el dashboard
También le indica al agente:
- Qué biblioteca de visualización de frontend utilizar
- Cómo interactuar con el servidor FHIR y la base de datos
- Cómo configurar el servidor FHIR para que los ViewDefinitions se desplieguen automáticamente
- Cómo depurar los problemas más habituales
En otras palabras, el agente ejecuta un manual arquitectónico controlado, en lugar de improvisar libremente.
Cómo probarlo
El código está disponible en el repositorio público.
Puede ejecutarlo de forma local. Requisitos:
- Docker
- Bun
- Claude Code
Pruebe a ampliarlo: por ejemplo, solicite a Claude que genere más datos de prueba o que construya dashboards adicionales utilizando la habilidad
/aidbox-dashboard.
¿Tiene preguntas o comentarios? Contáctenos a través del formulario que aparece a continuación.
