---
{
  "title": "Programación agéntica sobre FHIR: creación de dashboards",
  "description": "Utilice la programación agéntica sobre FHIR para crear un dashboard de Peso del Paciente a partir de un único prompt: modelo de datos, terminología y demostración en vivo con Aidbox.",
  "date": "2026-02-19",
  "author": "Aleksandr Kislitsyn",
  "reading-time": "5 minutes",
  "tags": [
    "Aidbox",
    "Analytics",
    "AI / Agents"
  ]
}
---

> For the complete documentation index, see [llms.txt](https://www.health-samurai.io/llms.txt).
> Use it to discover all available pages before guessing URLs.

---
## Programación agéntica y FHIR

La [programación agéntica](/blog/agents-are-not-humans) 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](/articles/sql-on-fhir-an-inside-look), 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)

![](image-1.avif)

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


```javascript
/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.
![](image-2.avif)
## Cómo funciona internamente

`/aidbox-dashboard`
es una [habilidad de Claude definida en el repositorio](https://github.com/Aidbox/examples/blob/main/developer-experience/agentic-coding-dashboard/.claude/skills/aidbox-dashboard/SKILL.md) que enseña al agente a construir dashboards.

La habilidad indica al agente que debe:
- Crear un recurso FHIR ViewDefinition
- [Materializar](/blog/introducing-materialize-sql-interface-for-fhir-data) 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.](https://github.com/Aidbox/examples/tree/main/developer-experience/agentic-coding-dashboard)

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.