Zum Hauptinhalt springen
connic
Starte kostenlos

Azure Service Bus

Jede Nachricht in einer Queue oder Topic-Subscription startet einen Agent-Run, und die Ergebnisse gehen an eine Queue oder ein Topic. connic schließt jede Nachricht ab, sobald ihre Runs gespeichert sind.

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

Mach aus jeder Nachricht einen Run

Eine eingehende Verbindung empfängt aus einer Queue oder Topic-Subscription 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 _azure_service_bus mit Entität, Message ID, Subject, Application Properties und Eingangszeit.
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,
  "_azure_service_bus": {
    "namespace": "contoso.servicebus.windows.net",
    "topic": "orders",
    "subscription": "connic",
    "message_id": "ord_8812-created",
    "sequence_number": 1042,
    "correlation_id": null,
    "subject": "order.created",
    "content_type": "application/json",
    "reply_to": null,
    "application_properties": {},
    "enqueued_time": "2026-10-13T09:00:00+00:00",
    "delivery_count": 0
  }
}

Schließe jede Nachricht erst ab, wenn ihre Runs gespeichert sind

connic empfängt im Peek-Lock-Modus und schließt eine Nachricht ab, 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 Sperre 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 der Sequenznummer.
Unlesbare Nachrichten in die Dead-Letter-Queue
Ein Body, der kein gültiges UTF-8 ist, geht mit Begründung in die Dead-Letter-Queue, und die Verbindung protokolliert einen fehlgeschlagenen Run.
Geteilte Queues und Subscriptions
Mehrere Verbindungen an derselben Queue oder Subscription teilen sich deren Nachrichten: Service Bus stellt jede Nachricht nur einer von ihnen zu.
  1. Empfangen

    Service Bus sperrt die Nachricht, und connic empfängt eine Nachricht nach der anderen in der Reihenfolge ihres Eingangs.

  2. Speichern

    connic verlängert die Sperre, während es für jeden verknüpften Agenten einen Run in der Warteschlange speichert. Gespeicherte Runs überstehen Neustarts von Workern und Deployments.

  3. Abschließen

    Die Nachricht wird abgeschlossen. Schlägt das Speichern fehl, gibt connic sie frei, und Service Bus stellt sie bis zu ihrer maximalen Zustellanzahl erneut zu.

    complete
  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 Empfänger neben deinen Agenten

Deklariere ihn als YAML-Datei in connectors/. Namespace und Anmeldung liegen in einer Connection, deshalb nennt die Datei nur Queue oder Topic. Ein im Code deklarierter Empfänger startet, sobald sein Deployment live geht.

Shared Access Key oder Entra ID
Melde dich mit einer Shared Access Policy an oder mit einer Microsoft-Entra-ID-App, die die Rolle Data Receiver oder Data Sender hat.
Queues und Topics
Empfange aus einer Queue oder Topic-Subscription und sende an eine Queue oder ein Topic. connic legt keine Entitäten an.
connectors/order-events.yaml
type: azure_service_bus
mode: inbound
name: Order events
connection: orders-service-bus
config:
  entity_type: topic
  topic: orders
  subscription: connic
agents:
  - order-processor
create: connectors/order-events.yaml (azure_service_bus)

Sende Ergebnisse an eine Queue oder ein Topic

Eine ausgehende Verbindung sendet jeden abgeschlossenen Run als JSON-Nachricht an ihre Queue oder ihr Topic.

Run-ID als Message ID
Jede Nachricht trägt die Run-ID als message_id. Die Duplikaterkennung oder deine Consumer verwerfen daran eine Wiederholung.
Properties der Nachricht
Als Tool oder aus der Middleware aufgerufen, setzt die Verbindung Subject, Correlation ID, Session ID und Application Properties.
Der Agent sendet selbst
Als Agent-Tool verknüpft, lässt die Verbindung das Modell während des Runs eine eigene Payload senden.
connectors/order-results.yaml
type: azure_service_bus
mode: outbound
name: Order results
connection: orders-service-bus
config:
  entity_type: queue
  queue: order-results
agents:
  - name: order-processor
    outbound:
      usage: automatic
      source: [order-events]
