Skip to content
Nappai Documentation

BOE Norm Agent

The BOE Norm Agent acts as a smart assistant for Spanish legislation stored in the Official State Gazette (BOE). It helps you explore laws, find specific regulations, and get answers based on official legal text.

The component uses a predictable workflow to ensure you get accurate results quickly. When you request information about a specific law, the component first fetches the complete text of that law from the BOE database. It stores this text in memory, similar to opening a book and keeping it open.

Once the law is loaded, any questions you ask are answered instantly by searching through the stored text. This means the component does not need to make additional requests to the external service for every query, making the process faster and more reliable. It can operate in two modes: retrieving raw article text for detailed review or generating synthesized answers that summarize the relevant information in a user-friendly way.

Connection & Credentials

This component requires configuring a credential in the Nappai panel before interacting with the external service:

  1. Go to the Credentials section in your Nappai panel.
  2. Create a new credential of the type specified for this component and fill in the required fields (API Keys, tokens, etc.).
  3. In your workflow, select the saved credential in the Credential input field of this node.

Inputs

Input Fields

The following fields are available to configure this component. Each field may be visible in different operations:

  • inputs: A structured parameter container that holds the settings for identifying the target regulation, entering your query text, and selecting the operational mode. This includes identifiers for the law or bulletin, search text, and flow configurations.
    • Visible in: All modes

Outputs

The component returns a structured result based on the mode you select. In retrieve mode, it provides the raw text of articles. In answer mode, it provides a synthesized response ready for consumption.

Output Data Example (JSON)json

{ “status”: “success”, “mode”: “answer”, “result”: “Based on the legislation, overtime pay must be compensated as follows…”, “articles_found”: [ { “id”: “art_5”, “text”: “Articles regarding overtime…” }, { “id”: “art_12”, “text”: “Compensation rules…” } ] }

Connectivity

This component is designed to feed legal information into your workflow. It typically connects to downstream components that need to analyze, summarize, or act upon legal text.

Connect the output of this component to inputs of components such as Text Processors, Summarizers, or Decision Makers. This setup allows you to build workflows where the agent provides the legal context, and subsequent components handle further processing or decision-making based on that law.

Usage Example

Scenario: Checking Compliance with a New Regulation

You are creating a workflow to verify if a company policy complies with Spanish labor laws.

  1. Configure the BOE Norm Agent and provide the credential.
  2. In the inputs, specify the regulation (e.g., Labor Law) and enter your query text (e.g., “What are the regulations for remote work?”).
  3. Select the answer mode to get a clear summary.
  4. Connect the output to a Notification component to alert the user.

Result: The agent loads the relevant law, finds the articles about remote work, and returns a synthesized answer that is sent as a notification to the user.

Tips and Best Practices

  • Use answer mode for quick, easy-to-read summaries of legal requirements.
  • Use retrieve mode when you need the exact wording of articles for auditing or detailed analysis.
  • Ensure the regulation identifier in inputs is accurate, as the component pre-loads data based on this value.
  • The component works efficiently after the initial data load, so multiple queries on the same law will be fast.
  • Since this component is in a development phase, verify results carefully in staging environments before using them for critical decisions.

Security Considerations

This component interacts with the official BOE database. Ensure that your credentials are stored securely and not exposed in public workflows. Be mindful of data privacy when inputting queries, as the component processes the text against the official database. The deterministic nature of the component helps ensure consistent results, but always verify outputs in development environments before relying on them for critical decisions.