Zum Hauptinhalt springen

Integration einrichten

  1. Gehen Sie in Ihrem Devin-Konto unter app.devin.ai zu Settings > Integrations > Jira und klicken Sie auf „Connect“.
  2. Sie werden zu Jira weitergeleitet, um die Berechtigungen zu überprüfen und Devin Zugriff zu gewähren.
  3. Sobald die Verbindung hergestellt ist, konfigurieren Sie auf der Einstellungsseite Ihre Playbook-Labels und richten optional Automatisierungs-Trigger ein.
Nach dem Verbinden empfehlen wir, ein Servicekonto zu verbinden, damit Devins Kommentare vom Bot und nicht von Ihrem persönlichen Konto stammen. Siehe unten Ein Servicekonto verbinden.

So starten Sie Devin über Jira

Es gibt vier Möglichkeiten, eine Devin-Sitzung über ein Jira-Ticket zu starten:

Weisen Sie Devin das Ticket zu

Weisen Sie das Ticket direkt in Jira dem Devin Service-Account zu. Devin verwendet das in Ihren Jira-Integrations-Settings konfigurierte Standard-Playbook, um mit der Bearbeitung des Tickets zu beginnen.

Ein Playbook-Label hinzufügen

Fügen Sie dem Ticket ein Playbook-Label hinzu (z. B. !plan, !implement, !triage). Devin startet eine Sitzung mit dem passenden Playbook für dieses Label. Diese Labels entsprechen den Playbook-Labels, die in Ihren Integrations-Settings konfiguriert sind. Sie müssen diese Labels in Ihrem Jira-Projekt manuell erstellen — kopieren Sie dazu den Label-Namen aus den Integrations-Settings.

Fügen Sie das Label „devin“ hinzu

Fügen Sie das Label devin zu einem beliebigen Jira-Issue hinzu (möglicherweise müssen Sie dieses Label zuerst in Ihrem Jira-Projekt erstellen). Devin verwendet das Standard-Playbook, um mit der Arbeit an dem Ticket zu beginnen.
Die Integration verwendet einen Abgleich anhand von Wortgrenzen (ohne Berücksichtigung der Groß-/Kleinschreibung), sodass jedes Label, das devin als eigenständiges Wort enthält, sie auslöst — zum Beispiel devin, Devin, devin-workshop oder devin-task. Labels, bei denen „devin“ Teil eines längeren Worts ist, wie devinworkshop oder devin_workshop, lösen sie nicht aus.

Devin in einem Kommentar mit @mention erwähnen

Erwähne @Devin in einem Ticket-Kommentar mit konkreten Anweisungen. Devin startet eine Sitzung und verwendet deinen Kommentar als Aufgabenanweisung, ohne ein Playbook anzuwenden. Wenn für das Ticket bereits eine Sitzung existiert, wird deine Nachricht an die bestehende Sitzung weitergeleitet.

Integration konfigurieren

Sitzungsmodus

Mit dem Schalter für den Sitzungsmodus legen Sie fest, wie Devin auf Jira-Trigger reagiert:
  • Direkte Sitzungserstellung (standardmäßig aktiviert): Devin erstellt eine vollständige Sitzung, bearbeitet das Ticket und postet Updates zurück in Jira.
  • Nur Scoping (deaktiviert): Devin analysiert nur das Ticket und veröffentlicht einen Scoping-Kommentar mit einer Zusammenfassung, einem Implementierungsplan und einer Vertrauenseinschätzung. Anschließend können Sie über den bereitgestellten Link manuell eine Sitzung starten.

Playbook-Labels

Mit Playbook-Labels können Sie steuern, welche Devin-playbooks als Jira-Labels verfügbar sind. Wenn Sie ein Playbook hinzufügen, wird sein Makro (z. B. !plan) zu einem Label, das Sie Jira-Issues zuweisen können, um Devin mit diesem Playbook auszulösen. Labels müssen in Ihrem Jira-Projekt manuell erstellt werden — kopieren Sie den Label-Namen aus den Integrations-Settings.
  • Standard-Playbook: Ein Playbook ist als Standard markiert. Wenn ein Ticket ohne ein bestimmtes Playbook-Label ausgelöst wird (z. B. nur mit dem Label devin oder indem das Ticket Devin zugewiesen wird), verwendet Devin dieses Standard-Playbook.
  • Playbooks hinzufügen: Klicken Sie auf „Playbook hinzufügen“, um weitere Playbooks hinzuzufügen. Nur Playbooks mit einem Makro können hinzugefügt werden.
  • Playbooks entfernen: Entfernen Sie ein Playbook, damit sein Label nicht mehr als Auslöser verwendet wird.

Automatisierungs-Trigger

Mit Automatisierungs-Triggern kann Devin automatisch mit der Bearbeitung von Tickets beginnen, wenn diese bestimmte Bedingungen erfüllen – ganz ohne manuelle Zuweisung oder Labeling. Sie können Trigger anhand der folgenden Kriterien konfigurieren:
  • Projects: Nur für Tickets in bestimmten Jira-Projekten aktivieren.
  • Labels: Nur aktivieren, wenn ein Ticket bestimmte Labels hat.
  • Statuses: Nur aktivieren, wenn ein Ticket einen bestimmten Status erreicht (z. B. “To Do”, “In Progress”).
  • Playbook: Optional angeben, welches Playbook Devin für die aktivierte Sitzung verwenden soll.
Trigger verwenden Flankenerkennung. Das bedeutet, sie werden nur ausgelöst, wenn ein Ticket von „entspricht nicht“ zu „entspricht“ wechselt (z. B. wenn ein Label hinzugefügt wird oder sich ein Status ändert), nicht bei Tickets, die die Bedingungen bereits erfüllen.

Enterprise: Zuordnung von Jira-Projekten

In Enterprise-Umgebungen mit mehreren Devin-Organisationen können Admins Jira-Projekte bestimmten Devin-Organisationen zuordnen. Dadurch wird sichergestellt, dass Tickets aus jedem Jira-Projekt der richtigen Devin-Organisation zugewiesen werden. Eine solche Zuordnung ist erforderlich, damit die Jira-Integration in Enterprise-Umgebungen funktioniert.

Interaktion mit Devin in Jira

Sobald Devin mit der Bearbeitung eines Tickets beginnt, meldet es sich über Jira zurück:
  • PR-Links: Wenn Devin einen Pull Request erstellt, wird die PR-URL automatisch als Remote-Link zum Jira-Vorgang hinzugefügt und als Kommentar veröffentlicht.
  • Sitzungslink: Ein direkter Link zur Devin-Sitzung in der Web-App wird bereitgestellt, damit Sie den Fortschritt in Echtzeit verfolgen können.
  • Weitere Nachrichten: Erwähnen Sie @Devin in einem Kommentar, um Devin zusätzliche Anweisungen zu geben oder Fragen zu stellen.

Verbinden eines Servicekontos

Nachdem du Jira mit deinem Administratorkonto verbunden hast, kannst du optional ein Servicekonto über OAuth 2.0-Client-Anmeldedaten verbinden. Dadurch erscheinen Devins Kommentare unter einer eigenen Bot-Identität statt unter deinem persönlichen Konto.
  1. Erstelle in den Admin-Settings deiner Atlassian-Organisation ein OAuth 2.0-Servicekonto mit den folgenden Classic-Geltungsbereichen:
    • read:me
    • read:jira-user
    • read:jira-work
    • write:jira-work
  2. Klicke in Settings > Integrationen > Jira auf Servicekonto verbinden und gib die Client-ID und das Client-Secret ein.