Saltearse al contenido
Nappai Documentation

BOE Norm Agent

El componente BOE Norm Agent es tu asistente experto en la normativa española. Su propósito principal es facilitarte el acceso al Boletín Oficial del Estado (BOE) de manera inteligente y rápida. A diferencia de otras herramientas que consultan la ley cada vez que preguntas, este componente utiliza una tecnología especial que “lee” y guarda el texto completo de la normativa de interés en la memoria del sistema.

Esto significa que una vez que seleccionas una ley o boletín, el agente realiza la búsqueda y carga de información una sola vez. Todas las consultas posteriores se resuelven de forma inmediata y local, garantizando velocidad y estabilidad, incluso si la conexión externa experimenta pequeños retrasos. Puedes utilizar este agente tanto para obtener el texto exacto de los artículos como para pedirle que analice y resuma la información en un lenguaje más comprensible.

¿Cómo funciona?

El funcionamiento del componente se basa en un proceso determinista y eficiente que protege tu flujo de trabajo de la latencia de red:

  1. Carga Inicial Única: Cuando el agente recibe una consulta vinculada a una norma específica, realiza automáticamente dos llamadas optimizadas a la API del BOE para obtener y almacenar el texto completo de dicha norma (índice, artículos, texto oficial). Esta fase de pre-carga se ejecuta una sola vez por norma.
  2. Búsqueda en Memoria: Una vez que la normativa está cargada en memoria, todas las búsquedas se resuelven localmente. El componente busca los artículos necesarios dentro de la información ya guardada, eliminando la dependencia de nuevas llamadas a la API y asegurando una respuesta predecible y rápida.

El componente ofrece dos formas de interactuar con la información:

  • Modo Recuperación: Devuelve el texto crudo y fragmentado de los artículos relacionados. Ideal cuando necesitas consultar el texto legal original sin modificaciones.
  • Modo Respuesta: Genera una respuesta sintetizada y contextualizada basada en los artículos recuperados. Optimizado para lectura directa o interacción con asistentes de IA.

Entradas

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente:

  • Inputs: Estructura de configuración donde se definen los parámetros clave para identificar la normativa objetivo, el texto de búsqueda y la selección del modo de operación. Aquí es donde indicarás qué ley deseas consultar y cómo deseas recibir la información.
    • Visible en: Configuración base del componente

Salidas

El componente devuelve un resultado estructurado que se adapta al modo de operación seleccionado en las entradas.

  • En modo retrieve, la salida contiene los textos crudos y fragmentados de los artículos encontrados, útiles para auditorías o referencia legal directa.
  • En modo answer, la salida proporciona una respuesta sintetizada, contextualizada y lista para ser consumida por el usuario o enviada a otros nodos.

Ejemplo de Respuesta JSON

A continuación se muestra un ejemplo de la estructura de respuesta que el componente devuelve cuando se ejecuta correctamente en modo síntesis de respuesta: json { “status”: “success”, “mode”: “answer”, “data”: { “synthesized_response”: “La normativa consultada establece que las obligaciones de seguridad deben revisarse trimestralmente según el artículo 5. Además, el artículo 8 prohíbe el acceso a zonas de riesgo sin autorización previa.”, “source_norm”: “BOE-A-2024-12345”, “articles_referenced”: [ “BOE-A-2024-12345-art-5”, “BOE-A-2024-12345-art-8” ], “confidence_score”: 0.92 }, “metadata”: { “processing_time_ms”: 120, “cache_hit”: true } }

Conectividad

Dado que este componente es un agente especializado en normativa, sus conexiones lógicas suelen integrarse en flujos que requieren procesamiento legal o validación de cumplimiento:

  • Entradas típicas: El componente suele recibir entradas de nodos que proporcionan identificadores de norma, fechas o textos de consulta, como nodos de “Texto”, “Usuario” o “Fecha”.
  • Salidas típicas: Las salidas del componente están diseñadas para conectarse a nodos que consumen la información legal, tales como:
    • Nodos de Formateo de Texto o Generación de Resúmenes para refinar la salida.
    • Nodos de Notificación para enviar resúmenes legales a correos electrónicos o plataformas de chat.
    • Otros Agentes de IA que requieran contexto legislativo para tomar decisiones posteriores.
    • Nodos de Base de Datos para almacenar las consultas y respuestas generadas.

Ejemplo de Uso

Imagina que estás automatizando el proceso de revisión de cumplimiento legal en una empresa. Puedes crear un flujo de la siguiente manera:

  1. Conectas un nodo de Texto que contiene el número de BOE y el artículo que deseas consultar.
  2. Conectas este BOE Norm Agent a ese nodo de texto y configuras la entrada para especificar la norma y seleccionar el modo “Answer” si deseas una explicación clara.
  3. El agente cargará la normativa y te devolverá una respuesta sintetizada.
  4. Conectas la salida del agente a un nodo de Envío de Correo Electrónico para recibir el resumen de las obligaciones legales directamente en tu bandeja de entrada cada semana.

Consejos y Mejores Prácticas

  • Fase de Desarrollo: El componente se encuentra en fase de desarrollo. Se recomienda realizar pruebas exhaustivas en entornos de control antes de integrar este agente en procesos críticos o de producción.
  • Estabilidad en Memoria: Una vez que la normativa se ha cargado exitosamente, el componente es resistente a fallos de red temporales. Las búsquedas subsiguientes en la misma norma se resuelven en memoria, por lo que no es necesario asegurar la conexión con la API del BOE durante toda la ejecución de la búsqueda.
  • Validación de Errores: Al estar en fase de pruebas, el componente activa validaciones estrictas y logs detallados. Si encuentras un error, revisa los registros del sistema para identificar si se debe a una configuración incorrecta de la norma o a la estructura de la consulta.
  • Eficiencia: Aprovecha la carga en memoria definiendo la norma una vez y realizando múltiples consultas sobre ella dentro del mismo flujo, maximizando la velocidad de respuesta.

Consideraciones de Seguridad

  • Acceso a Servicios Externos: El componente realiza llamadas a la API del BOE para la carga inicial. Asegúrate de que tu entorno de Nappai tenga permitida la conexión a servicios externos para permitir esta pre-carga inicial. Una vez cargada la información, el procesamiento interno se realiza de forma local.
  • Datos Públicos: El componente interactúa con datos del Boletín Oficial del Estado, que son de acceso público. No se manejan datos sensibles o privados durante la recuperación de normativa.