RabbitMQ
Agenten durch Nachrichten aus einer RabbitMQ-Queue starten oder Run-Ergebnisse in einem Exchange veröffentlichen.
Auf dieser Seite
| Modi | Inbound, Outbound |
| YAML-Typ | rabbitmq |
| Zugangsdaten | Ein Kontozugang (Connection) vom Typ rabbitmq mit Host, Virtual Host, Benutzer und TLS-Einstellungen |
| Bridge | Am Kontozugang, um einen Broker in einem privaten Netzwerk zu erreichen |
| Custom Domain | Nicht unterstützt |
| Verknüpfte Agenten | Einer oder mehrere. Jede Nachricht startet alle verknüpften Agenten. |
| Während der Pause | Inbound: connic liest nicht weiter, und die Nachrichten bleiben bis zum Fortsetzen in der Queue. Outbound: Es wird nichts veröffentlicht. |
| Neue Verbindungen | Inbound-Verbindungen legt das Dashboard pausiert an, ebenso die REST API und connic MCP, sofern die Anfrage nicht enabled: true setzt. Starte sie mit Resume. Verbindungen im Code starten aktiv. |
Einrichtung
Lege für Inbound die Queue an, für Outbound den Exchange mit seinen Bindings. connic legt weder Queues noch Exchanges an. Gib dem RabbitMQ-Benutzer im Virtual Host Leserechte auf die Queue oder Schreibrechte auf den Exchange.
Öffne den Agenten. Klicke im Connector Flow für Inbound auf Add inbound connector oder für Outbound auf Add outbound connector. Klicke dann auf Create New Connector und wähle RabbitMQ.
Wähle Inbound (Consumer) oder Outbound (Publisher). Wähle unter Connection einen gespeicherten Kontozugang oder lege einen mit Host, Benutzer und TLS-Einstellungen an; siehe Kontozugang. Liegt der Broker in einem privaten Netzwerk, wähle im Kontozugang die Bridge.
Gib für Inbound die Queue und optional den Prefetch ein, für Outbound den Exchange und den Routing Key.
Klicke auf Create. Eine neue Inbound-Verbindung ist pausiert: Klicke in ihrem Detailbereich auf Resume, damit connic Nachrichten liest. Den Detailbereich öffnest du wieder, indem du im Flow mit der Maus über die Verbindung fährst und auf das Augensymbol klickst.
Im Code
Deklariere die Verbindung in connectors/*.yaml. Die Datei nennt den Kontozugang und enthält nie Zugangsdaten für den Broker. Verbindungen im Code starten aktiv: Eine Inbound-Verbindung beginnt zu lesen, sobald ihr erstes Deployment live geht.
type: rabbitmq
mode: inbound
connection: orders-rabbitmq # Kontozugang mit Host, Zugangsdaten, TLS und optionaler Bridge
config:
queue: orders
prefetch: 10
agents:
- order-processortype: rabbitmq
mode: outbound
connection: orders-rabbitmq
config:
exchange: order-results
routing_key: orders.processed
agents:
- name: order-processor
outbound: { usage: automatic }Konfiguration
Die Felder einer RabbitMQ-Verbindung, in connectors/*.yaml genauso wie in der REST API und connic MCP. Die Beschreibungen nennen die passende Einstellung im Dashboard. Felder, die alle Verbindungen teilen, etwa agents und environments, beschreibt Verbindungen im Code.
| Feld | Typ | Status | Beschreibung |
|---|---|---|---|
| type | string | Required | rabbitmq. |
| mode | string | Required | inbound oder outbound. Dashboard: Mode. |
| connection | string | Required | Name oder ID eines Kontozugangs vom Typ rabbitmq, der Host, Zugangsdaten, TLS und Bridge enthält. Siehe Kontozugang. Dashboard: Connection. |
| config | object | Required | RabbitMQ-Einstellungen. |
| queue | string | Required | Inbound. Die Queue, aus der connic liest. Sie muss bereits existieren. Dashboard: Queue. |
| prefetch | integer | Optional | Inbound. Wie viele unbestätigte Nachrichten RabbitMQ vorab schickt, von 1 bis 1000. Dashboard: Prefetch.Default: 10 |
| exchange | string | Optional | Outbound. Der Exchange, in dem connic veröffentlicht. Er muss bereits existieren. Leer bleibt der Default Exchange, der an die Queue mit dem Namen des Routing Keys zustellt. Dashboard: Exchange. |
| routing_key | string | Optional | Outbound. Der Routing Key jeder veröffentlichten Nachricht. Pflichtfeld beim Default Exchange. Dashboard: Routing Key. |
Kontozugang
Ein Kontozugang vom Typ rabbitmq enthält diese Felder. Alle RabbitMQ-Verbindungen des Projekts können ihn nutzen, und die config einer Verbindung nimmt die Felder nicht an. Verwalte Kontozugänge unter Project Settings → Connections oder über die REST API.
| Feld | Typ | Status | Beschreibung |
|---|---|---|---|
| host | string | Required | Hostname oder IP-Adresse des Brokers. Ohne Bridge muss er ausschließlich zu öffentlichen IP-Adressen auflösen. Dashboard: Host. |
| port | integer | Optional | AMQP-Port. Ohne Angabe nutzt connic 5671 mit TLS und 5672 ohne. Dashboard: Port. |
| vhost | string | Optional | Der Virtual Host, in dem Queue oder Exchange liegen. Dashboard: Virtual Host.Default: / |
| username | string | Required | Der RabbitMQ-Benutzer. Dashboard: Username. |
| password | string | Required | Das Passwort des Benutzers. Secret. Dashboard: Password. |
| use_tls | boolean | Optional | Verbindet über TLS und prüft Zertifikat und Hostnamen des Brokers. Dashboard: Use TLS.Default: true |
| ssl_ca_pem | string | Optional | Mit TLS. CA-Zertifikat im PEM-Format für einen Broker, dessen Zertifikat nicht von einer öffentlichen CA stammt. Füge den Inhalt ein, keinen Dateipfad. Secret. Dashboard: SSL CA Certificate PEM. |
| bridge | string | Optional | Name oder ID der Bridge, über die connic einen Broker in einem privaten Netzwerk erreicht. TLS prüft das Zertifikat weiterhin gegen den Host. REST API und connic MCP nehmen sie als bridge auf oberster Ebene des Kontozugangs an, nicht in config. Dashboard: Bridge. |
Jede Verbindung, die den Kontozugang nutzt, geht über seine Bridge. Für eine andere Bridge je Environment gibst du jedem Environment einen eigenen Kontozugang; siehe Kontozugänge und Bridges. Änderst du bei einem gespeicherten Kontozugang Host, Port, Virtual Host, Benutzer, TLS oder Bridge, gib das Passwort erneut ein. Bei Host, Port, TLS oder Bridge gilt das auch für das CA-Zertifikat. Sonst lehnt connic die Änderung ab.
Input des Agenten
Modi: Inbound
Jede Nachricht wird zum Input aller verknüpften Agenten. Ein JSON-Objekt behält seine Felder, und connic ergänzt die Properties der Nachricht unter _rabbitmq:
{
"order_id": "12345",
"customer": "john@example.com",
"_rabbitmq": {
"queue": "orders",
"exchange": "orders",
"routing_key": "orders.created",
"message_id": "order-12345-created",
"correlation_id": null,
"content_type": "application/json",
"headers": { "tenant": "acme" },
"timestamp": "2026-01-15T10:30:00+00:00",
"redelivered": false
}
}_rabbitmq enthält die queue, den exchange und routing_key, mit denen die Nachricht veröffentlicht wurde, die Properties message_id, correlation_id, content_type und headers, die Property timestamp als ISO-8601-Zeitpunkt und redelivered. Dieses Feld ist true, wenn RabbitMQ die Nachricht schon einmal zugestellt hat. Properties, die der Publisher nicht gesetzt hat, sind null. Header-Werte aus Bytes kommen als Text an.
Jeder andere Body steht unter message: andere JSON-Werte geparst, Text, der kein JSON ist, als String, ein leerer Body als null.
Ein JSON-Objekt kann Dateien in einem Array files mitbringen. Jede Datei hat name, mime_type und Base64-kodierte data. connic nimmt bis zu 50 vollständige Dateien an, höchstens 32 MiB insgesamt. Ungültige Dateien werden einzeln ausgelassen. Bei der ersten Datei über einem Limit behält connic die Dateien davor und nimmt keine weiteren an. Jede ausgelassene Datei ist in file_issues beschrieben, und der Run läuft ohne sie weiter.
Dateien sind standardmäßig optional. Aktiviere Files required für einen Agenten im Detailbereich der Verbindung oder setze files_required: true an seiner Verknüpfung in YAML. Dann schlägt der Run vor dem Start fehl, wenn eine Datei fehlt oder ausgelassen wurde.
Queues und Prefetch
Modi: Inbound
Jede Inbound-Verbindung liest genau eine Queue. Verbindungen an derselben Queue teilen sich deren Nachrichten: RabbitMQ stellt jede Nachricht nur einer von ihnen zu. Für mehrere Queues legst du je Queue eine Inbound-Verbindung an und verknüpfst alle mit demselben Agenten. _rabbitmq.queue unterscheidet die Ereignisse.
RabbitMQ schickt bis zu prefetch Nachrichten vorab, und connic verarbeitet sie nacheinander in der Reihenfolge ihres Eingangs. Ein höherer Prefetch spart bei einer stark genutzten Queue Wartezeit. Ein niedrigerer lässt anderen Consumern der Queue mehr Nachrichten übrig.
Wenn du eine Verbindung löschst, bleiben ihre Queue und die Nachrichten darin erhalten.
Zustellung und Reihenfolge
Modi: Inbound
connic bestätigt eine Nachricht, sobald für jeden verknüpften Agenten ein Run in der Warteschlange gespeichert ist, also bevor diese Runs laufen. Gespeicherte Runs überstehen Neustarts und Deployments. Weil connic eine Nachricht nicht bis zum Ende ihrer Runs festhält, erreichen auch lange Runs nie den Consumer Timeout von RabbitMQ.
Stellt RabbitMQ eine Nachricht nach einem Teilfehler oder einem Neustart vor der Bestätigung erneut zu, verwendet sie den bereits gespeicherten Run. connic erkennt eine Nachricht an ihrer Property message_id innerhalb von Queue und Virtual Host. Fehlt sie, zählen Body und Header. Gleiche Nachrichten ohne message_id starten deshalb nur einen Run pro Agent. Setze beim Veröffentlichen eine eindeutige message_id, damit jede Nachricht zählt.
Zurück in die Queue kommt eine Nachricht nur, wenn connic ihre Runs nicht speichern konnte. Bei einer Quorum Queue zählt jede Rückgabe als Zustellung, und RabbitMQ leitet die Nachricht standardmäßig nach 20 Zustellungen an den Dead-Letter-Exchange weiter oder verwirft sie, wenn die Queue keinen hat. Mit dem delivery-limit der Queue und einem Dead-Letter-Exchange behältst du solche Nachrichten.
Schlägt ein Run nach dem Speichern fehl, folgt weder eine erneute Zustellung noch eine Dead-Letter-Nachricht. Der fehlgeschlagene Run behält seinen vollständigen Input, sodass du ihn erneut ausführen kannst. Wiederholungen innerhalb eines Runs folgen den retry_options des Agenten.
Runs werden in der Reihenfolge der Queue gespeichert, laufen aber parallel bis zu max_concurrent_runs. Für eine Reihenfolge nach einem Feld, etwa einer Bestellnummer, ergänzt du eine Concurrency-Regel auf diesem Feld:
concurrency:
key: order_id
on_conflict: queueRuns mit demselben Wert starten dann einzeln in Eingangsreihenfolge, Runs mit unterschiedlichen Werten laufen weiter parallel. Ein fehlgeschlagener Run gibt seinen Wert frei, die nächste Nachricht mit diesem Wert läuft also trotzdem.
Outbound-Zustellung
Modi: Outbound
Eine Outbound-RabbitMQ-Verbindung veröffentlicht JSON-Nachrichten mit ihrem Routing Key in ihrem Exchange. Je nach Nutzung der Verknüpfung veröffentlicht sie, wenn der Run eines verknüpften Agenten abgeschlossen ist, wenn das Modell sie als Tool aufruft oder wenn die Middleware sie aufruft.
Automatische Payload
Eine automatische Verknüpfung veröffentlicht den abgeschlossenen Run als Body der Nachricht:
{
"run_id": "550e8400-e29b-41d4-a716-446655440000",
"agent_name": "order-processor",
"status": "completed",
"output": "Order processed successfully. Total: $234.56",
"error": null,
"started_at": "2026-01-15T10:30:00Z",
"ended_at": "2026-01-15T10:30:05Z",
"token_usage": {
"input_tokens": 150,
"output_tokens": 50,
"thinking_tokens": 0,
"cached_input_tokens": 0,
"total_tokens": 200
}
}Für eine Pipeline verknüpfst du eine Inbound-RabbitMQ-Verbindung und eine automatische Outbound-RabbitMQ-Verbindung mit demselben Agenten; die Ausgabe des Agenten steht dann in output. Welche Runs veröffentlicht werden, beschreibt Automatische Quellen. Ein Run, den die Middleware mit StopProcessing beendet, gilt als abgeschlossen und veröffentlicht die StopProcessing-Antwort als Ausgabe, außer StopProcessing wird mit publish_outbound=False ausgelöst. Dieses Flag macht einen früheren Aufruf einer Agent-Tool- oder Middleware-Verknüpfung im selben Run nicht rückgängig.
Payload für Agent-Tool und Middleware
Das Modell oder die Middleware übergibt den Body der Nachricht unter payload. connic veröffentlicht den Wert von payload und ergänzt Exchange, Routing Key, Zugangsdaten, Serialisierung, Wiederholungen und Bridge-Routing. Davon sieht das Modell nichts.
{
"payload": {
"order_id": "12345",
"status": "approved"
}
}Zustellung und Wiederholungen
Jede Nachricht hat einen JSON-Body, den Content Type application/json und den Delivery Mode persistent, damit eine durable Queue sie über Neustarts des Brokers hinweg behält. Ihre message_id ist die Run-ID. Bei einem Aufruf durch Tool oder Middleware ist es das Feld run_id der Payload, falls vorhanden, sonst eine ID, die bei allen Wiederholungen der Zustellung gleich bleibt. Consumer können daran Duplikate erkennen.
connic veröffentlicht mit Publisher Confirms und wartet bis zu 30 Sekunden auf die Bestätigung des Brokers. Eine Nachricht, die keine Queue aufnimmt, kommt als Fehler zurück, statt zu verschwinden. Verbindungsfehler und unbestätigte Nachrichten versucht connic insgesamt 3-mal, mit 1 und dann 2 Sekunden Abstand. Die Runs der Verbindung zeigen jede Zustellung mit ihrem Fehler.
Limits und Fehler
| Situation | Was passiert |
|---|---|
| Der Body einer Nachricht ist kein gültiges UTF-8 | connic weist die Nachricht ab, ohne sie zurück in die Queue zu legen, und protokolliert einen fehlgeschlagenen Verbindungs-Run. Hat die Queue einen Dead-Letter-Exchange, leitet RabbitMQ die Nachricht dorthin, sonst verwirft RabbitMQ sie. |
| Ein Run lässt sich nicht speichern | connic schließt die Verbindung zum Broker. RabbitMQ legt die Nachricht und die übrigen unbestätigten Nachrichten zurück in die Queue, und der Consumer erhält sie nach einer kurzen Pause erneut. |
| Eine Nachricht kommt immer wieder | Jede Rückgabe zählt als Zustellung. Quorum Queues leiten eine Nachricht standardmäßig nach 20 Zustellungen an den Dead-Letter-Exchange weiter oder verwerfen sie. Classic Queues haben keine solche Grenze. |
| Kein Agent ist verknüpft | connic bestätigt jede Nachricht, ohne einen Run zu starten, und protokolliert sie als Verbindungs-Run mit No agents linked. |
| Die Queue fehlt, oder es gibt einen Broker- oder Netzwerkfehler | Der Consumer verbindet sich mit exponentiellem Backoff neu, von 5 Sekunden bis zu 2 Minuten. |
| Anmeldung oder Berechtigung wird abgelehnt | Der Consumer stoppt und schreibt den Fehler in die Verbindungs-Logs. Er startet wieder, sobald du die Verbindung oder ihren Kontozugang änderst oder die Verbindung pausierst und fortsetzt. |
| Veröffentlichen schlägt fehl (Outbound) | Bei Verbindungsfehlern und Nachrichten, die der Broker nicht bestätigt, unternimmt connic bis zu 3 Versuche. Eine abgelehnte Anmeldung, ein fehlender Exchange oder eine Nachricht, die keine Queue aufnimmt, schlägt sofort fehl. Siehe Zustellung und Wiederholungen. |