Zum Hauptinhalt springen
connic
Starte kostenlos

RabbitMQ

Jede Nachricht in einer Queue startet einen Agent-Run, und die Ergebnisse landen als persistente, bestätigte Nachrichten in einem Exchange. connic bestätigt jede Nachricht, sobald ihre Runs gespeichert sind.

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

Mach aus jeder Nachricht einen Run

Eine eingehende Verbindung konsumiert eine Queue und startet jeden verknüpften Agenten einmal pro Nachricht, mit der Nachricht als Eingabe.

JSON bleibt, wie es ist
Ein JSON-Objekt kommt mit seinen Feldern auf oberster Ebene an, ergänzt um _rabbitmq mit Queue, Exchange, Routing Key, Message ID, Headern und Zeitstempel.
Text bleibt Text
Jeder andere Body landet unter message: andere JSON-Werte geparst, reiner Text als String.
Dateien in der Nachricht
Ein JSON-Objekt kann ein Array files mit Name, MIME-Typ und base64-Daten jeder Datei enthalten, bis zu 50 Dateien und insgesamt 32 MiB.
message on orders
{
  "order_id": "ord_8812",
  "customer": "jana@example.com",
  "total": 184.5
}
context["payload"]
{
  "order_id": "ord_8812",
  "customer": "jana@example.com",
  "total": 184.5,
  "_rabbitmq": {
    "queue": "orders",
    "exchange": "events",
    "routing_key": "orders.created",
    "message_id": "ord_8812-created",
    "correlation_id": null,
    "content_type": "application/json",
    "headers": {},
    "timestamp": "2026-10-13T09:00:00+00:00",
    "redelivered": false
  }
}

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

connic bestätigt eine 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, und lange Runs halten die Nachricht nicht fest.

Ein Run pro Nachricht
Kommt eine Nachricht erneut an, nutzt connic den gespeicherten Run, erkannt an der message_id oder, wenn sie fehlt, an Body und Headern.
Fehlgeschlagene Runs bleiben sichtbar
Schlägt ein gespeicherter Run fehl, wird die Nachricht nicht erneut zugestellt. Der Run behält seine vollständige Eingabe in Agent Runs, wo du ihn neu starten kannst.
Geteilte Queues
Mehrere Verbindungen an derselben Queue teilen sich deren Nachrichten: RabbitMQ stellt jede Nachricht nur einer von ihnen zu.
  1. Empfangen

    RabbitMQ schickt bis zu prefetch Nachrichten vorab, und connic verarbeitet sie in der Reihenfolge ihres Eingangs.

  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

    Die Nachricht wird bestätigt. Schlägt das Speichern fehl, kommt sie zurück in die Queue und nach kurzer Pause erneut an.

    basic.ack
  4. Ausführen

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

    concurrency.key: order_id

Halte den Consumer neben deinen Agenten

Deklariere ihn als YAML-Datei in connectors/. Host, Benutzer und TLS liegen in einer Connection, deshalb nennt die Datei nur Queue und Prefetch. Ein im Code deklarierter Consumer beginnt zu lesen, sobald sein Deployment live geht.

TLS als Standard
connic verbindet sich über TLS und prüft das Zertifikat des Brokers. Für eine eigene CA fügst du ihr Zertifikat im PEM-Format in die Connection ein.
Private Broker
Direkte Verbindungen brauchen einen Broker, der zu öffentlichen IP-Adressen auflöst. Einen Broker in deinem Netzwerk erreichst du über eine Bridge.
connectors/order-events.yaml
type: rabbitmq
mode: inbound
name: Order events
connection: orders-rabbitmq
config:
  queue: orders
  prefetch: 10
agents:
  - order-processor
create: connectors/order-events.yaml (rabbitmq)

Veröffentliche Ergebnisse in einem Exchange

Eine ausgehende Verbindung veröffentlicht jeden abgeschlossenen Run mit ihrem Routing Key in einem Exchange und wartet auf die Bestätigung des Brokers.

Persistent und bestätigt
Nachrichten nutzen den Delivery Mode persistent und Publisher Confirms. Nimmt keine Queue die Nachricht auf, schlägt die Zustellung fehl, statt dass die Nachricht verschwindet.
Run-ID als Message ID
Jede Nachricht trägt die Run-ID als message_id. Consumer erkennen daran Duplikate nach einer Wiederholung.
Der Agent veröffentlicht selbst
Als Agent-Tool verknüpft, lässt die Verbindung das Modell während des Runs eine eigene Payload veröffentlichen.
connectors/order-results.yaml
type: rabbitmq
mode: outbound
name: Order results
connection: orders-rabbitmq
config:
  exchange: order-results
  routing_key: orders.processed
agents:
  - name: order-processor
    outbound:
      usage: automatic
      source: [order-events]
message on order-results (persistent, message_id = run_id)
{
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_name": "order-processor",
  "status": "completed",
  "output": "ord_8812 approved for standard shipping.",
  "error": null,
  "started_at": "2026-10-13T09:00:01Z",
  "ended_at": "2026-10-13T09:00:05Z",
  "token_usage": {
    "input_tokens": 642,
    "output_tokens": 38,
    "thinking_tokens": 0,
    "cached_input_tokens": 0,
    "total_tokens": 680
  }
}

Wo RabbitMQ passt

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

