Verbindungen im Überblick
Verbindungen starten Agenten durch externe Ereignisse, geben ihre Antworten an den Aufrufer zurück oder senden Run-Daten an andere Systeme.
Auf dieser Seite
Eine Verbindung bindet Agenten an ein externes System an, etwa einen HTTP-Endpunkt, eine Message Queue oder eine Rufnummer. Jede Verbindung gehört zu genau einem Environment und hat einen Typ und einen Modus. Sie übernimmt Authentifizierung, Zielprüfungen, Formatierung und Wiederholungsversuche ihres Transports. Manche Verbindungstypen beziehen ihre Zugangsdaten aus einem Kontozugang (Connection), den das ganze Projekt teilt.
Jeder Verbindungstyp hat eine eigene Seite mit seinen Modi, der Einrichtung, den Einstellungen und dem Input, den seine Agenten erhalten. Diese Seite beschreibt, was alle Verbindungen gemeinsam haben.
Modi
Der Modus legt fest, ob das externe System einen Run startet, auf dessen Antwort wartet oder Daten von ihm erhält. Ein Verbindungstyp unterstützt einen oder mehrere Modi; seine Seite nennt sie.
| Modus | Gestartet durch | Rückgabe | Geeignet für |
|---|---|---|---|
| Inbound | Ein externes Ereignis, etwa eine Anfrage, eine Queue-Nachricht oder ein Zeitplan | Nichts aus dem Run. Anfragebasierte Typen beantworten die Anfrage sofort. | Hintergrundarbeit, Ereignisse mit hohem Volumen, Aufgaben ohne sofortige Antwort |
| Sync | Eine Anfrage, Session oder ein Anruf, der auf die Antwort wartet | Die Antworten der Agenten über dieselbe Anfrage oder Session, je nach Typ vollständig oder als Stream | APIs, Chat, Telefonanrufe, kurze Aufgaben mit sofortiger Antwort |
| Outbound | Nichts. Der Run eines verknüpften Agenten sendet über sie. | Liefert Run-Daten an das Ziel der Verbindung | Ergebnisse zustellen, Benachrichtigungen, Queue-Pipelines |
Wie lange eine Sync-Verbindung wartet, hängt vom Verbindungstyp und vom Timeout des Agenten ab. Für lange Aufgaben eignet sich eine Inbound-Verbindung, deren Ergebnis eine automatische Outbound-Verbindung zustellt.
Ergebnisse von Inbound Runs
Eine Inbound-Verbindung antwortet, bevor ihre Runs fertig sind. Um die Ausgabe zu erhalten, verknüpfe eine automatische Outbound-Verbindung mit demselben Agenten; sie sendet das Ergebnis, sobald der Run abgeschlossen ist. Alternativ öffnest du den Run unter Logs und prüfst Ausgabe, Traces und Token-Nutzung.
Verbindung anlegen
Lege Verbindungen im Dashboard an, über die REST API oder connic MCP, oder deklariere sie in connectors/*.yaml neben deinen Agenten. Deployments wenden im Code deklarierte Verbindungen an, sodass ihre Einstellungen zusammen mit den verknüpften Agenten versioniert sind. Siehe Verbindungen im Code.
Im Dashboard beginnst du beim Agenten, der verbunden werden soll:
Öffne den Agenten unter Agenten.
Klicke im Connector Flow auf Add inbound connector oder Add outbound connector und dann auf Create New Connector.
Wähle den Verbindungstyp, bei mehreren Modi den Modus, und fülle die Einstellungen aus.
Klicke auf Create. Der Detailbereich zeigt Werte, die connic erzeugt, etwa URLs und Secrets. Später öffnest du ihn über die Verbindung im Flow.
Agenten verknüpfen
Eine Verbindung bedient die Agenten, die mit ihr verknüpft sind. Verknüpfe Agenten im Connector Flow eines Agenten oder liste sie unter agents in der YAML-Datei der Verbindung auf. Manche Verbindungstypen nehmen mehrere Agenten an. Welche davon ein Ereignis startet, steht auf der Seite der jeweiligen Verbindung.
Aktivierst du im Detailbereich der Verbindung Files required für einen Agenten, schlagen seine Runs schon vor dem Start fehl, wenn der Input keine Dateien enthält oder eine Datei ausgelassen wurde.
Outbound-Verbindungen
Eine Outbound-Verbindung sendet Daten der Agenten, die mit ihr verknüpft sind. Jede Verknüpfung legt fest, wie die Verbindung genutzt wird:
| Nutzung | Sendet | Entscheidet | YAML |
|---|---|---|---|
| Automatisch | Einmal nach erfolgreichem Abschluss eines Runs | Die Verknüpfung: jeder abgeschlossene Run oder nur Runs ausgewählter Verbindungen | automatic |
| Agent-Tool | Wenn das Modell das Tool aufruft | Das LLM, das auch die Payload schreibt | agent_tool |
| Middleware | Wenn die Middleware send_connector aufruft | Dein Code in before() oder after() | middleware |
In YAML setzt du die Nutzung unter outbound an der Agent-Verknüpfung; siehe Verbindungen im Code.
Automatische Quellen
Standardmäßig sendet eine automatische Verknüpfung nach jedem erfolgreich abgeschlossenen Run des Agenten, auch nach manuellen, geplanten und durch trigger_agent gestarteten Runs. Fehlgeschlagene und abgebrochene Runs senden nichts, ebenso wenig Test-Runs des Deploy-Gates und Runs, die die Middleware mit publish_outbound=False stoppt. Mit Only selected inputs sendet sie nur für Runs, die eine der ausgewählten Verbindungen gestartet hat; das müssen Inbound- oder Sync-Verbindungen sein, die im selben Environment mit demselben Agenten verknüpft sind. Verknüpfungen ohne gespeicherte Nutzungseinstellung verhalten sich wie Automatic / All runs.
Agent-Tool und Middleware
Eine Agent-Tool-Verknüpfung fügt die Verbindung einem LLM-Agenten als Tool hinzu. Im Dashboard lautet der Tool-Name standardmäßig send_to_<normalized_connector_name>. Er muss unter allen Tools des Agenten eindeutig sein und besteht aus höchstens 64 Kleinbuchstaben, Ziffern und Unterstrichen. Eine Middleware-Verknüpfung hat einen Aktionsnamen derselben Form, den die Middleware aus before() oder after() an send_connector(action_name, payload) übergibt.
from connic.tools import send_connector
async def after(response: str, context: dict) -> str:
await send_connector(
"send_to_ops_slack",
{"text": response},
)
return responseBeide nehmen die Payload an, die auf der Seite der Verbindung dokumentiert ist, nie Zugangsdaten oder Transport-Wrapper. Unbekannte Felder auf oberster Ebene führen zu einem Validierungsfehler. Ziel, Zugangsdaten und Transportformat ergänzt die Verbindung selbst; ihre gespeicherte Konfiguration bleibt für Agent und Middleware unsichtbar.
Pausieren und fortsetzen
Öffne die Verbindung im Connector Flow und klicke auf Pause. Eine pausierte Verbindung startet keine neuen Runs, bis du auf Resume klickst. Bereits wartende oder laufende Runs laufen weiter. Was mit Ereignissen während der Pause passiert, hängt vom Verbindungstyp ab; die Seite jeder Verbindung nennt es unter Während der Pause.
Eine pausierte Outbound-Verbindung sendet nichts. Automatische Sendungen für Runs, die während der Pause enden, entfallen und werden nicht nachgeholt, das Agent-Tool verschwindet vom Agenten, und send_connector löst einen Fehler aus.
Manche Inbound-Verbindungstypen legt das Dashboard pausiert an, damit sie keine Ereignisse verarbeiten, bevor sie verknüpft sind; ihre Seiten weisen darauf hin. Klicke auf Resume, sobald die Verbindung bereit ist. Im Code deklarierte Verbindungen und solche, die über die REST API oder connic MCP mit enabled: true angelegt werden, starten aktiv.