AseptSoft Core Documentation
AseptSoft Core Documentation
Breadcrumbs

AI Assistant

🤖 The AI Assistant is an intelligent copilot that helps you work with AseptSoft through natural language conversation. Ask it to create processes, configure equipment, manage automation data, navigate between steps, export documents, and more — all without memorizing ribbon buttons or command names.

⚠️ Beta Feature — The AI Assistant is currently in beta. Capabilities are being actively expanded, and further features will be added in future updates.

https://downloads.aseptsoft.ch/documentation/images/Productivity/AI-Assistant/ai-chat.png

💬 How to Access

  1. Open a module in AseptSoft.

  2. Navigate to the Module Ribbon.

  3. In the Data panel, click the AI button.

The chat window opens at a comfortable default size (1100 x 700 pixels) and can be freely resized. An active AseptSoft subscription is required.

🖥️ The Chat Window

The AI Assistant interface is organized into three areas:

Area

Description

Sidebar (left)

Your conversation list. Click + to start a new conversation. Past conversations are grouped by date (Today, Yesterday, Last 7 Days, etc.) and you can scroll or click Load More to browse older ones.

Main area

The conversation itself. Your messages appear on the right; the assistant's replies appear on the left with a 🤖 robot icon. While the AI is working, a streaming "Typing..." indicator is shown. Replies support full markdown formatting, and a copy button appears on hover for easy clipboard access.

Input area

A multi-line text box where you type your requests. Use the 📎 paperclip button to attach files for the AI to reference. Click Send to submit, or Stop to cancel a response in progress.

The header bar contains a model selector dropdown and a refresh button to reset the connection if needed.

🧠 What the AI Can Do

The AI Assistant can perform a wide range of actions across your module data. Below is a summary organized by category:

Category

Capabilities

📋 Process Design

Create, rename, and delete processes. Create, rename, reorder, duplicate, and delete steps within a process.

🧠 Algorithm Design

Create, update, and delete conditions with full field support — type, description, condition expression, actions, and transitions.

⚙️ States Matrix

Set individual or batch control module states per step. Clear states across steps.

📊 Data Definitions

Full create, read, update, and delete operations for States, Fluids, Parameters, and Variables.

🔔 Alarms

Create, update, delete, and duplicate alarms with all ISA-18.2 properties.

🔒 Valve Interlocks

Create interlock sets, add and remove interlock configurations.

🔄 Control Loops

Create, update, delete, and duplicate control loops.

🖥️ Dialogs

Create operator dialogs with controls such as buttons, text inputs, checkboxes, and dropdowns.

🏭 Equipment Modules

Create, delete, and rename Equipment Modules; add or remove members; save and apply configurations; highlight in drawing (Plant 3D edition only).

🗺️ Navigation

Navigate to any process, step, or condition. Step forward or backward through a process.

📂 Window Management

Open any AseptSoft window — Module Data, Search, Phase Graph, Status Editor, and more.

📤 Export

Export your module data to Word, Excel, or PDF.

💧 Fluid Simulation

Enable or disable fluid flow visualization, clear the simulation cache, highlight upstream or downstream flow paths.

🎯 Drawing Interaction

Highlight, zoom to, or select entities directly in the AutoCAD drawing.

ℹ️ Information Retrieval

List all module data, get active context, read states, phases, conditions, and control module configurations.

📖 Documentation

Search and read AseptSoft documentation without leaving the chat.

🔧 Model Selection

A dropdown in the chat header lets you choose which AI model powers the assistant. Models are loaded from a remote configuration and multiple AI providers are supported. Your choice persists across sessions — select the model that best fits your needs.

✅ Tool Confirmation

The AI Assistant uses a tiered confirmation system to keep you in control:

Tier

Behavior

Examples

Auto-execute

Read operations and most write operations proceed automatically without asking.

Listing steps, creating a process, setting a state

Delete confirmation

Destructive operations display a red confirmation button — you must approve before the action proceeds.

Deleting a step, removing an alarm

User interaction

The AI can ask you questions, present choices, or request yes/no confirmations when it needs more information.

"Which process should I add the step to?"

This means you never need to worry about accidental deletions — the AI always asks first.

🎯 Tool Cards

Every action the AI performs appears as an inline tool card within the conversation. Each card shows:

  • A category icon matching the action type

  • A human-readable description using real entity names (e.g., "Setting valve XV-101 to Open in Step 3" instead of technical identifiers)

  • A status indicator showing whether the action succeeded

  • A collapsible result section you can expand to see full details

Tool cards make it easy to follow exactly what the AI is doing on your behalf.

💳 Licensing

Detail

Description

Subscription

An active AseptSoft subscription is required to use the AI Assistant.

Credit-based billing

Usage is metered on a credit system. Only AI-generated output counts toward your usage — repeated context and system overhead are not billed.

Credit exhaustion

When your credits run out, a friendly message is displayed. Contact your administrator or Aseptconn to add more credits.

💡 Tips for Best Results

  • Be specific. "Create a step called Pre-Rinse in the CIP Caustic process" works better than "add a step."

  • Multi-step requests work. You can ask for several things at once: "Create 5 dialogs for operator confirmations at each CIP step."

  • The AI knows your context. It is aware of your currently active process, step, and condition — you do not need to repeat this information.

  • Attach files for reference. Use the 📎 button to attach documents, spreadsheets, or images that the AI can read and reference in its responses.

  • Use natural language. There is no special syntax — write your requests as you would explain them to a colleague.

🏭 Workflow Example — Building a CIP Process with AI

Here is a typical conversation showing how you might build a complete CIP process using the AI Assistant:

Step 1 — Create the process

🧑 "Create a new process called CIP Caustic"

🤖 The AI creates the process and confirms: "Process CIP Caustic has been created."

Step 2 — Add steps

🧑 "Add steps: Pre-Rinse, Caustic Circulation, Intermediate Rinse, Final Rinse, Drain"

🤖 The AI creates all five steps in order and confirms each one.

Step 3 — Configure states

🧑 "Set inlet valve XV-101 to Open and drain valve XV-102 to Closed in the Pre-Rinse step"

🤖 The AI sets the control module states and confirms: "XV-101 set to Open and XV-102 set to Closed in Pre-Rinse."

Step 4 — Export

🧑 "Export to Word"

🤖 The AI generates and exports the module documentation to a Word file.

In just four messages, you have created a complete process with configured steps and exported documentation.

⚠️ Limitations (Beta)

Since the AI Assistant is currently in beta, please keep the following in mind:

  • A module must be open for the AI to operate — it works within the context of your active module.

  • Equipment Module features (create, highlight in drawing, manage members) are available only in the Plant 3D edition.

  • Complex multi-step operations may take a few moments to complete.

  • Capabilities are being actively expanded — further features will be added in future updates.

  • Module Ribbon

  • Module Data

  • Process Design

  • Algorithm Design

  • Export