Jedes Bestell-Event startet einen Run, und das Ergebnis landet im Exchange order-results.

Checkout-Service
RabbitMQ-Consumer
order-processor
Ergebnis in order-results
context["payload"]
{
  "order_id": "ord_8812",
  "customer": "jana@example.com",
  "total": 184.5,
  "_rabbitmq": {
    "queue": "orders",
    "exchange": "events",
    "routing_key": "orders.created",
    "message_id": "ord_8812-created",
    "correlation_id": null,
    "content_type": "application/json",
    "headers": {},
    "timestamp": "2026-10-13T09:00:00+00:00",
    "redelivered": false
  }
}
message on order-results
{
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_name": "order-processor",
  "status": "completed",
  "output": "ord_8812 approved for standard shipping.",
  "error": null,
  "started_at": "2026-10-13T09:00:01Z",
  "ended_at": "2026-10-13T09:00:05Z",
  "token_usage": {
    "input_tokens": 642,
    "output_tokens": 38,
    "thinking_tokens": 0,
    "cached_input_tokens": 0,
    "total_tokens": 680
  }
}

Der Agent liest jedes neue Ticket und veröffentlicht Team und Priorität, die der Helpdesk übernimmt.

Helpdesk
RabbitMQ-Consumer
ticket-router
Zuordnung in tickets.routed
context["payload"]
{
  "ticket_id": "T-48213",
  "subject": "Invoice shows the wrong VAT number",
  "customer": "acme-gmbh",
  "_rabbitmq": {
    "queue": "support-tickets",
    "exchange": "events",
    "routing_key": "tickets.opened",
    "message_id": "T-48213-opened",
    "correlation_id": null,
    "content_type": "application/json",
    "headers": {},
    "timestamp": "2026-10-13T09:00:00+00:00",
    "redelivered": false
  }
}
connector-payload.json
{
  "payload": {
    "ticket_id": "T-48213",
    "team": "billing",
    "priority": "normal"
  }
}

Eine gescannte Rechnung kommt mit der Nachricht an, und der Agent liest die Felder aus, die dein ERP braucht.

Mail-Gateway
RabbitMQ-Consumer
invoice-reader
Felder in der ERP-Queue
context["payload"]
{
  "supplier": "Nordlicht Logistik",
  "files": [
    { "name": "invoice-2210.pdf", "mime_type": "application/pdf", "data": "JVBERi0xLjcK..." }
  ],
  "_rabbitmq": {
    "queue": "invoices",
    "exchange": "events",
    "routing_key": "invoices.received",
    "message_id": "inv-2210",
    "correlation_id": null,
    "content_type": "application/json",
    "headers": {},
    "timestamp": "2026-10-13T09:00:00+00:00",
    "redelivered": false
  }
}
connector-payload.json
{
  "payload": {
    "invoice_number": "2210",
    "total": 1840.0,
    "currency": "EUR",
    "due_date": "2026-11-12"
  }
}

Eine verspätete Sendung startet einen Run, und der Agent schickt dem Kunden das neue Lieferdatum per E-Mail.

Lagersystem
RabbitMQ-Consumer
delay-notifier
E-Mail an den Kunden
context["payload"]
{
  "shipment_id": "shp_5531",
  "order_id": "ord_8812",
  "status": "delayed",
  "new_eta": "2026-10-16",
  "_rabbitmq": {
    "queue": "shipment-updates",
    "exchange": "events",
    "routing_key": "shipments.delayed",
    "message_id": "shp_5531-delayed",
    "correlation_id": null,
    "content_type": "application/json",
    "headers": {},
    "timestamp": "2026-10-13T09:00:00+00:00",
    "redelivered": false
  }
}
connector-payload.json
{
  "body": "Your order ord_8812 is running late. It now arrives on October 16.",
  "to": "jana@example.com",
  "subject": "New delivery date for your order"
}

FAQ zu RabbitMQ

Füge eine RabbitMQ-Verbindung im Modus Inbound (Consumer) hinzu, wähle eine Connection mit deinem Broker, gib die Queue ein und verknüpfe den Agenten. Im Dashboard erstellte Verbindungen starten pausiert, klicke also auf Resume, sobald alles bereit ist. Danach startet jede Nachricht einen Run für jeden verknüpften Agenten, mit den Properties der Nachricht unter _rabbitmq.

Sobald für jeden verknüpften Agenten ein Run in der Warteschlange gespeichert ist, also bevor die Runs laufen. Lange Runs erreichen deshalb nie den Consumer Timeout von RabbitMQ. Schlägt das Speichern fehl, schließt connic die Verbindung, und RabbitMQ legt die Nachricht zurück in die Queue.

Nein. connic erkennt eine Nachricht an ihrer Property message_id oder, wenn sie fehlt, an Body und Headern und nutzt den bereits gespeicherten Run. Ein fehlgeschlagener Run wird durch erneute Zustellung nicht wiederholt, starte ihn deshalb in Agent Runs neu.

Ein Body, der kein gültiges UTF-8 ist, wird abgewiesen, ohne zurück in die Queue zu kommen. Hat die Queue einen Dead-Letter-Exchange, landet die Nachricht dort. Bei Quorum Queues geht eine Nachricht, die immer wieder zurückkommt, standardmäßig nach 20 Zustellungen an den Dead-Letter-Exchange. Alle Fälle stehen in der RabbitMQ-Dokumentation.