Guide—AI Assistant · Industrial Risk

✦What the AI assistant does

In the Industrial Risk module, the AI assistant supports several stages of analysis:

📋

a) From the scoping worksheet

Generates PHA, FMEA, HAZOP, LOPA, or Fault Tree scenarios from a text description and P&ID diagrams of your facility

🗂

b) Analysis from the model

Uses the existing facility model—systems, components, and functions—to propose an analysis consistent with its structure

🛡

c) Barrier-selection assistance

Suggests preventive and protective barriers suited to identified scenarios (Bow-Tie and LOPA)

In all three cases, the AI provides a starting point for validation by the project team—see Complete the generated analysis.

1Sign in to the application

Open app.polyodos.com or app.polyodos.com depending on your plan, in your browser. Enter your username and password, then click Sign in.

Home page after sign-in — Home after sign-in—project list

Access to the AI assistant depends on your account permissions. If the AI Configuration page menu is not visible, contact your administrator.

2Create an Industrial Risk project

From the home page, click New project. In the dialog, enter a name and choose Industrial Risk.

Field	Valeur
Project name	Ex : H₂SO₄ loading station
Type	Industrial Risk (active APR, AMDEC, HAZOP, LOPA, NP, FTA)
Storage	Local (browser) or Server (real-time sync)

The Multi-modules type also includes the Industrial Risk module when combining methods in one project.

Enable AI Mode

Depuis 1-Mes Projets, open the Options for the project and enable AI Mode —this enables AI-generation buttons in the application.

The AI Mode toggle is available only when your account has the corresponding permission, granted by an administrator or superadmin.

3Configure the AI assistant

The API key is stored only in your browser —it is never sent to Polyodos servers.

Open configuration

In the side navigation menu, click 3 Configuration IA (under Project Management).

Page Configuration IA — AI Configuration page—Gemini provider selected, key masked

Choose a provider

Provider	Benefits	Images P&ID
Gemini (Google) —recommended	Free, generous quota, fast	✓ Yes
Claude (Anthropic)	Excellent raisonnement technique	✓ Yes
Mistral AI	European models, GDPR	Depends on model
Groq	Very fast, free quota	Depends on model
Ollama (local)	100% local, no outbound data	Depends on model
HuggingFace (experimental)	Wide selection of open models	—
OpenRouter (experimental)	Gateway to many third-party models	Depends on model
⚙ Custom (experimental)	Custom URL and model for an internal OpenAI-compatible service	Depends on model

Each provider offers several models; only some accept images (see the P&ID Images column above).

Get a Gemini key

Open aistudio.google.com and sign in with your Google account
Click Get API key → Create API key
Copy the generated key (it starts with AIzaSy…)
Paste it into the API key field in Polyodos—saving is automatic

The key is saved as soon as it is entered. No Save button is required.

4Open AI Scoping

From your open Industrial Risk project, click ✦ AI Scoping in the side menu under Industrial Risk.

The page first displays the User Guide. Click ✦ Scoping worksheet to open the workspace.

Cadrage IA — guide d'utilisation — AI Scoping page—User Guide view with active provider shown at the top

AI Scoping—method tabs — Scoping worksheet—tab bar with six available methods

5Complete the description worksheet

Choose the method

⊙

Physical PHA

6–12 physical-risk scenarios

✦

Safety-report PHA

4–8 SEVESO hazardous phenomena

🔧

FMEA

6–10 failure modes

🔬

HAZOP

6–12 process deviations

🛡

LOPA

3–6 scenarios with IPLs and frequencies

🌳

Fault Tree

FTA tree with nodes and links

Download the worksheet template

Click ⬇ Download worksheet (.txt) to get a structured template containing the sections expected for the selected method. Complete it, then paste it into the text area.

Fiche AMDEC vide — FMEA tab—section guide and template download button

Write the description

The more detailed the description, the better the analysis. Include:

Facility name and type, substances present, and quantities
Operating conditions: pressure, temperature, and flow
Main equipment and functions
Existing safety barriers (relief valves, detectors, and procedures)
Incident history or known points of concern

Fiche remplie — Completed FMEA worksheet—full sections and description-detail indicator

Add P&ID diagrams (optional)

Drag images into the Diagrams or click to select them. The AI analyses them alongside the text. Accepted formats: PNG, JPG, and WebP, up to three images. Available with Gemini, Claude, and other engines whose selected model accepts images (see the table above).

Worksheet data is sent to the selected AI service. Do not include real confidential data in a test or demonstration context.

6Lancer l'analyse IA

Once the worksheet is complete and the API key configured, the ✦ Analyse and pre-fill button becomes active at the bottom of the page.

Click it. A confirmation dialog appears before import:

Click Lancer l'import to start generation.

Generation in progress—the button displays a timer; typical duration 15–45 seconds

7Results and import

A green card confirms the number of rows created and provides a direct link to the corresponding analysis page.

PHA import result — PHA result—created scenarios and link to the PHA page

FMEA after import — FMEA page—AI-generated rows ready for completion

If an error occurs

A red card displays the error message. Common causes:

Message	Solution
Enter an API key	Open AI Configuration and enter the key
high demand / overloaded	Gemini overloaded—try again in 30 seconds
API key not valid	Incorrect or expired key—check Google AI Studio
No valid JSON	Description too short—add detail to the worksheet

8Complete the generated analysis

AI-generated data provides starting points for validation and expansion by the project team.

PHA after import — PHA page—generated scenarios with S/L ratings to validate

HAZOP after import — HAZOP page—generated deviations with nodes and guide words

LOPA after import — LOPA page—scenarios with generated initiating frequencies and IPLs

Checks after import

Check the cotations G/V/IPR —the AI proposes indicative values for team validation
Complete the causes and consequences using the site's operating experience
Adapt preventive measures to the actual barriers in place
Remove generic or irrelevant rows from your context

The same worksheet can be reused for several methods. Return to AI Scoping, change tabs, and run again—each import adds rows without overwriting existing data.

AI does not replace domain expertise. It structures and accelerates initial work; the project team remains responsible for the analysis.