Business process map diagrams from images
Summarize
Summary of Business process map diagrams from images
ServiceNow's AI Lens skill enables customers to automatically generate editable business process map (BPM) diagrams by uploading images of existing process diagrams created in any tool. This feature, available within the Enterprise Architecture (EA) Workspace, saves time by eliminating the need to manually rebuild diagrams already created elsewhere.
Show less
The AI Lens skill analyzes the uploaded image, identifies BPMN elements such as tasks, gateways, pools, and lanes, and reconstructs the process as a native BPM diagram linked to instance records where applicable. This generative AI skill is enabled by default for users with appropriate roles, depending on their ServiceNow license.
Key Features
- Image-to-Diagram Conversion: Upload an image to convert it into an editable BPM diagram that recognizes shapes, connections, pools, and lanes.
- Entity Synchronization: AI Lens maps recognized shapes to existing records in your ServiceNow instance or creates new records if no match exists, based on your permissions.
- Review State: Generated diagrams open in a review state where you can validate, edit, and adjust the diagram before accepting or discarding it.
- Editable Canvas: While in review, you can move, resize, add, remove, or replace shapes without losing connections or labels.
- Dual-Pane View: The canvas is split into two panes showing the generated diagram and the original source image side-by-side for easy comparison and adjustment.
- Shape Replacement and Re-linking: You can change a shape’s type or update its linked record while preserving diagram structure and connections.
- Required Skills: Activation of the “Create diagram from image” EA skill and the ServiceNow AI Lens platform skill is required to enable this feature.
Practical Use and Considerations
This feature is available only when creating new business process map diagrams—not for blank diagrams or other map types like business application hierarchy or capability maps. Discarding a generated diagram is permanent and deletes all associated data and the uploaded image.
AI Lens supports multiple AI model providers (Google Gemini, Azure OpenAI, and AWS Claude) configurable at the instance level. Proper permissions are essential to allow the creation of new records for recognized shapes.
Benefits for ServiceNow Customers
- Accelerates process documentation by automating diagram creation from existing images.
- Improves accuracy with AI-driven shape recognition and entity linking to your ServiceNow data.
- Offers flexibility to review and refine diagrams before committing to ensure correctness.
- Streamlines BPM diagram management within ServiceNow’s EA Workspace, enhancing collaboration and governance.
Use the ServiceNow AI lens skill to generate a business process map (BPM) diagram automatically by uploading an image of an existing process diagram from any tool.
The image-to-diagram feature in EA Workspace uses the ServiceNow AI Lens platform ServiceNow Otto® skill to analyze an uploaded image of a business process. It re-creates the process as a native, editable BPM diagram. This removes the need to manually rebuild diagrams that already exist in other tools.
When you upload an image, AI Lens identifies shapes, pools, lanes, gateways, and the connections between them. It maps recognized shapes to entities in your instance where matching records exist, and creates new records for shapes it can't find a match for, provided you have the appropriate permissions for the tables associated with those shapes. The generated diagram opens in a review state so you can validate, adjust, and then commit it.
In review state
An AI-generated diagram remains in Review state until you accept or discard it. While in this state:
- The canvas header displays an AI converted diagram badge.
- The Share button, Show Version, and the more actions menu are hidden until the diagram is accepted.
- The canvas is fully editable: you can move, resize, add, or remove shapes, change any shape type, or replace a shape with a different shape.
Selecting Accept All transitions the diagram to draft state and closes the reference image pane. New records staged during diagram generation are committed following the standard approval workflow for the respective tables. Selecting Discard permanently deletes the diagram, all associated versions, the artifact, and the uploaded image, and returns you to the diagrams list view.
Canvas layout in review state
After the diagram is generated, the canvas is divided into two panes:
- The upper pane displays the generated diagram with all identified shapes, connections, pools, and lanes.
- The lower pane displays the uploaded source image for reference.
Move the cursor over the divider between the two panes to reveal the Adjust Pane control. Drag the divider to resize either pane without overlap. After the diagram is accepted or discarded, the reference image pane closes and the canvas occupies the full area.
The shapes panel on the left is collapsed by default. Select the toggle to expand it and add shapes manually to the canvas.
How AI Lens generates the diagram
ServiceNow AI Lens processes the uploaded image and performs the following actions:
- Shape identification: AI Lens identifies BPMN shapes such as tasks, sub-processes, gateways, events, pools, and lanes. Shapes in the image that have no equivalent in the EA Workspace shape library are substituted with a generic rectangle on the canvas.
- Grouping: Shapes that appear in a grouped arrangement in the source image are also grouped in the generated diagram.
- Edge and label detection: AI Lens detects connections between shapes and any labels on those connections.
- Entity sync: For each identified shape, AI Lens checks whether a matching record exists in the corresponding table. If a match is found, the shape is linked to that record automatically. If no match is found, a temporary record is staged for the shape, provided you have the appropriate permissions for the tables associated with those shapes. If you don't have the required permissions, records aren't created for the corresponding shapes.
The uploaded image is stored as an attachment on the architectural artifact record.
Replacing shapes and updating linked entities
You can replace any shape on the canvas with a different shape type, or update the record a shape is linked to without changing the shape type. Select the shape to open its data panel on the canvas.
- To change the shape type, select the Shape Type list and choose the correct type from the list. All existing connections and their labels are preserved after replacement.
- To update the linked record without changing the shape type, use the Choose Existing or Create options in the Data panel to re-link the shape to a different record.
After a low-confidence shape is replaced, its orange border is removed and the low-confidence count in the canvas banner is reduced.
Required ServiceNow Otto skills
The image-to-diagram feature requires two ServiceNow Otto skills to be active: the Create diagram from image ServiceNow Otto for Enterprise Architecture (EA) skill, and the ServiceNow AI Lens skill for the platform. When either skill is inactive, the Import image button is hidden on the Diagrams page.
- Create diagram from image (EA)
-
Available under in AI Admin Hub. This skill is active by default. To verify or reactivate, navigate to , expand Technology, and select EA. Confirm the Create diagram from image skill card shows Active status. If inactive, select Activate skill on the skill card. For configuration details, see Configure ServiceNow Otto for Enterprise Architecture (EA).
- ServiceNow AI Lens (Platform)
-
Available under in AI Admin Hub. This skill must be activated by an administrator. AI Lens supports three AI model providers: Google Gemini, Azure OpenAI, and AWS Claude. The active provider is configured at the instance level under . For more information, see ServiceNow AI Lens and Configure ServiceNow AI Lens.