Verbindungsmodi
Inbound-Verbindungen starten Runs asynchron. Sync-Verbindungen geben Ergebnisse in derselben Anfrage zurück, Outbound-Verbindungen senden Daten an andere Systeme.
Auf dieser Seite
Verbindungen binden Agenten an externe Systeme an. Eine Inbound- oder Sync-Verbindung startet alle verknüpften Agenten durch dasselbe Ereignis. Eine Outbound-Verbindung sendet Daten eines verknüpften Agenten an ihr konfiguriertes Ziel.
Verbindungen sind auf ein Environment begrenzt. Jede Verbindung verwaltet die für ihren Transport erforderlichen Zugangsdaten, Zielvalidierung, Formatierung und Wiederholungsversuche.
Verbindung hinzufügen
Beginne mit dem zu verbindenden Agenten.
Agenten öffnen
Öffne in der Seitenleiste Agenten und wähle den zu verbindenden Agenten aus.
Verbindung hinzufügen
Klicke im Verbindungsflussdiagramm auf Add inbound connector oder Add outbound connector und wähle anschließend Create New Connector.
Verbindungstyp auswählen
Wähle eine Verbindung aus dem Marketplace, wähle, sofern verfügbar, inbound, outbound oder sync und gib die Einstellungen ein.
Verbindung erstellen
Klicke auf Create. Später lässt sich die Verbindung aus dem Flow öffnen, um ihre Einstellungen, die generierte URL oder das Secret zu prüfen.
Wähle beim Verknüpfen einer Outbound-Verbindung den automatischen, den Agent-Tool- oder den Middleware-Modus. Die Einstellungen der Verknüpfung lassen sich im Flow ändern.
Dieselbe Inbound- oder Sync-Verbindung kann mit mehreren Agenten verknüpft werden; ein Trigger startet alle verknüpften Agenten.
Inbound, sync und outbound
Die Verbindungsrichtung bestimmt, ob das externe System einen Run startet, Daten empfängt oder auf ein Ergebnis wartet.
Eine Inbound-Verbindung startet Agent Runs, ohne auf deren Ausgabe zu warten. Anfragebasierte Verbindungen bestätigen den Trigger, nachdem sie ihn weitergeleitet haben.
Geeignet für
- Hintergrundverarbeitung
- Webhook-Ingestion mit hohem Volumen
- Ereignisgesteuerte Architekturen
- Aufgaben, die kein sofortiges Ergebnis benötigen
HTTP-Webhook-Antwort
{
"status": "ok",
"dispatched_to": 2,
"run_ids": ["uuid-1", "uuid-2"]
}Eine Sync-Verbindung hält die Anfrage oder Session offen, bis der Agent abgeschlossen ist, und gibt das Ergebnis anschließend über diese Anfrage oder Session zurück.
Geeignet für
- REST-API-Integrationen
- Interaktive Anwendungen
- Kurz laufende Aufgaben von Agenten
- Anfragen, die ein sofortiges Ergebnis benötigen
HTTP-Webhook-Antwort
{
"status": "ok",
"result": {
"run_id": "uuid",
"output": "Response..."
}
}Eine Outbound-Verbindung validiert ihre eigene Payload und übernimmt Zielauswahl, Zugangsdaten, Transportformatierung und Wiederholungsversuche. Lege beim Verknüpfen mit einem Agenten fest, wie die Verbindung aufgerufen werden kann.
Geeignet für
- Übermittlung an externe APIs
- Chat- und E-Mail-Benachrichtigungen
- Kafka- und Queue-Pipelines
- Bedingtes Senden während eines Runs
Automatische HTTP-, Kafka- und SQS-Payload
{
"run_id": "uuid",
"agent_name": "my-agent",
"status": "completed",
"output": "Agent response...",
"error": null,
"started_at": "2026-08-20T09:00:00Z",
"ended_at": "2026-08-20T09:00:02Z",
"token_usage": {}
}Modus für Outbound-Verbindungen auswählen
Der Modus bestimmt, wer den Versand auslöst und wann.
Sendet einmal nach Abschluss eines Runs. Konfigurierbar sind alle abgeschlossenen Runs oder nur Runs, die durch ausgewählte Inputs gestartet wurden.
Fügt die Outbound-Verbindung als Tool zu einem LLM-Agenten hinzu. Das Modell entscheidet, ob es sie aufruft, und liefert ihre Payload.
Stellt die Outbound-Verbindung der Middleware bereit. Der Anwendungscode entscheidet außerhalb des KI-Modells, wann gesendet wird.
Standardmäßig send_to_<normalized_connector_name>; der Name muss unter allen für den Agenten verfügbaren Tools eindeutig sein.
Rufe den konfigurierten Namen aus before() oder after() über send_connector(action_name, payload) auf.
Automatische Outbound-Verbindungen nach Quelle filtern
Quellenfilter gelten nur für automatische Outbound-Verbindungen.
Sendet nach jedem abgeschlossenen Run, einschließlich manueller, geplanter und durch trigger_agent gestarteter Runs.
Sendet nur, wenn eine der ausgewählten Inbound- oder Sync-Verbindungen den Run gestartet hat.
Quellenfilter wirken sich nicht auf Agent-Tool- oder Middleware-Outbound-Verbindungen aus. Bestehende Verknüpfungen ohne eigene Moduseinstellungen verwenden weiterhin Automatic / All runs.
Jede Outbound-Verbindung definiert ihre Payload
Agent-Tool- und Middleware-Outbound-Verbindungen akzeptieren die dokumentierte Payload der Verbindung, nicht Zugangsdaten oder Transport-Wrapper. Die Verbindung validiert die Payload, ermittelt Ziel und Zugangsdaten und formatiert die HTTP-Anfrage, Queue-Nachricht, E-Mail oder Chat-Nachricht.
from connic.tools import send_connector
async def after(response: str, context: dict) -> str:
await send_connector(
"send_to_ops_slack",
{"text": response},
)
return responsesend_connector verwendet dasselbe Payload-Schema wie die Agent-Tool-Outbound-Verbindung. Unbekannte Felder auf oberster Ebene führen zu einem Validierungsfehler. Die gespeicherte Verbindungskonfiguration bleibt für den Agenten und die Middleware unzugänglich.
Was Agenten als Input erhalten
Das Eingabeformat hängt vom Verbindungstyp ab.
Der JSON-Body wird zum Input des Agenten. Formularfelder werden zu Schlüssel-Wert-Paaren. Hochgeladene Dateien werden als Inline-Daten an das Modell gesendet. Siehe Details zu HTTP Webhooks.
Der Nachrichtenwert wird als JSON geparst. Connic ergänzt ein _kafka-Objekt mit topic, partition, offset, timestamp und key. Siehe Details zu Apache Kafka.
Der Agent erhält Zeitplan, Trigger-Zeitpunkt und optionalen Prompt. Siehe Details zu Cron.
Ergebnisse von Inbound Runs abrufen
Inbound-Verbindungen geben run_ids sofort zurück. Nutze eine dieser Möglichkeiten, um die fertige Ausgabe zu prüfen oder zu übermitteln.
Verknüpfe sie mit demselben Agenten. Nach Abschluss des Runs sendet sie das Ergebnis an ihr konfiguriertes Ziel.
Öffne den Run unter Logs, um seine Ausgabe, Traces und Token-Nutzung zu prüfen.