Zum Hauptinhalt springen
connic
Starte kostenlos

MQTT

Jede Nachricht eines Geräts oder einer Maschine auf einem passenden Topic startet einen Agent-Run, und die Ergebnisse gehen zurück auf ein Topic. connic hält eine persistente Session, damit der Broker Nachrichten zurückhält, während connic getrennt ist.

Modi
Inbound, Outbound
Einrichtung
Dashboard oder connectors/*.yaml
Dokumentation
MQTT Docs
Publisher
Von connic

Mach aus jeder Nachricht einen Run

Eine eingehende Verbindung abonniert einen Topic-Filter und startet jeden verknüpften Agenten einmal pro Nachricht, mit der Nachricht als Eingabe.

Wildcards im Filter
+ steht für eine Topic-Ebene, # für alle restlichen. So folgt eine Verbindung jeder Linie, jeder Maschine oder jedem Standort.
JSON bleibt, wie es ist
Ein JSON-Objekt kommt mit seinen Feldern auf oberster Ebene an, ergänzt um _mqtt mit Topic, QoS, Retain-Flag und den User Properties von MQTT 5.
Text bleibt Text
Jede andere UTF-8-Payload landet unter message: andere JSON-Werte geparst, reiner Text als String.
message on factory/line-1/alarms
{
  "machine": "press-4",
  "alarm": "overtemperature",
  "value": 92.5
}
context["payload"]
{
  "machine": "press-4",
  "alarm": "overtemperature",
  "value": 92.5,
  "_mqtt": {
    "topic": "factory/line-1/alarms",
    "qos": 1,
    "retain": false,
    "duplicate": false,
    "user_properties": { "message_id": "press-4-1731840000" },
    "content_type": "application/json"
  }
}

Bestätige jede Nachricht erst, wenn ihre Runs gespeichert sind

connic schickt das PUBACK für eine QoS-1-Nachricht, sobald für jeden verknüpften Agenten ein Run in der Warteschlange gespeichert ist. So geht bei einem Neustart oder Deployment keine Arbeit verloren.

Persistente Session
connic meldet sich mit Clean Start 0 an. Der Broker behält deshalb das Abonnement und seine QoS-1-Nachrichten über Neuverbindungen und Pausen hinweg.
Ein Run pro Nachricht
Kommt eine Nachricht erneut, nutzt connic den gespeicherten Run. Mit einem Message ID Field gilt das auch, wenn der Broker sie unter neuer Packet ID schickt.
Retained Messages nur einmal
Gespeicherte Nachrichten kommen an, wenn das Abonnement neu ist, und nicht bei jeder Neuverbindung wieder.
  1. Empfangen

    Der Broker stellt Nachrichten auf passenden Topics zu, auch die, die er zurückgehalten hat, während connic getrennt war.

  2. Speichern

    connic speichert für jeden verknüpften Agenten einen Run in der Warteschlange. Gespeicherte Runs überstehen Neustarts von Workern und Deployments.

  3. Bestätigen

    connic schickt das PUBACK. Schlägt das Speichern fehl, verbindet sich connic ohne Bestätigung neu, und der Broker schickt die Nachricht noch einmal.

    PUBACK
  4. Ausführen

    Runs laufen parallel bis max_concurrent_runs. Eine Concurrency-Regel auf einem Feld wie der Maschinen-ID startet Runs mit demselben Wert nacheinander.

    concurrency.key: machine

Halte den Subscriber neben deinen Agenten

Deklariere ihn als YAML-Datei in connectors/. Host, Zugangsdaten und Zertifikate liegen in einer Connection, deshalb nennt die Datei nur den Topic-Filter und seine Optionen. Ein im Code deklarierter Subscriber startet, sobald sein Deployment live geht.

TLS und Client-Zertifikate
connic verbindet sich über TLS und prüft das Zertifikat des Brokers. Für Broker, die Geräte am Zertifikat erkennen, etwa AWS IoT Core, ergänzt du Client-Zertifikat und Schlüssel.
Broker in der Fertigung
Direkte Verbindungen brauchen einen Broker, der zu öffentlichen IP-Adressen auflöst. Einen Broker im Werksnetz erreichst du über eine Bridge.
connectors/plant-alarms.yaml
type: mqtt
mode: inbound
name: Plant alarms
connection: plant-broker
config:
  topic_filter: factory/+/alarms
  qos: 1
  message_id_field: message_id
agents:
  - alarm-triage
create: connectors/plant-alarms.yaml (mqtt)

Veröffentliche Ergebnisse auf einem Topic

Eine ausgehende Verbindung veröffentlicht jeden abgeschlossenen Run mit der eingestellten QoS und dem Retain-Flag auf ihrem Topic und wartet bei QoS 1 auf das PUBACK des Brokers.

Run-ID als Message ID
Jede Nachricht trägt die Run-ID in der User Property message_id. Abonnenten erkennen daran Duplikate nach einer Wiederholung.
User Properties vom Agenten
Als Agent-Tool verknüpft, lässt die Verbindung das Modell eine eigene Payload veröffentlichen und User Properties von MQTT 5 ergänzen.
Retain für den letzten Stand
Mit Retain behält der Broker das letzte Ergebnis und gibt es jedem neuen Abonnenten des Topics.
connectors/line-commands.yaml
type: mqtt
mode: outbound
name: Line commands
connection: plant-broker
config:
  topic: factory/line-1/commands
  qos: 1
  retain: false
agents:
  - name: alarm-triage
    outbound:
      usage: automatic
      source: [plant-alarms]
message on factory/line-1/commands (message_id = run_id)
{
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_name": "alarm-triage",
  "status": "completed",
  "output": "press-4: reduce speed to 60% and send maintenance.",
  "error": null,
  "started_at": "2026-10-13T09:00:01Z",
  "ended_at": "2026-10-13T09:00:05Z",
  "token_usage": {
    "input_tokens": 512,
    "output_tokens": 31,
    "thinking_tokens": 0,
    "cached_input_tokens": 0,
    "total_tokens": 543
  }
}

Wo MQTT passt

Wähle ein Szenario und sieh, welches Topic den Run startet, was der Agent erhält und wohin das Ergebnis geht.

Jeder Alarm der Linie startet einen Run, und die Entscheidung des Agenten geht zurück auf das Befehls-Topic der Linie.

SPS-Gateway
MQTT-Subscriber
alarm-triage
Befehl auf factory/line-1/commands
context["payload"]
{
  "machine": "press-4",
  "alarm": "overtemperature",
  "value": 92.5,
  "_mqtt": {
    "topic": "factory/line-1/alarms",
    "qos": 1,
    "retain": false,
    "duplicate": false,
    "user_properties": { "message_id": "press-4-1731840000" },
    "content_type": "application/json"
  }
}
message on factory/line-1/commands
{
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_name": "alarm-triage",
  "status": "completed",
  "output": "press-4: reduce speed to 60% and send maintenance.",
  "error": null,
  "started_at": "2026-10-13T09:00:01Z",
  "ended_at": "2026-10-13T09:00:05Z",
  "token_usage": {
    "input_tokens": 512,
    "output_tokens": 31,
    "thinking_tokens": 0,
    "cached_input_tokens": 0,
    "total_tokens": 543
  }
}

Ein Auflieger meldet eine Temperatur über dem Grenzwert, und der Agent sagt der Disposition, was zu prüfen ist.

Telematik im Auflieger
MQTT-Subscriber
cold-chain-watch
E-Mail an die Disposition
context["payload"]
{
  "trailer": "TR-208",
  "temperature_c": 9.1,
  "limit_c": 7.0,
  "door_open": false,
  "_mqtt": {
    "topic": "fleet/TR-208/telemetry",
    "qos": 1,
    "retain": false,
    "duplicate": false,
    "user_properties": { "message_id": "TR-208-0931" },
    "content_type": "application/json"
  }
}
connector-payload.json
{
  "body": "Trailer TR-208 is at 9.1 °C, above the 7 °C limit. The door is closed, so the cooling unit needs a check.",
  "to": "dispatch@example.com",
  "subject": "TR-208 above temperature limit"
}

Eine Pumpe meldet steigende Vibration, und der Agent veröffentlicht einen Prüfauftrag für das Wartungssystem.

Pumpensensoren
MQTT-Subscriber
maintenance-planner
Auftrag auf maintenance/orders
context["payload"]
{
  "pump": "P-17",
  "vibration_mm_s": 11.4,
  "running_hours": 18240,
  "_mqtt": {
    "topic": "site-b/pumps/P-17/status",
    "qos": 1,
    "retain": false,
    "duplicate": false,
    "user_properties": { "message_id": "P-17-18240" },
    "content_type": "application/json"
  }
}
connector-payload.json
{
  "payload": {
    "pump": "P-17",
    "action": "schedule_inspection",
    "within_hours": 48
  },
  "user_properties": {
    "priority": "high"
  }
}

Eine Zone meldet zu viel CO2, und der Agent stellt die Lüftung passend zur aktuellen Belegung ein.

Gebäudesensoren
MQTT-Subscriber
climate-control
Sollwert auf hq/hvac/commands
context["payload"]
{
  "zone": "floor-3-east",
  "co2_ppm": 1450,
  "occupancy": 38,
  "_mqtt": {
    "topic": "hq/hvac/floor-3-east",
    "qos": 1,
    "retain": false,
    "duplicate": false,
    "user_properties": { "message_id": "f3e-1102" },
    "content_type": "application/json"
  }
}
connector-payload.json
{
  "payload": {
    "zone": "floor-3-east",
    "ventilation_percent": 80
  }
}

FAQ zu MQTT

Füge eine MQTT-Verbindung im Modus Inbound (Subscriber) hinzu, wähle eine Connection mit deinem Broker, gib einen Topic-Filter ein und verknüpfe den Agenten. Im Dashboard erstellte Verbindungen starten pausiert, klicke also auf Resume, sobald alles bereit ist. Danach startet jede Nachricht auf einem passenden Topic einen Run für jeden verknüpften Agenten, mit Topic und User Properties unter _mqtt.

Jeder Broker, der MQTT 5 spricht, etwa Mosquitto 2, HiveMQ, EMQX, AWS IoT Core oder Azure Event Grid. connic verbindet sich standardmäßig über TLS, mit Benutzername und Passwort, mit Client-Zertifikat oder mit beidem. Einen Broker in deinem Netzwerk erreichst du über eine Bridge.

connic hält eine persistente Session beim Broker. Der Broker hält deshalb QoS-1-Nachrichten zurück und schickt sie, sobald connic sich wieder verbindet, solange die Session nicht abgelaufen ist. connic bestätigt QoS-1-Nachrichten erst, wenn ihre Runs gespeichert sind.

Nicht in derselben Session: Für eine noch nicht bestätigte Nachricht nutzt connic den bereits gespeicherten Run. Mit einem Message ID Field, also einer User Property oder einem JSON-Schlüssel mit eindeutiger ID, erkennt connic auch Nachrichten, die der Broker unter neuer Packet ID erneut schickt, wie es bei AWS IoT Core vorkommt. Alle Fälle stehen in der MQTT-Dokumentation.