Guía de consulta para agentes de IA.

Flujo obligatorio

De la pregunta a una respuesta trazable

1. Preguntar el objetivo. No presupongas la pregunta de investigación. Pide al usuario qué necesita conseguir y el contexto mínimo.
2. Descubrir sin extraer. Busca con términos específicos y revisa el listado numerado; no contiene importes.
3. Seleccionar resultados pertinentes. Principalmente te pedirán buscar costes, aunque también puedes necesitar evidencia HEOR. Más abajo se explica cómo buscar cada tipo de dato. Para seleccionar costes, sigue estos principios:
   1. Ámbito territorial. Representa todo el territorio solicitado. Si son costes para España, busca en todas las CCAA posibles y, cuando las tarifas sean equivalentes, usa su media.
   2. Año objetivo. Los costes deben estar actualizados al año solicitado. Entre opciones equivalentes, elige la del año de origen más reciente que corresponda al periodo del análisis.
   3. Grado de detalle. Elige tarifas lo más generales posible cuando el usuario no especifique condiciones concretas. Una consulta de atención primaria sin más detalles requiere tarifas de consulta general, no modalidades específicas.
4. Explicar y citar. Indica qué se buscó, qué resultado se eligió, alcance, limitaciones y procedencia.

Mecánica de consulta

Cuando el objetivo requiera combinar tarifas

El agente adapta los términos al objetivo indicado por el usuario. Este ejemplo enseña el mecanismo, no una pregunta que deba asumir: busca en Tarifas A y revisa las denominaciones originales antes de decidir qué observaciones son comparables.

npx --yes @lynoraheor/cli tarifas-a "radiografía peroné"
# revisa el listado y selecciona únicamente candidatos pertinentes
npx --yes @lynoraheor/cli ver 1 3 6

# si la primera consulta no es suficiente, prueba un sinónimo específico
npx --yes @lynoraheor/cli tarifas-a "radiología simple rodilla"
npx --yes @lynoraheor/cli ver 1 2

Regla por defecto cuando el usuario pide costes. Interpreta la prestación, el territorio y el año objetivo. Si no están claros, pide esos datos. Busca tarifas generales cuando no se hayan solicitado detalles concretos, y usa sinónimos para cubrir todas las CCAA posibles del ámbito elegido. No elijas la primera coincidencia ni presentes una sola CCAA como representativa de España. Comprueba prestación, modalidad y unidad antes de considerar equivalentes dos tarifas.

Entre tarifas equivalentes, prioriza el año de origen más reciente compatible con el análisis. Comprueba la actualización al año objetivo: la API devuelve el importe y el año originales. Si hace falta reexpresar un importe, aplica un índice justificado y documenta el importe original, el índice y el cálculo; una actualización calculada no es una tarifa oficial nueva. No inventes una actualización ni mezcles importes de distintos años sin ajustarlos al mismo año objetivo.

Para costes de España, usa la media de las tarifas equivalentes que cubran las CCAA posibles. Evita dar más peso a una comunidad por disponer de más registros: si hay varias observaciones equivalentes dentro de ella, calcula primero su media territorial y después la media de las CCAA, con el mismo peso para cada una. Indica la cobertura y las ausencias; si no es representativa del ámbito solicitado, explica esa limitación.

En Tarifas puedes abrir hasta 50 resultados con ver 1 2; Licitaciones y HEOR se consultan de uno en uno.

Para la media, incluye una tabla con todas las observaciones usadas —denominación, importe, unidad, año, CCAA y fuente— y muestra también la media de cada CCAA cuando agregues varias tarifas de ese territorio. Expón el criterio de inclusión y exclusión, las CCAA cubiertas y ausentes, el número de observaciones, la media entre CCAA, la desviación estándar y el rango. No mezcles prestaciones, ámbitos asistenciales, unidades o años incompatibles ni inventes equivalencias clínicas.