Google Pub/Sub
Jede Nachricht einer Push-Subscription in Pub/Sub startet einen Agent-Run, geprüft am Token, das Google signiert. Die Ergebnisse landen als JSON-Nachrichten mit Attributen in einem Topic.
- Modi
- Inbound, Outbound
- Einrichtung
- Dashboard oder connectors/*.yaml
- Dokumentation
- Google Pub/Sub Docs
- Publisher
- Von connic
Mach aus jeder Pub/Sub-Nachricht einen Run
Eine eingehende Verbindung empfängt die Nachrichten einer Push-Subscription und startet jeden verknüpften Agenten einmal pro Nachricht, mit der Nachricht als Eingabe.
- JSON bleibt, wie es ist
- connic dekodiert die Daten. Ein JSON-Objekt kommt mit seinen Schlüsseln auf oberster Ebene an, ergänzt um _google_pubsub mit Subscription, Nachrichten-ID, Veröffentlichungszeit, Ordering Key und Attributen.
- Text bleibt Text
- Alle anderen Daten landen unter message: Text als String, andere JSON-Werte geparst. Eine Nachricht, die nur Attribute hat, kommt mit message: null an.
- Ein Run pro Nachricht
- Die Run-IDs leiten sich aus der Nachrichten-ID ab. Stellt Pub/Sub eine Nachricht erneut zu, startet sie keinen neuen Run.
{
"data": { "order_id": "A-1001", "customer": "jana@example.com", "total": 49.9 },
"attributes": { "event": "order.created" },
"orderingKey": "customer-42"
}{
"order_id": "A-1001",
"customer": "jana@example.com",
"total": 49.9,
"_google_pubsub": {
"subscription": "projects/acme/subscriptions/orders-connic",
"message_id": "2070443601311540",
"publish_time": "2026-11-17T09:13:55.749Z",
"ordering_key": "customer-42",
"attributes": { "event": "order.created" }
}
}Kein Schlüssel zum Empfangen: Google signiert jede Push-Anfrage
Pub/Sub schickt mit jeder Push-Anfrage ein Token, das Google signiert. connic startet Runs nur, wenn das Token zu deinem Push-Dienstkonto gehört und die richtige Audience nennt.
- Dein Dienstkonto
- Die Push-Subscription authentifiziert sich mit einem Dienstkonto in deinem eigenen Google-Cloud-Projekt. Zum Empfangen braucht connic keinen Schlüssel.
- Lange Runs halten nichts auf
- connic antwortet, sobald die Runs gespeichert sind, nicht erst, wenn sie fertig sind. Lange Runs erreichen deshalb nie die Bestätigungsfrist.
- Wiederholungen bleiben bei Pub/Sub
- Ohne 200 versucht Pub/Sub die Nachricht mit seinem Backoff erneut, bis sie abläuft oder das Dead-Letter-Topic sie übernimmt.
Pub/Sub schickt eine Nachricht
Die Push-Subscription sendet die Nachricht an den Push-Endpunkt der Verbindung, mit einem OIDC-Token für ihr Dienstkonto.
Authorization: Bearerconnic prüft das Token
Die Signatur von Google, den Aussteller, die Audience und die bestätigte E-Mail-Adresse des Push-Dienstkontos. Jede andere Anfrage erhält 401 und startet nichts.
Runs werden gespeichert
connic speichert für jeden verknüpften Agenten einen Run in der Warteschlange und antwortet mit 200. Pub/Sub bestätigt die Nachricht damit.
200Agenten laufen
Runs laufen parallel bis max_concurrent_runs. Eine Concurrency-Regel auf dem Ordering Key startet die Runs von Nachrichten mit demselben Key nacheinander.
concurrency.key: _google_pubsub.ordering_key
Halte die Verbindung neben deinen Agenten
Deklariere sie als YAML-Datei in connectors/. Eine eingehende Verbindung nennt nur das Push-Dienstkonto, ihren Push-Endpunkt legt das erste Deployment an.
- Ein gcloud-Befehl
- Ein Befehl legt die Push-Subscription mit Endpunkt und Dienstkonto an. Die Dokumentation zeigt ihn, zusammen mit den Rollen, die Google verlangt.
- Audience nach Wahl
- Lass die Audience leer, dann gilt der Standard, der Push-Endpunkt. Oder setz dieselbe eigene Audience an der Subscription und in connic.
type: google_pubsub
mode: inbound
name: Order events
config:
push_service_account: pubsub-push@acme.iam.gserviceaccount.com
agents:
- order-processorVeröffentliche Ergebnisse in einem Topic
Eine ausgehende Verbindung veröffentlicht jeden abgeschlossenen Run als JSON in einem Topic, mit run_id, agent_name und status als Attributen, nach denen Subscriptions filtern können.
- Ordering Keys bleiben erhalten
- Hat eine Nachricht mit Ordering Key den Run gestartet, trägt das veröffentlichte Ergebnis denselben Key.
- 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, mit Attributen und Ordering Key.
- Dein Dienstkonto veröffentlicht
- Eine Connection enthält den JSON-Schlüssel eines Dienstkontos mit der Rolle Pub/Sub-Publisher am Topic. Bei Rate Limits und Serverfehlern von Google versucht connic es erneut.
type: google_pubsub
mode: outbound
name: Order results
connection: acme-pubsub
config:
topic: projects/acme/topics/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": "A-1001 approved for standard shipping.",
"error": null,
"started_at": "2026-11-17T09:13:56Z",
"ended_at": "2026-11-17T09:14:01Z",
"token_usage": {
"input_tokens": 642,
"output_tokens": 38,
"thinking_tokens": 0,
"cached_input_tokens": 0,
"total_tokens": 680
}
}{
"run_id": "550e8400-e29b-41d4-a716-446655440000",
"agent_name": "order-processor",
"status": "completed"
}Wo Google Pub/Sub passt
Wähle ein Szenario und sieh, welche Nachricht den Run startet, was der Agent erhält und wohin das Ergebnis geht.
Jedes Bestell-Event startet einen Run, und das Ergebnis landet mit dem Ordering Key der Bestellung im Topic order-results.
{
"order_id": "A-1001",
"customer": "jana@example.com",
"total": 49.9,
"_google_pubsub": {
"subscription": "projects/acme/subscriptions/orders-connic",
"message_id": "2070443601311540",
"publish_time": "2026-11-17T09:13:55.749Z",
"ordering_key": "customer-42",
"attributes": { "event": "order.created" }
}
}{
"run_id": "550e8400-e29b-41d4-a716-446655440000",
"agent_name": "order-processor",
"status": "completed",
"output": "A-1001 approved for standard shipping.",
"error": null,
"started_at": "2026-11-17T09:13:56Z",
"ended_at": "2026-11-17T09:14:01Z",
"token_usage": {
"input_tokens": 642,
"output_tokens": 38,
"thinking_tokens": 0,
"cached_input_tokens": 0,
"total_tokens": 680
}
}Der Agent liest jede neue Produktbewertung und veröffentlicht seine Entscheidung mit einem Attribut, nach dem dein Shop filtern kann.
{
"review_id": "R-7781",
"product": "trail-runner-2",
"rating": 1,
"text": "Sole came off after two weeks. Get the same shoe for half the price at cheap-sneakers.example!",
"_google_pubsub": {
"subscription": "projects/acme/subscriptions/reviews-connic",
"message_id": "2070443601311622",
"publish_time": "2026-11-17T09:13:55.749Z",
"ordering_key": null,
"attributes": { "source": "shop" }
}
}{
"payload": {
"review_id": "R-7781",
"decision": "hold",
"reason": "Links to another shop"
},
"attributes": { "decision": "hold" }
}Dein Monitoring veröffentlicht einen Alarm, und der Agent postet eine kurze Zusammenfassung in den Bereitschaftskanal in Slack.
{
"service": "checkout",
"alert": "Error rate above 5%",
"error_rate": 0.12,
"window": "5m",
"_google_pubsub": {
"subscription": "projects/acme/subscriptions/alerts-connic",
"message_id": "2070443601311705",
"publish_time": "2026-11-17T09:13:55.749Z",
"ordering_key": null,
"attributes": { "severity": "high" }
}
}{
"text": "Checkout error rate is at 12% over the last 5 minutes, above the 5% alert threshold."
}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": "A-1001",
"customer": "jana@example.com",
"status": "delayed",
"new_eta": "2026-11-20",
"_google_pubsub": {
"subscription": "projects/acme/subscriptions/shipments-connic",
"message_id": "2070443601311814",
"publish_time": "2026-11-17T09:13:55.749Z",
"ordering_key": "A-1001",
"attributes": {}
}
}{
"body": "Your order A-1001 is running late. It now arrives on November 20.",
"to": "jana@example.com",
"subject": "New delivery date for your order"
}FAQ zu Google Pub/Sub
Weitere Verbindungen
Azure Service Bus
Nachrichten aus Queues und Topic-Subscriptions in Service Bus lösen Agenten aus. Die Ergebnisse gehen an eine Queue oder ein Topic.
Inbound · Outbound
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
HTTP-Webhooks
HTTP-Anfragen mit JSON, Formulardaten oder Datei-Uploads lösen Agenten aus. Ein eigener Integrationsserver ist nicht erforderlich.
Inbound · Outbound · Sync
Shopify
Neue, bezahlte, ausgeführte oder stornierte Bestellungen in deinem Shopify-Shop lösen Agenten aus. Die Agenten taggen die Bestellung oder ergänzen eine Notiz.
Inbound · Outbound
Stripe
Stripe-Events wie invoice.payment_failed oder customer.subscription.updated lösen Agenten aus. connic prüft die Webhook-Signaturen.
Inbound
Telnyx Voice
Lass einen Sprachagenten unter deiner Telnyx-Rufnummer Anrufe entgegennehmen und selbst anrufen. connic richtet Call Control ein und überträgt das Gespräch.
Sync · Outbound