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.
{
"machine": "press-4",
"alarm": "overtemperature",
"value": 92.5
}{
"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.
Empfangen
Der Broker stellt Nachrichten auf passenden Topics zu, auch die, die er zurückgehalten hat, während connic getrennt war.
Speichern
connic speichert für jeden verknüpften Agenten einen Run in der Warteschlange. Gespeicherte Runs überstehen Neustarts von Workern und Deployments.
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.
PUBACKAusfü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.
type: mqtt
mode: inbound
name: Plant alarms
connection: plant-broker
config:
topic_filter: factory/+/alarms
qos: 1
message_id_field: message_id
agents:
- alarm-triageVerö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.
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]{
"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.
{
"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"
}
}{
"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.
{
"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"
}
}{
"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.
{
"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"
}
}{
"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.
{
"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"
}
}{
"payload": {
"zone": "floor-3-east",
"ventilation_percent": 80
}
}FAQ zu MQTT
Weitere Verbindungen
Cron-Scheduler
Ein Cron-Ausdruck legt fest, wann ein Agent ausgeführt wird. connic betreibt den Scheduler für tägliche Zusammenfassungen, stündliche Health-Checks und wöchentliche Audits.
Inbound
Gmail
Neue E-Mails in einem Postfach von Google Workspace lösen Agenten aus, die direkt im selben Verlauf antworten. connic meldet sich mit deinem eigenen Dienstkonto an. Anhänge werden unterstützt.
Inbound · Outbound
Jira
Neue Issues, Änderungen und Kommentare in Jira Cloud lösen Agenten aus. Die Agenten antworten mit Kommentaren oder legen neue Issues an.
Inbound · Outbound
Pipedrive
Neue, geänderte oder gelöschte Deals, Leads, Personen und Organisationen in Pipedrive lösen Agenten aus. Die Agenten halten ihr Ergebnis als Notiz am Datensatz fest.
Inbound · Outbound
Slack
Slack-Bots lassen sich mit connic verbinden. Erwähnungen lösen Agenten aus; Ergebnisse gehen an Slack-Channels.
Inbound · Outbound
WhatsApp
Lass einen Agenten WhatsApp-Nachrichten an deine Geschäftsnummer beantworten, auch mit Dateien. Er antwortet innerhalb von 24 Stunden oder erreicht Kunden mit freigegebenen Vorlagen.
Inbound · Outbound