Set Up AI Review on a Generic Form
AI Review checks a generic form the moment a worker submits it. It reads their answers against instructions you write, flags anything that falls short as Major or Minor, and, depending on how strict you set it, holds the submission until the worker fixes it.
You set AI Review up form by form, so a Take 5 can be checked differently from a plant pre-start. This article covers turning it on, writing the instructions, and choosing how strict it should be.
Before you start
- AI Review needs to be on your plan. If you can't see the AI Review toggle on a form, contact your Customer Success Manager.
- It works on generic forms only. Inductions, permits and other form types don't have the toggle and behave as they always have.
- Set it up on web. AI Review is configured in the web portal. Workers see the results on mobile when they submit.
Turn on AI Review
- On web, go to Editor > Forms.
- Open the generic form you want the AI to check or create a new form.
- Turn on the AI Review toggle.
- Fill in System instructions. See Write the system instructions below.
- Under When the AI finds issues, choose how strict the review should be.
- Save the form.
AI Review runs on every submission from then on. Submissions made before you turned it on show as N/A.
Write the system instructions
System instructions are a free text field where you tell the AI what matters on this form. The AI checks every submission against what you write here, so the clearer your instructions, the more useful its feedback.
Good instructions do two things:
- Say what to check. Name the questions or sections that matter and describe what a good answer looks like.
- Define Major and Minor. Spell out which gaps are serious enough to be Major and which are Minor. The AI uses your definitions to tag each finding, and that tag decides whether a worker can submit.
Tips for better instructions
- Be specific. "Hazards must each have a control" works better than "check the hazards are good".
- Use the same names as your form. If a section is called Task Steps on the form, call it Task Steps in your instructions.
- Only ask about what the form collects. The AI checks the questions the worker can see and has answered. Questions hidden by conditional logic are skipped, so they won't raise findings.
- Keep Major for what should stop work. If everything is Major, workers get blocked on wording and start to tune the feedback out.
Choose how strict it should be
The When the AI finds issues setting decides what happens when the AI flags something.
| Option | What happens |
|---|---|
| Must fix all issues before submitting | Any Major or Minor finding blocks the submission until the worker fixes it. |
| Can submit with minor issues (default) | Major findings block the submission. Minor findings show as a warning, and the worker can choose Submit anyway. |
| Can submit with any issues | Nothing blocks. The worker sees the feedback and can always choose Submit anyway. |
Which one to pick
- Can submit with minor issues suits most forms. The AI stops serious gaps without holding up work over wording.
- Must fix all issues before submitting suits high-risk work, such as working at heights, confined spaces or live electrical, where you'd rather work not start on a flagged form.
- Can submit with any issues suits a new form while you're still fine-tuning your instructions. Workers see the feedback without it stopping them.
What workers see when they submit
- If the AI finds nothing, the submission goes through as normal.
- If it finds issues, the worker sees each finding tagged Major or Minor, with the related questions highlighted on the form.
- The worker can fix their answers and resubmit, which runs the review again. Where your setting allows, they can choose Submit anyway instead.
- Saving a draft doesn't trigger a review. The AI only checks the form when the worker submits.
Check results in the register
Each submission in the form's register shows an AI Review status:
- Strong: no issues found
- Minor Issues: only Minor findings
- Major Issues: at least one Major finding
- N/A: not reviewed, for example because AI Review was off when it was submitted
Reviewed submissions also show a score. Open a submission to see each finding and its severity. Hosts can see the same results on mobile.
Fine-tune your setup
For a new form, start with Can submit with any issues and check the register for a week or two. If the AI flags things that don't matter, or misses things that do, adjust your system instructions. When the findings match what your safety team would pick up, switch to a stricter option.
Need help or have a question?
Contact our Support Team on 1300 744 666 or email support@breadcrumb.co.
We’re happy to help!