Zum Hauptinhalt springen
connic
Starte kostenlos

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.
message on orders (data decoded)
{
  "data": { "order_id": "A-1001", "customer": "jana@example.com", "total": 49.9 },
  "attributes": { "event": "order.created" },
  "orderingKey": "customer-42"
}
context["payload"]
{
  "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.
  1. 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: Bearer
  2. connic 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.

  3. 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.

    200
  4. Agenten 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.
connectors/order-events.yaml
type: google_pubsub
mode: inbound
name: Order events
config:
  push_service_account: pubsub-push@acme.iam.gserviceaccount.com
agents:
  - order-processor
create: connectors/order-events.yaml (google_pubsub)

Verö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.
connectors/order-results.yaml
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]
data on order-results
{
  "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
  }
}
attributes on order-results
{
  "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.

Checkout-Service
Pub/Sub-Push
order-processor
Ergebnis in order-results
context["payload"]
{
  "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" }
  }
}
data on order-results
{
  "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.

Produktbewertungen
Pub/Sub-Push
review-moderator
Entscheidung in reviews-moderated
context["payload"]
{
  "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" }
  }
}
connector-payload.json
{
  "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.

Monitoring
Pub/Sub-Push
alert-summarizer
Nachricht in Slack
context["payload"]
{
  "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" }
  }
}
connector-payload.json
{
  "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.

Lagersystem
Pub/Sub-Push
delay-notifier
E-Mail an den Kunden
context["payload"]
{
  "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": {}
  }
}
connector-payload.json
{
  "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

Füge eine Google-Pub/Sub-Verbindung im Modus Inbound (Push subscription) hinzu, trag die E-Mail-Adresse des Dienstkontos ein, mit dem sich deine Push-Subscription authentifiziert, und verknüpfe den Agenten. Richte dann am Topic eine Push-Subscription auf den Push-Endpunkt der Verbindung ein, mit Authentifizierung über dieses Dienstkonto. Jede Nachricht startet einen Run für jeden verknüpften Agenten.

Zum Empfangen keine: Jede Push-Anfrage bringt ein Token mit, das Google für dein Dienstkonto signiert, und connic prüft es. Zum Veröffentlichen braucht connic eine Connection mit dem JSON-Schlüssel eines Dienstkontos, das am Topic die Rolle Pub/Sub-Publisher hat.

Nein. Die Run-IDs leiten sich aus der Nachrichten-ID von Pub/Sub ab, eine erneut zugestellte Nachricht startet also keinen neuen Run. connic bestätigt eine Nachricht, sobald ihre Runs gespeichert sind, also bevor sie laufen.

Pub/Sub wiederholt jede Push-Anfrage ohne 200 mit exponentiellem Backoff, bis die Nachricht abläuft oder das Dead-Letter-Topic der Subscription sie übernimmt. connic lehnt Anfragen ohne gültiges Token ab, ebenso Nachrichten, die die Subscription entpackt schickt, und Daten, die weder JSON noch UTF-8-Text sind. Alle Antworten stehen in der Google-Pub/Sub-Dokumentation.