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
- Dokumentation
- Azure Service Bus Docs
- 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.
{
"order_id": "ord_8812",
"customer": "jana@example.com",
"total": 184.5
}{
"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.
Empfangen
Service Bus sperrt die Nachricht, und connic empfängt eine Nachricht nach der anderen in der Reihenfolge ihres Eingangs.
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.
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.
completeAusfü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.
type: azure_service_bus
mode: inbound
name: Order events
connection: orders-service-bus
config:
entity_type: topic
topic: orders
subscription: connic
agents:
- order-processorSende 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.
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]{
"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.
{
"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
}
}{
"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.
{
"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
}
}{
"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.
{
"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
}
}{
"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.
{
"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
}
}{
"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
Weitere Verbindungen
AWS S3
Neue Dateien in einem Bucket lösen Agenten aus, mit Include Content auch zusammen mit der Datei selbst.
Inbound
GitHub
Issues, Kommentare, Pull Requests und Reviews in einem GitHub-Repository lösen Agenten aus. Die Agenten antworten mit Kommentaren oder legen neue Issues an.
Inbound · Outbound
GitLab
Issues, Merge Requests und Kommentare in einem GitLab-Projekt lösen Agenten aus, auf gitlab.com oder deiner eigenen Instanz. Die Agenten antworten mit Kommentaren.
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
RabbitMQ
Nachrichten aus RabbitMQ-Queues lösen Agenten aus. Ihre Ergebnisse landen als persistente, bestätigte Nachrichten in einem Exchange.
Inbound · Outbound
Stripe
Stripe-Events wie invoice.payment_failed oder customer.subscription.updated lösen Agenten aus. connic prüft die Webhook-Signaturen.
Inbound