For the complete documentation index, see llms.txt. This page is also available as Markdown.

Architecture & Process Diagrams

The AI Assistant can build structured diagrams that follow a notation, not just free-form boxes and lines. Ask for a BPMN process, a C4 architecture or an ArchiMate view, and the Assistant picks the right shapes from your shape libraries, places containers correctly and connects everything with the right relationship types.

A three-lane BPMN process built from one prompt

Supported Notations

Notation
What the Assistant builds

BPMN

Pools and lanes, tasks, start/end events, gateways and sequence flows. Hand-offs between actors run left to right across the lanes of one pool.

C4

Person, System, Container and Component shapes inside the matching boundaries.

ArchiMate

Elements from the ArchiMate library grouped into ArchiMate Groupings, with the relationship types the notation expects.

The shape libraries must be installed in your instance. If a library is missing, the Assistant falls back to Basic Shapes and tells you so. See Shape Libraries.

Writing a Good Prompt

Name the notation, the actors or layers, and the decision points you care about:

  • "Create a BPMN process for purchase order approval with three lanes: Requester, Manager and Finance. Include a decision for orders above 10,000."

  • "Draw a C4 container diagram for our online shop: web app, API, payment service and a PostgreSQL database."

  • "Build an ArchiMate application layer view of the HR landscape from the records on this board."

The Assistant works inside the diagram type you name. Asking for "a process" without saying BPMN gives you a plain flowchart.

Working with Your Existing Records

When a prompt mentions something that already exists in your Data Hub, the Assistant reuses that record instead of drawing a duplicate:

  • Existing records keep their binding, so Realtime Indicators and the Data Panel keep working.

  • Relationships between existing records use a real, configured relationship type where one is verified. A visual connection is the fallback.

  • Records that do not exist yet are staged as future-state proposals you can commit later.

Clarification Questions

If a request is ambiguous, for example two records share a name or the actors of a process are unclear, the Assistant asks a short clarification question before drawing. Answer it in the chat and the diagram continues. This only happens when a guess would likely be wrong.

Editing a Generated Diagram

Follow-up prompts keep the structure intact:

  • "Add a step 'Check budget' in the Finance lane after the approval." places the new task inside that lane.

  • "Move the gateway to the Manager lane." keeps the flow attached.

  • "Rename the pool to 'Procurement'."

After Add or Merge, only the parts that changed are selected, so you can see what the Assistant touched.

Tips

  • Pick a stronger model for large diagrams. See Choosing a Model.

  • Let the Assistant place things, then tidy with the format toolbar. Nudging a lane by hand is faster than describing the move.

  • For a whole department's process, build one pool per system boundary rather than one pool per person.

Last updated