Web Chat

The Web Chat is a built-in AI chat interface embedded in the BunkerM dashboard. It connects you to BunkerAI so you can ask questions, give commands, and control your broker with plain language - no Slack workspace or Telegram setup required.

How to Access

• Click Ask BunkerAI in the left sidebar.
• Or navigate to Tools > AI Chat.

The chat opens with your conversation history above and a message input at the bottom.

What You Can Ask

Broker status and monitoring

What is my broker status right now?
How many messages per second is the broker processing?
How many clients connected in the last hour?

Client and connection history

List all currently connected clients.
When did sensor-kitchen-01 last connect?
Show me clients that have not connected in the last 7 days.

Topic analysis and anomaly summaries

What topics are most active right now?
Summarize anomalies from the past 24 hours.
What was happening on my broker yesterday afternoon?

ACL management

Create a new client called gateway-01 with password mysecretpass.
Give client gateway-01 publish access to sensor/# and subscribe to config/gateway-01.
Create a role called sensor-write allowing publish to sensor/+/data.
Add client sensor-01 to the sensors group.
Disable client broken-device.

Agents

Create a watcher on sensor/temp/kitchen that alerts when value goes above 35.
Show me all active watchers.
Create a job that publishes "online" to system/heartbeat every minute.

Help and explanations

What is the difference between QoS 0, 1, and 2?
Explain how MQTT wildcards work.
Why would a client get disconnected by the broker?

The AI Has Direct Access to Your Broker

BunkerAI is not just a chatbot - it has live access to your broker's state:

• It can see your connected clients and their metadata.
• It knows your ACL configuration (clients, roles, groups).
• It can read retained topic values from the broker.
• It can access your anomaly history and current alerts.
• It can create, update, and delete clients, roles, groups, and agents.

When you say "create a client called sensor-01", it actually creates the client in Mosquitto's dynamic security. When you ask "what is the kitchen temperature?", it reads the live retained value.

Tips for Better Results

• Be specific about topics. Instead of "show me temperature", say "show me the current value of sensor/kitchen/temperature".
• Use topic annotations. If you annotate your topics in Settings > Annotations, you can use natural names like "all temperature sensors" instead of topic paths.
• Ask for explanations. If a response is unexpected, ask "why did you do that?" or "explain what just changed".
• Use context from previous messages. You do not need to repeat yourself - the AI remembers the current conversation.

Clearing Conversation History

1. Open the Web Chat.
2. Click Clear History or New Conversation.
3. Confirm the clear.

After clearing, the AI starts fresh without memory of previous conversations. Note that topic annotations are not affected - they persist separately.