Docs
AI Agent
The AI Agent is your assistant within the Blockbax Platform. Ask questions in plain language and the agent looks up the relevant subjects, metrics, events and alarms in your project to answer them. It helps you understand what is going on and decide on a next step, without having to know exactly where to look.
Using the agent
Open the agent with the AI Agent icon in the top bar. The agent opens in a side panel, so you can keep working in the platform while you chat.
Ask a question
Type your question in the Ask Blockbax field and send it. When you start a new conversation, the agent suggests a few questions to get you going.
The agent reads the information in your project and combines it into an answer, using text, tables, graphs or other widgets. Some examples of what you can ask:
- Your setup: “How is this project set up?” or “What does the metric Flow rate measure?”. The agent can explain your subject types, properties, metrics and event triggers.
- Subjects and readings: “What is the latest pressure of pump P-102?” or “Which turbines had the highest peak last week?”
- Status and causes: “Which subjects are in Problem right now, and why?”
- Alarms: “List the open alarms with the highest priority” or “Did this alarm happen before, and how was it handled?”
- Graphs: “Chart the temperature of Line 3 over the last 7 days.” You can add graphs to a dashboard.
You can also ask broader questions, such as whether a pressure drop differs from the usual daily pattern, or ask for a short summary of an alarm to paste into a work order for a mechanic. Not sure whether the agent can help with something? Just ask it what it can do.
See which data is used
While the agent works on an answer, it shows the steps it takes, such as searching for subjects, reading the project configuration, looking at alarms or reviewing the event history. Expand these steps to see which data the agent used.
Suggested actions
After an answer, the agent often shows Suggested actions above the input field. These are follow-up questions based on the conversation so far, such as charting a metric for a specific subject or ranking subjects by their highest value. Click a suggestion to send it right away, or ignore it and type your own question to continue the conversation. You can collapse the suggestions with the arrow next to Suggested actions.
Add a widget to a dashboard
When the agent shows a visual in the conversation, such as a graph, you can add it to a dashboard as a widget, with live data. This way you can go from a question to a widget you keep monitoring, without configuring it yourself.
For example, to add a graph to a dashboard:
- Click the plus button (Add graph to dashboard) in the top right corner of the graph.
- Select the Target dashboard.
- Click Add to dashboard. The dashboard opens in edit mode, with the graph added as a new widget at the end.
- Review the dashboard. You can still move or resize the widget before saving.
- Click Save to keep the changes, or Cancel to discard them. The widget is only added once you save.
To take a closer look at a widget first, click Show full screen next to the plus button.
Conversations and feedback
From the panel header you can start a new conversation, view your previous conversations, expand the panel or close it. Below each answer you can copy the answer, give feedback with a thumbs up or down, or let the agent write a new answer.
Managing the agent
Permissions
Access to the AI Agent is managed per role. All default roles can use the agent. For custom roles, you add the AI Agent permission yourself. If a member doesn’t see the AI Agent icon in the top bar, their role doesn’t have this permission.
The agent respects the user’s permissions, so it can only see what it is allowed to see in the project. It only reads data and cannot change anything in the platform. When the agent suggests an action, such as creating a work order, it always requires manual action from the user.
Agent settings
You can tune the agent for a project under Project settings > General > Agent settings. Only owners and administrators can change the agent settings.
Guidance
Use guidance to give the agent project context and instructions it should use in every response. For example, explain how your installations are organized, what certain metrics mean, or how you want answers to be formatted.
Skills
Skills are reusable prompts for tasks you do often, such as writing a work order summary in a fixed format. Add a skill with the plus button and give it a name and description. To use a skill, pick it from the Skills menu below the input field, or type / in the input field to choose one from a list.



