Zum Hauptinhalt springen
connic
Starte kostenlos

GitLab

Lass connic-Agenten auf Issues, Merge Requests und Kommentare in deinen GitLab-Projekten reagieren. Die Agenten antworten mit einem Kommentar dort, wo das Event passiert ist.

Modi
Inbound, Outbound
Einrichtung
Dashboard oder connectors/*.yaml
Dokumentation
GitLab Docs
Publisher
Von connic

Reagiere auf Issues, Merge Requests und Kommentare

Passt ein Event im Projekt zu den Events einer eingehenden Verbindung, startet jeder damit verknüpfte Agent. Eine ausgehende Verbindung mit derselben Connection postet das Ergebnis als Kommentar.

Events und Aktionen wählen
merge_requests reagiert auf jede Änderung an einem Merge Request, merge_requests.merge nur auf Merges. Bei Issues und Kommentaren funktioniert es genauso.
Mehrere Verbindungen pro Projekt
Jede Verbindung hat ihren eigenen Webhook. Beobachte Merge Requests mit der einen und Issues mit der anderen, oder nutze eine pro Environment.
Keine Schleifen, keine doppelten Runs
Änderungen des Nutzers, dem der Token gehört, werden ignoriert, und ein Event, das GitLab erneut zustellt, startet keinen zweiten Run.
  1. Im Projekt passiert etwas

    Jemand eröffnet ein Issue oder einen Merge Request, merged einen oder schreibt einen Kommentar.

    merge_requests.open
  2. connic prüft und bestätigt das Event

    connic prüft das Secret Token des Webhooks, ab GitLab 19.0 auch die Signatur, und antwortet GitLab sofort.

    X-Gitlab-Token
  3. Verknüpfte Agenten starten

    Der Run bekommt Event und Aktion, das Issue oder den Merge Request mit Titel, den Text in Markdown, einen Link und wer das Event ausgelöst hat.

    notes.create
  4. Die Antwort landet als Kommentar

    Eine ausgehende Verbindung mit derselben Connection kommentiert das Issue oder den Merge Request, der den Run gestartet hat.

Ein Token, den Webhook legt connic an

Du fügst einmal einen Access Token ein. Beim Speichern einer eingehenden Verbindung fügt connic ihrem Projekt in GitLab einen Webhook hinzu, und beim Löschen entfernt connic ihn wieder.

gitlab.com oder deine eigene Instanz
Lass die Basis-URL für gitlab.com stehen oder trag dein selbst betriebenes GitLab ein. Es muss aus dem Internet erreichbar sein.
Ein Projekt pro Verbindung
Trag das Projekt mit seinem Pfad ein, etwa acme/shop. connic merkt sich seine ID, eine Umbenennung legt die Verbindung also nicht lahm.
Nichts zurückzukopieren
connic erzeugt Secret Token und Signing Token des Webhooks und prüft damit jede Zustellung. Den Webhook findest du in den Webhook-Einstellungen des Projekts.
gitlab-webhook.json
{
  "url": "https://connect.connic.co/gitlab/<connector-id>",
  "issues_events": true,
  "merge_requests_events": true,
  "note_events": true,
  "push_events": false,
  "token": "<generated by connic>",
  "signing_token": "<generated by connic>"
}

Antworte dort, wo das Event passiert ist

Eine ausgehende GitLab-Verbindung postet den Output des Agenten als Kommentar im Issue oder Merge Request, der den Run gestartet hat.

Nur Antworten
Der Kommentar geht an das Issue oder den Merge Request, aus dem der Run über eine eingehende Verbindung mit derselben Connection kam.
Drei Wege zu senden
Sende nach jedem abgeschlossenen Run, gib dem Modell ein Tool oder rufe send_connector aus Middleware auf, wenn dein Code entscheidet.
Rate Limits inklusive
Bremst GitLab einen Kommentar per Rate Limit aus, wartet connic und sendet erneut.
output.json
{
  "body": "The total is rounded in the cart and again at payment."
}
connector-payload.json
{
  "body": "Reproduced on main: the total is rounded twice."
}

Wo GitLab passt

Wähle ein Szenario und sieh, was beim Agenten ankommt und was er in GitLab postet.

Jemand eröffnet ein Issue, und der Agent fragt nach fehlenden Angaben und nennt den wahrscheinlich betroffenen Bereich.

Neues Issue
Inbound GitLab
issue-triage
Kommentar im Issue
gitlab-payload.json
{
  "event": "issues",
  "action": "open",
  "project": "acme/shop",
  "type": "issue",
  "iid": 418,
  "title": "Refund button does nothing",
  "text": "Clicking Refund on an order shows no error and no refund.",
  "url": "https://gitlab.com/acme/shop/-/issues/418",
  "author": "jane"
}
output.json
{
  "body": "Likely the refunds service. Which order ID and browser?"
}

Jemand eröffnet einen Merge Request, und der Agent kommentiert, was er ändert und was ihm fehlt.

Neuer Merge Request
Inbound GitLab
mr-reviewer
Review-Kommentar
gitlab-payload.json
{
  "event": "merge_requests",
  "action": "open",
  "project": "acme/shop",
  "type": "merge_request",
  "iid": 97,
  "title": "Round EUR totals once",
  "text": "Drops the rounding in the cart service.",
  "url": "https://gitlab.com/acme/shop/-/merge_requests/97",
  "author": "jane"
}
output.json
{
  "body": "Looks right. The invoice service still rounds on its own."
}

Jemand stellt in einem Kommentar eine Frage, und der Agent antwortet im selben Merge Request.

Neuer Kommentar
Inbound GitLab
codebase-helper
Antwort als Kommentar
gitlab-payload.json
{
  "event": "notes",
  "action": "create",
  "project": "acme/shop",
  "type": "merge_request",
  "iid": 97,
  "title": "Round EUR totals once",
  "text": "Which services still round on their own?",
  "url": "https://gitlab.com/acme/shop/-/merge_requests/97#note_5521",
  "author": "jane"
}
output.json
{
  "body": "The cart and invoice services. Both call round() before payment."
}

Ein Merge Request wird gemerged, und der Agent schreibt den Changelog-Eintrag dazu.

Gemerged
Inbound GitLab
changelog-writer
Changelog-Kommentar
gitlab-payload.json
{
  "event": "merge_requests",
  "action": "merge",
  "project": "acme/shop",
  "type": "merge_request",
  "iid": 97,
  "title": "Round EUR totals once",
  "text": "Drops the rounding in the cart service.",
  "url": "https://gitlab.com/acme/shop/-/merge_requests/97",
  "author": "jane"
}
output.json
{
  "body": "Changelog: EUR totals are rounded once, at payment."
}

FAQ zu GitLab

Die Adresse deines GitLab, gitlab.com oder deine eigene Instanz, und einen Access Token mit dem Scope api: einen Project, Group oder Personal Access Token. Eingehende Verbindungen fügen ihrem Projekt einen Webhook hinzu, und das erlaubt GitLab nur Maintainern. Ihr Token braucht also diese Rolle.

Vom Nutzer, dem der Token gehört. Events, die dieser Nutzer auslöst, ignoriert connic, damit sich ein Agent nicht selbst erneut startet. Ein Project oder Group Access Token bringt einen eigenen Nutzer mit, dann starten die Änderungen aller anderen weiterhin Runs.

Nein. Beim Speichern einer eingehenden Verbindung fügt connic ihrem Projekt einen Webhook mit einem selbst erzeugten Secret Token hinzu, und beim Löschen entfernt connic ihn wieder. Ab GitLab 19.0 prüft connic außerdem die Signatur jeder Zustellung.

Ja, wenn die Instanz per HTTPS aus dem Internet erreichbar ist und mindestens GitLab 17.4 läuft.

Ja, mit type: gitlab, dem Pfad des Projekts und dem Namen einer GitLab-Connection, die Basis-URL und Access Token enthält.