AI diagram generation

Before the AI features are available, the installation must be set up by an Admin:

If either condition is not met, the AI actions are unavailable. When a new diagram opens on its welcome dialog, Generate with AI is greyed out and reads either Ask an administrator to configure AI (the installation is not registered, or AI is not enabled for it, for example because AI consent was withdrawn: contact your Admin) or AI generation is currently unavailable (the AI status could not be read: reload the page, and contact your Admin if it persists). If the AI service itself is down, the option is not greyed out: the request fails instead (see When an AI request fails). See First-time setup and Application settings.

The quickest way is to choose AI when you create the diagram:

The diagram is created, the editor opens and generation starts on its own. The wizard’s Generate with AI choice is never greyed out: if AI turns out to be unavailable for the installation, the diagram is still created, and the editor opens on the Welcome to your new diagram! dialog, where you can choose Start from scratch. If the request is refused because AI is not enabled (AI generation is not enabled. Ask an administrator to configure it.), you are taken back to the Home page and the empty diagram is deleted.

You can also generate from the editor, on a diagram you are working on:

If the canvas is not empty, you are asked to confirm first: Replace the current diagram? — the generated diagram replaces everything on the canvas.

A clear, structured description gives the best result. For example:

Generation runs as a background job, so it survives a closed tab, a network drop, or a proxy that cuts the connection. The diagram is still produced and delivered to you when you return.

After you submit, a progress overlay opens and the bar advances through honest, phase-based steps:

When an estimated time is known, the bar fills smoothly toward the next phase; otherwise it shows an indeterminate pulse rather than a fabricated percentage. Click Continue working to dismiss the overlay without cancelling — the job keeps running and the result is imported when it completes. What you change on the canvas meanwhile is replaced by the result: see Other people are paused while AI edits.

When the job succeeds, the diagram is placed on the canvas, zoomed to fit, and saved automatically. Review it before you export it: a generated diagram is not passed through the element conversion that a file import applies, and it does not produce entries in the Import Logs tab.

If you close or reload the editor while a job is in flight, Bonita Process Designer reattaches to it the next time you open the diagram in the same browser: a running job resumes its progress display, a job that finished while you were away is applied when you return, and a result that is no longer available shows a warning. If the canvas already has content, you are first asked to confirm the replacement: Replace the current diagram? If you decline, the result is discarded: Kept your current diagram — the generated result was discarded. The result of a finished job is kept for 24 hours by default; the person who installs Bonita Process Designer can change this with a server setting.

Open the AI panel from the bar on the far left of the editor. It has Generate, Modify, and Analyze tabs.

Modify and Analyze run as background jobs, like generation. While one runs, the panel shows a progress bar, an elapsed-seconds counter and a message such as AI is applying your change — this may take 20-40 seconds. If you reload the editor meanwhile, the job is picked up again when you come back, in the same way as a generation: Resuming your in-progress AI change… or Resuming your in-progress analysis….

While a Generate or Modify request runs on a diagram, the people editing it with you are paused: their editor shows AI is editing this diagram for <name> — editing is paused until it finishes., and they cannot change the diagram until the lock lifts, shortly after the request is over. You, the person who started the request, can keep working, but what you change meanwhile is replaced when the result arrives: you are first asked Replace the current diagram?, and if you decline, the result is discarded. Analyze does not pause anyone. See While AI is editing the diagram.

Each tab of the AI panel has an AI provider list. It opens on the provider your Admin set as preferred, when there is one, and otherwise on Default (configured provider). You can pick another configured provider. Your choice applies to that one request only — it does not change the installation default and is not remembered for the next request. When no provider is configured, the list is disabled and the hint under it reads No AI provider is configured — ask an administrator.

A failed request shows a message explaining what went wrong, for example The AI service is temporarily unavailable. Please try again in a moment. or The AI generation took too long and was stopped. Please try again. Most failures are temporary: try again.

When the failure happened on the server or on the AI service, the message also shows a Support ID with a Copy button (Quote this ID when you contact Bonitasoft support.). For Generate, the ID appears in a notification that stays until you close it; for Modify and Analyze, it appears in the AI panel. Give this ID to your administrator or to Ofelia Support: it identifies your request, on the AI service too. See The Support ID of an AI failure.

When generation of a new, empty diagram fails, the welcome dialog opens again so that you can retry or start from scratch.

Each group can have a cap on the number of AI requests it may run over a rolling 30-day window. The cap is set per group by an Admin and is shared by everyone in the group, regardless of role.

The window is rolling: there is no scheduled reset. Older requests simply age out of the 30-day window, freeing capacity again.

When a group is at its limit, the request is refused before any AI work starts, with the message Your group has reached its AI generation quota for the last 30 days. Ask an administrator to raise the limit. Wait for usage to age out of the window, or ask an Admin to raise the limit.

For setting and monitoring quotas, see Manage AI quota.