GitHub
Agenten mit Issues, Kommentaren und Pull Requests in deinen Repositories starten und ihre Ergebnisse als Kommentar oder neues Issue posten.
Auf dieser Seite
| Modi | Inbound, Outbound |
| YAML-Typ | github |
| Zugangsdaten | Ein Kontozugang (Connection) vom Typ github, mit einer GitHub-App, die connic vorbereitet und du auf GitHub erstellst |
| Bridge | Nicht unterstützt |
| Custom Domain | Nicht unterstützt |
| Verknüpfte Agenten | Einer oder mehrere. Jedes passende Event startet alle verknüpften Agenten. |
| Während der Pause | Events erhalten 200 und starten keine Runs. Outbound sendet nichts. |
Einrichtung
Klicke unter Projekt-Settings → Connections auf New connection und wähle GitHub. Den Kontozugang kannst du auch im Formular der Verbindung über die Auswahl unter Connection anlegen.
Gib unter Name einen Namen für den Kontozugang ein und den GitHub App name, mit dem die Kommentare und Issues deiner Agenten erscheinen. Soll die App einer Organisation gehören, trag sie unter Organization ein; für dein persönliches Konto bleibt das Feld leer. Klicke auf Create connection.
Klicke unter Create app auf Create on GitHub. GitHub zeigt die App, die connic vorbereitet hat; ihren Namen kannst du dort noch ändern. Erstelle die App. GitHub leitet dich zurück auf die Seite Connections, und connic schließt die Einrichtung von selbst ab.
Klicke unter Install auf Install on GitHub, wähle das Konto oder die Organisation und die Repositories, in denen die Agenten arbeiten sollen. Weitere Repositories kannst du später auf GitHub hinzufügen. Klicke auf Done.
Öffne den Agenten. Klicke im Connector Flow für Repository-Events auf Add inbound connector oder für Kommentare und Issues auf Add outbound connector. Klicke dann auf Create New Connector und wähle GitHub.
Wähle den Modus, Inbound (Repository events) oder Outbound (Comments and issues), und unter Connection den Kontozugang. Gib das Repository als owner/name ein, etwa
acme/api, und bei Inbound die Events. Klicke auf Create. Bei Outbound legst du danach fest, wie der Agent die Verbindung nutzt, und klickst auf Link connector.
Konfiguration
Die Felder einer GitHub-Verbindung, in connectors/*.yaml genauso wie in der REST API und connic MCP. Der GitHub-Kontozugang, den sie nennen, muss im Dashboard fertig eingerichtet sein; bis dahin schlagen Deployment oder Anfrage fehl. Die Beschreibungen nennen die passende Einstellung im Dashboard. Verbindungen im Code beschreibt die Felder, die alle Verbindungen gemeinsam haben, etwa agents und environments.
| Feld | Typ | Status | Beschreibung |
|---|---|---|---|
| type | string | Erforderlich | github. |
| mode | string | Erforderlich | inbound oder outbound. Dashboard: Mode. |
| connection | string | Erforderlich | Inbound und Outbound. Name oder ID eines fertig eingerichteten GitHub-Kontozugangs. Dashboard: Connection. |
| config | object | Erforderlich | Einstellungen der GitHub-Verbindung. |
| repository | string | Erforderlich | Inbound und Outbound. Das Repository als owner/name, etwa acme/api. Inbound-Verbindungen erhalten seine Events, Outbound-Verbindungen legen dort Issues an. Die GitHub-App muss darauf installiert sein, bevor du die Verbindung anlegst; siehe GitHub-App. Dashboard: Repository. |
| events | string[] | Erforderlich | Inbound. Die Events, die Runs starten. Ein Eintrag ist entweder ein Event wie issues für alle seine Aktionen oder event.action für nur eine Aktion, etwa issues.opened, issue_comment.created oder pull_request.closed. Events: issues, issue_comment, pull_request, pull_request_review und pull_request_review_comment. Dashboard: Events, einer pro Zeile, vorausgefüllt mit issues.opened. |
GitHub-App, Private Key und Webhook Secret gehören zum Kontozugang, nicht zur Verbindung.
Erzeugte Werte
connic erzeugt diese Werte am Kontozugang, alle Verbindungen mit diesem Kontozugang teilen sie also.
| Wert | Modi | Beschreibung |
|---|---|---|
| Webhook URL | Inbound, Outbound | Hierhin sendet GitHub die Events der App, eine URL pro Kontozugang. connic trägt sie ins App-Manifest ein, du musst sie also nirgends eingeben. |
| App-Manifest | Inbound, Outbound | Die Definition der GitHub-App mit ihren Berechtigungen und Events. Create on GitHub sendet sie an GitHub. |
| App-ID, Private Key, Webhook Secret | Inbound, Outbound | GitHub übergibt sie an connic, sobald die App erstellt ist. Du musst nichts einfügen. |
Agent-Input
Modi: Inbound
Eine Inbound-Verbindung startet einen Run für jeden verknüpften Agenten, sobald in ihrem Repository ein passendes Event eintritt. Events, die die App selbst auslöst, etwa ihre eigenen Kommentare und Issues, ignoriert connic. So starten sich Agenten nicht selbst. Der Run erhält:
{
"event": "issue_comment",
"action": "created",
"repository": "acme/api",
"number": 42,
"conversation_id": "github:acme/api#42",
"title": "Checkout schlägt bei EUR-Bestellungen fehl",
"text": "Tritt nach dem letzten Deployment auf main weiterhin auf.",
"url": "https://github.com/acme/api/issues/42#issuecomment-2481190311",
"sender": "octocat",
"raw": { ... }
}eventundactionsind Name und Aktion des Events bei GitHub, etwaissue_commentundcreated.numberist die Nummer des Issues oder Pull Requests undtitlesein Titel, auch bei Kommentaren und Reviews.conversation_idbleibt für alle Events eines Issues oder Pull Requests gleich. Soll dein Agent die früheren Kommentare als Verlauf kennen, setze in seiner YAMLsession.key: input.conversation_id. Von sich aus schaltet der Connector keine Sessions ein.textist der Text des Issues, Pull Requests, Kommentars oder Reviews undurlder Link dorthin.senderist der GitHub-Login der Person, die das Event ausgelöst hat.rawenthält den vollständigen Event-Payload, so wie GitHub ihn gesendet hat.
Mehrere Verbindungen können dasselbe Repository beobachten, etwa eine für Issues und eine für Pull Requests oder eine pro Environment. Ein Event erreicht jede Verbindung, deren Repository und Events passen. Stellt GitHub ein Event mit derselben Delivery-ID erneut zu, startet kein weiterer Run. Der Inbound-Modus antwortet nicht von selbst: Für einen Kommentar im Issue oder Pull Request verknüpfst du den Agenten mit einer Outbound-GitHub-Verbindung, die denselben Kontozugang nutzt; siehe Outbound-Zustellung.
GitHub-App
Create on GitHub sendet das App-Manifest von connic an GitHub. Es beschreibt eine private GitHub-App mit den Repository-Berechtigungen Issues (Lesen und Schreiben), Pull requests (Lesen und Schreiben) und Metadata (Lesen). Die App abonniert die Events issues, issue_comment, pull_request, pull_request_review und pull_request_review_comment an der Webhook URL des Kontozugangs. Hast du die App erstellt, leitet GitHub dich zurück auf die Seite Connections, und connic schließt die Einrichtung mit App-ID, Private Key und Webhook Secret der App ab. Das muss innerhalb einer Stunde nach dem Start auf GitHub geschehen.
Der App-Name hat höchstens 34 Zeichen und muss auf GitHub eindeutig sein; vor dem Erstellen kannst du ihn auf GitHub noch ändern. Lässt du Organization leer, gehört die App deinem persönlichen Konto. Für eine App in einer Organisation brauchst du dort die Rolle Owner.
Die App ist privat: Nur das Konto, dem sie gehört, kann sie installieren. Lege deshalb einen Kontozugang pro GitHub-Konto oder Organisation an. Ein Kontozugang bedient beliebig viele Inbound- und Outbound-Verbindungen in jedem Environment. connic prüft die Signatur jedes Events von GitHub mit dem Webhook Secret.
Installiere die App auf dem Repository einer Verbindung, bevor du die Verbindung anlegst. connic prüft das und weist dich darauf hin, wenn die App dort fehlt. Weitere Repositories kannst du der Installation später auf GitHub hinzufügen.
Outbound-Zustellung
Modi: Outbound
Eine Outbound-GitHub-Verbindung postet bei jeder Nutzung einmal: wenn der Run eines verknüpften Agenten abgeschlossen ist, wenn das Modell sie als Tool aufruft oder wenn Middleware sie aufruft, je nach Nutzung der Verknüpfung. Dabei gilt die erste zutreffende Regel:
- Nennt die Ausgabe oder der Payload eine
issue_number, kommentiert sie dieses Issue oder diesen Pull Request im Repository der Verbindung. - Kam der Run über eine Inbound-GitHub-Verbindung mit demselben Kontozugang, kommentiert sie das Issue oder den Pull Request, aus dem er stammt.
- Sonst legt sie ein neues Issue im Repository der Verbindung an. Sein Titel ist
titleaus Ausgabe oder Payload, ohne ihn die erste Zeile des Texts.
Automatische Ausgabe
Eine automatische Verknüpfung postet die finale Ausgabe des Runs. Klartext wird zum Text des Kommentars oder Issues. Bei einem JSON-Objekt kommt der Text aus body, text, message, response oder output, in dieser Reihenfolge, und title und issue_number lassen sich mitgeben.
{
"title": "EUR-Beträge werden im Checkout doppelt gerundet",
"body": "Seit 2.14.0 weichen Bestellungen in EUR um einen Cent ab. Der Betrag wird im Warenkorb und noch einmal bei der Zahlung gerundet."
}Payload für Agent-Tool und Middleware
Das Modell oder die Middleware übergibt body, Pflicht und nicht leer, und optional title und issue_number. Andere Felder werden abgelehnt.
{
"body": "Auf main reproduziert: Der Betrag wird im Warenkorb und noch einmal bei der Zahlung gerundet.",
"issue_number": 42
}Zustellung und Wiederholungen
Bremst GitHub einen Kommentar oder ein Issue per Rate Limit aus, wartet connic und sendet erneut. Die Runs der Verbindung zeigen jede Zustellung mit dem Link zum Kommentar oder Issue oder mit dem Fehler.
Limits und Fehler
| Limit | Wert |
|---|---|
| App-Name | 34 Zeichen, auf GitHub eindeutig |
| Einrichtung der App | Innerhalb einer Stunde nach dem Start auf GitHub |
| Antwort an GitHub | GitHub erwartet innerhalb von 10 Sekunden eine Antwort. connic antwortet sofort und startet die Agenten danach. |
| Fehlgeschlagene Zustellungen | GitHub wiederholt sie nicht. Bis zu 3 Tage lang kannst du sie in den Advanced-Einstellungen der App auf GitHub oder über die API von GitHub erneut zustellen. |
| Textlänge | 65.536 Zeichen pro Kommentar oder Issue, von GitHub vorgegeben. Längerer Text wird nicht gesendet. |
| Kommentare und Issues | Etwa 80 pro Minute laut dem sekundären Rate Limit von GitHub. Greift es, wartet connic und stellt erneut zu. |
Anfragen mit fehlender oder falscher Signatur erhalten 401. Eine Verbindung lässt sich nicht anlegen, solange die Einrichtung des Kontozugangs nicht abgeschlossen ist oder die App nicht auf dem Repository installiert ist. Eine Zustellung schlägt fehl, wenn GitHub sie ablehnt, etwa weil das Issue nicht existiert oder die App im Repository keine Issues schreiben darf.