message on order-results (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 Azure Service Bus passt

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

Jedes Bestell-Event im Topic orders startet einen Run, und das Ergebnis landet in der Queue order-results.

Checkout-Service
Service-Bus-Empfänger
order-processor
Ergebnis in order-results
context["payload"]
{
  "order_id": "ord_8812",
  "customer": "jana@example.com",
  "total": 184.5,
  "_azure_service_bus": {
    "namespace": "contoso.servicebus.windows.net",
    "topic": "orders",
    "subscription": "connic",
    "message_id": "ord_8812-created",
    "sequence_number": 1042,
    "correlation_id": null,
    "subject": "order.created",
    "content_type": "application/json",
    "reply_to": null,
    "application_properties": {},
    "enqueued_time": "2026-10-13T09:00:00+00:00",
    "delivery_count": 0
  }
}
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 sendet Team und Priorität, das Team zusätzlich als Application Property für Subscription-Filter.

Helpdesk
Service-Bus-Empfänger
ticket-router
Zuordnung in tickets-routed
context["payload"]
{
  "ticket_id": "T-48213",
  "subject": "Invoice shows the wrong VAT number",
  "customer": "acme-gmbh",
  "_azure_service_bus": {
    "namespace": "contoso.servicebus.windows.net",
    "queue": "support-tickets",
    "message_id": "T-48213-opened",
    "sequence_number": 318,
    "correlation_id": null,
    "subject": "ticket.opened",
    "content_type": "application/json",
    "reply_to": null,
    "application_properties": {},
    "enqueued_time": "2026-10-13T09:00:00+00:00",
    "delivery_count": 0
  }
}
connector-payload.json
{
  "payload": {
    "ticket_id": "T-48213",
    "team": "billing",
    "priority": "normal"
  },
  "subject": "ticket.routed",
  "application_properties": { "team": "billing" }
}

Eine gescannte Rechnung kommt mit der Nachricht an, und der Agent sendet die Felder an eine Session-Queue, eine Session je Lieferant.

Mail-Gateway
Service-Bus-Empfänger
invoice-reader
Felder in der ERP-Queue
context["payload"]
{
  "supplier": "Nordlicht Logistik",
  "files": [
    { "name": "invoice-2210.pdf", "mime_type": "application/pdf", "data": "JVBERi0xLjcK..." }
  ],
  "_azure_service_bus": {
    "namespace": "contoso.servicebus.windows.net",
    "queue": "invoices",
    "message_id": "inv-2210",
    "sequence_number": 77,
    "correlation_id": null,
    "subject": "invoice.received",
    "content_type": "application/json",
    "reply_to": null,
    "application_properties": {},
    "enqueued_time": "2026-10-13T09:00:00+00:00",
    "delivery_count": 0
  }
}
connector-payload.json
{
  "payload": {
    "invoice_number": "2210",
    "total": 1840.0,
    "currency": "EUR",
    "due_date": "2026-11-12"
  },
  "session_id": "nordlicht-logistik"
}

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

Lagersystem
Service-Bus-Empfänger
delay-notifier
E-Mail an den Kunden
context["payload"]
{
  "shipment_id": "shp_5531",
  "order_id": "ord_8812",
  "status": "delayed",
  "new_eta": "2026-10-16",
  "_azure_service_bus": {
    "namespace": "contoso.servicebus.windows.net",
    "topic": "shipments",
    "subscription": "connic",
    "message_id": "shp_5531-delayed",
    "sequence_number": 2290,
    "correlation_id": null,
    "subject": "shipment.delayed",
    "content_type": "application/json",
    "reply_to": null,
    "application_properties": {},
    "enqueued_time": "2026-10-13T09:00:00+00:00",
    "delivery_count": 0
  }
}
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 Azure Service Bus

Füge eine Azure-Service-Bus-Verbindung im Modus Inbound (Receiver) hinzu, wähle eine Connection mit deinem Namespace, gib die Queue oder Topic und Subscription 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 _azure_service_bus.

Sobald für jeden verknüpften Agenten ein Run in der Warteschlange gespeichert ist, also bevor die Runs laufen. Bis dahin verlängert connic die Sperre der Nachricht, sodass auch lange Runs nie an die Sperrdauer stoßen. Schlägt das Speichern fehl, gibt connic die Nachricht frei, und Service Bus stellt sie erneut bereit.

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

Mit einer Shared Access Policy, die das Recht Listen oder Send hat, oder mit einer Microsoft-Entra-ID-App mit der Rolle Azure Service Bus Data Receiver oder Data Sender. Beides liegt in einer Connection, nie in der Datei der Verbindung. Die Felder stehen in der Azure-Service-Bus-Dokumentation.