Skip to main content

Write a model check rule in plain language with AI

Describe what a good value looks like and Plannerly writes the verification rule, names the standard it used, and checks every value as correct, incorrect or missing.

Contents

TL;DR - Open Requirements, select Manage, then the robot button beside a requirement's Verification Rule. Describe what a good value looks like - for example "fire rating for classroom partitions in a school in Barcelona" - and select Generate. Answer any questions, check the rule and the standard it's Based on, then save. In Verify, select Check: every value is marked correct, incorrect or missing.

Good to know - watch in your language: open the YouTube player settings (the gear icon), then under Subtitles/CC choose your language or use Auto-translate. If an auto-dubbed track is available, you can also switch the spoken voice under Audio track.

Who this is for

Project members with the Manage Information Requirements permission write and save rules. Running a check in Verify needs the Manage Models permission. Managers have both by default. The Requirements panel isn't shown on phones.

Why it matters

"Every fire damper needs the warranty contact's email" takes seconds to write. Turning it into a rule a checker can run usually means a different person, a different tool and a regular expression nobody else can read - so it gets put off. If you can say it, you can check it: describe the rule in your own words and Plannerly writes the expression for you.


Before you start

  • The requirement already exists, for example one added by Create scope from a model, from the library, or written by hand as in Write checkable information requirements.
  • For rules that depend on a national standard, such as fire or acoustic classes, add the project's Address in Settings under Details. Plannerly passes the project's address to the AI so it can follow the standard where the project is. A place you name in your sentence wins over the project address.

Write the rule

  1. In Scope or Verify, select Requirements. The panel opens at the bottom of the screen.
  2. Select Manage.
  3. On the requirement you want to tighten, for example FireRating, select the robot button beside its Verification Rule (the tooltip reads "Describe the value you need and let AI build the verification rule."). You can also choose Define Rule (Using AI) from the rule list. The Define Rule (Using AI) window opens.
  4. Under AI prompt to describe your requirements:, say what a good value looks like. Be specific about the element, the building, the place and anything to reject. For example: Fire rating for classroom partitions in a school in Barcelona. Only accept uppercase classes, reject spaces or extra text.
  5. Select Generate.
  6. If something is unclear, the AI asks instead of guessing, under A few questions so the rule is right. Pick an option for each question, or choose Other and type your own answer, then select Continue. It asks up to three questions at a time, for at most two rounds.
  7. Read the result: the Regular expression, the standard it's Based on (when one applies) and the Explanation of RegEx, which starts with what the rule accepts.
  8. Select Save in the window, then Save in the Requirements panel.
Define Rule (Using AI): a fire rating rule written from plain language, then the next check marking each value correct, incorrect or missing. Watch this step in the replay.
Tip: treat Based on as a starting point. The window reminds you to check the values against your project's own requirements before you save - a client or a national annex can ask for more than the standard does.

Check the model against the new rule

  1. In Verify, select Check. The tasks whose rules changed need checking again.
  2. Select Check all N tasks (N is how many need checking), or check a single task from its own card.
  3. Open a task card and look at its Information row. Each requirement shows three counts, and a rule written with AI also shows What this rule accepts and what it's Based on.
  • Correct (green): the property is there and meets the rule.
  • Incorrect (amber): the property is there, but empty or the wrong value.
  • Missing (red): the property isn't on the element at all.

In the webinar, the same walls and doors that were all green under "any value" turned amber: the doors' acoustic rating was empty, and the walls carried 30 decibels where the rule asked for at least 50. The walls' fire rating met the 60-minute requirement. More on reading results: How to check a BIM model against information requirements.

Written once, checked the same way every time

AI writes the rule once. After that, the check is the rule itself, so every version of every model is judged the same way, for the same reason - unlike asking a chatbot, which can answer differently each time. The rule is saved with the requirement, together with what you asked for, your answers and the standard it's based on. To reuse it on another project, bring the requirement in with Browse Library and My Projects: it keeps its rule. See Add information requirements from a library.

Why this matters: a requirement nobody can check is just an opinion. A rule that says exactly what's acceptable - agreed, written down and applied to every model - is how a level of information need becomes something you can test rather than debate.

If it doesn't work

Values that look right show amber

A rule accepts only what it describes. Spaces, capitals and units count, so "EI 60" and "EI60" can be different values to a checker. Open the requirement's rule again and describe the variations you accept, or ask the modellers to use the agreed format.

There's no Based on line

The AI only names a standard when one clearly applies and it can tell which country the project is in. Name the place in your sentence, or add the project's address under Settings, Details, then select Generate again.

It says there was an issue receiving a response

"There was an issue receiving a response with your current prompt. Please try again." Select Generate again. If it keeps happening, make the sentence shorter and more specific.

The account has used up its AI allowance

Writing a rule uses your account's AI allowance. At the limit you'll see "This account has used up its AI allowance. Upgrade to Pro or Company to keep using AI." Choose a rule from the list instead, such as Value is one of (comma separated values), or see pricing.

Opening the window changed my rule

Selecting the robot button sets the row to Define Rule (Using AI) straight away. If you cancel, choose your original rule again from the list, or select Cancel in the Requirements panel to drop the change.


Common questions

Do I need to know regular expressions?

No. Describe the rule in plain language and AI writes the regular expression, with an explanation of what it accepts. If you know regular expressions, you can type or edit one yourself in the same window.

Does AI check the model every time?

No. AI helps write the rule. The check runs the saved rule against every value, so the result is repeatable and the same model always gets the same answer.

Can it follow my country's fire rating classes?

Often, yes. When your sentence or the project's address names a country or city and a published standard there defines the permitted values, the rule uses that standard's classes and shows it under Based on. Always check the values against your project's own requirements.

Which rules can I write this way?

Any rule about a property's value: classes, ratings, numbers within limits, codes that start or end a certain way, or text that must or mustn't appear. For simple cases the ready-made rules, such as Number greater than or Text starts with, work too.

Can I use the same rules in other tools?

Yes. Export your requirements as a buildingSMART IDS file. See How to export information requirements as an IDS file.



Take the free Certified Plannerly Professional course - short videos for every step, with a certificate when you finish.