Devin-Jira-Integration

Es gibt zwei Möglichkeiten, Jira Cloud mit Devin zu verbinden. Bei beiden können Nutzer Jira-Arbeitselemente an Devin übergeben und erhalten Pull-Requests zurück. Die beiden Varianten unterscheiden sich jedoch in der Installation und darin, wie sie ausgelöst werden.

​

Welche Option sollte ich verwenden?

• Jira-Cloud-Agent-Funktionen sind in Ihrem Workspace aktiviert → verwenden Sie den Rovo-Agent. Devin erscheint wie jeder andere Agent in der Auswahl der zuständigen Person sowie in @Erwähnungen und meldet sich auf der Agent-Karte des Arbeitselements zurück. Durch das Verknüpfen der Site stehen außerdem deren Jira-Arbeitselement-Events als Auslöser für Devin-Automatisierungen zur Verfügung.
• Rovo ist in Ihrem Jira-Workspace deaktiviert → verwenden Sie einen Service-Benutzer. Devin agiert über ein von Ihnen erstelltes Jira-Dienstkonto und meldet sich per Kommentar und Remote-Link zurück.

Beide Optionen führen reguläre Devin-Sitzungen aus, funktionieren mit Devin-Automatisierungen, unterliegen denselben Voraussetzungen und werden gleich abgerechnet.

​

Devin-Automatisierungen

Mit Devin-Automatisierungen starten Sie Devin automatisch aus Jira heraus – und zwar mit beiden Optionen. Sobald eine Jira-Site verbunden ist (entweder über die Devin for Jira App verknüpft oder über ein Admin-Konto verbunden), stehen ihre Work-Item-Events als Jira-Auslöser zur Verfügung. Wählen Sie beim Erstellen der Automatisierung einen davon aus:

• Issue created – ein Work Item wird erstellt.
• Issue updated – ein beliebiges Feld eines Work Items ändert sich; die geänderten Felder stehen in den Bedingungen der Automatisierung zur Verfügung.
• Label hinzugefügt – einem Work Item wird ein Label hinzugefügt; pro Label wird ein Event ausgelöst.
• Status geändert – der Status eines Work Items ändert sich, oder ein Work Item wird mit einem Status erstellt.
• Assigned – ein Work Item wird mit einer zugewiesenen Person erstellt, oder die Zuweisung ändert sich.
• Comment created – zu einem Work Item wird ein Kommentar erstellt. Kommentare, die Devin selbst verfasst, lösen diesen Auslöser nicht aus.

Bedingungen können nach Projekt, Label, Status, zugewiesener Person, Epic (dem übergeordneten Element des Work Items) und Zusammenfassung filtern. Sobald die Sitzung der Automatisierung abgeschlossen ist, wird ihre letzte Nachricht als Kommentar im Work Item gepostet – bei einer über die App verknüpften Site über die Devin App, bei einer über ein Admin-Konto verbundenen Site über die Service-User-Verbindung. Verfügt eine Site über beide Verbindungen, wird jedes Event nur einmal zugestellt, und zwar über die Service-User-Verbindung.

​

Option 1: Devin-Rovo-Agent in Jira

Devin for Jira ist eine Atlassian-Forge-App, die auf dem Rovo-Agent-Connector basiert. Nach der Installation und Verknüpfung steht Devin als Agent auf Ihrer Jira-Cloud-Site zur Verfügung: Weisen Sie Devin ein Arbeitselement zu oder erwähnen Sie @Devin in einem Kommentar – Devin plant dann die Arbeit, schreibt den Code, öffnet einen Pull-Request und meldet die Ergebnisse im Arbeitselement zurück.

​

Setup

Das Setup erfolgt in zwei Schritten: Zuerst wird die App auf Ihrer Jira-Site installiert, anschließend verknüpft ein Devin-Admin diese Site mit einem Devin-Konto.

​

1. App auf Ihrer Site installieren

1. Ein Jira-Admin öffnet Devin im Atlassian Marketplace und installiert die App auf Ihrer Jira-Cloud-Site (your-site.atlassian.net).
2. Der Jira-Admin prüft die von der App angeforderten Berechtigungen und bestätigt sie. Die App hat Lese- und Schreibzugriff auf Work Items und Kommentare, liest Jira-Nutzer und deren E-Mail-Adressen (um sie Devin-Nutzern zuzuordnen) und prüft Projektberechtigungen.

Nach der Installation erscheint Devin als Agent auf der Site, kann aber erst Aufgaben übernehmen, wenn die Site mit einem Devin-Konto verknüpft ist.

​

2. Jira-Site mit Ihrem Devin-Konto verknüpfen

1. Gehen Sie in Jira zu Settings > Apps und öffnen Sie die von der App hinzugefügte Devin-Seite. Dort wird „This site is not connected to a Devin account yet.“ angezeigt.
2. Klicken Sie auf Connect to Devin. In einem neuen Tab öffnet sich eine Devin-Seite. Melden Sie sich bei Devin an, falls Sie dazu aufgefordert werden.
3. Prüfen Sie, ob es sich bei der angezeigten Jira-Site um Ihre handelt, wählen Sie das Devin-Konto aus, mit dem sie verknüpft werden soll, und klicken Sie auf Link site.
4. Wechseln Sie zurück zu Jira und klicken Sie auf Check again. Die Seite zeigt nun das Devin-Konto an, mit dem die Site verbunden ist.

Die verknüpfte Site wird in Devin unter Settings > Connections > Jira als Devin app for Jira · installed from Jira mit dem Badge Linked aufgeführt. Um die Verbindung zu trennen, öffnen Sie dort das Menü Actions der Site, wählen Sie Unlink site… und bestätigen Sie mit Unlink site: Devin nimmt ab sofort keine neuen Aufgaben mehr von dieser Jira-Site an; bereits laufende Sitzungen in Devin werden nicht beendet. Um die Site erneut zu verknüpfen, klickt ein Jira-Admin in Jira wieder auf Connect to Devin.

​

Auslöser

Um Devin automatisch durch Work-Item-Events zu starten, verwenden Sie Devin-Automatisierungen. Alternativ können Sie eine Devin-Sitzung auf zwei Arten manuell aus einem Work Item heraus mit dem Rovo-Agent starten.

​

Den Vorgang Devin zuweisen

Wählen Sie im Feld „Zugewiesene Person“ des Vorgangs Devin aus. Devin startet eine Sitzung und bearbeitet den Vorgang, wobei Zusammenfassung und Beschreibung als Aufgabe dienen.

• Wiederholte Zuweisungen durch dieselbe Person innerhalb von fünf Minuten werden als Duplikate behandelt, solange die Aufgabe aktiv ist. Wird der Vorgang später oder von einer anderen Person erneut zugewiesen, kann eine weitere Sitzung starten, auch wenn die erste noch läuft.
• Wird der Vorgang Devin erneut zugewiesen, nachdem Devin fertig ist, startet eine neue Sitzung.

​

Devin in einem Kommentar @erwähnen

Erwähnen Sie @Devin in einem Kommentar mit konkreten Anweisungen. Devin startet eine Sitzung, die Ihren Kommentar als Aufgabe und die Beschreibung des Vorgangs als Kontext verwendet. Sobald Devin fertig ist oder pausiert, um Ihnen eine Frage zu stellen, postet es seine letzte Nachricht als an Sie gerichteten Kommentar im Vorgang. Jeder Kommentar, in dem Devin erwähnt wird, startet eine eigene Sitzung. Um eine bereits laufende Sitzung fortzusetzen, antworten Sie stattdessen im Agent-Panel.

​

Das Agent-Panel

Während Devin arbeitet, wird der Fortschritt im Jira-Agent-Panel des Vorgangs angezeigt:

• Live-Status: Das Agent-Panel zeigt Devins Fortschritt in Echtzeit an.
• Sitzungslink: Devins erste Nachricht ist ein Link zur Devin-Sitzung in der Web-App, sodass Sie die Arbeit dort mitverfolgen oder selbst übernehmen können.
• Devins Nachrichten: Devins Antworten bleiben als formatierte Antworten mit anklickbaren Links auf der Karte erhalten.
• Fragen: Wenn Devin eine Rückmeldung von Ihnen benötigt, zeigt die Karte die Frage an. Antworten Sie über den Aufgaben-Chat im Jira-Agent-Panel; Ihre Antwort geht an dieselbe Devin-Sitzung.
• Abbrechen: Wenn Sie die Aufgabe in Jira abbrechen, wird Devin gestoppt und die Sitzung in den Ruhezustand versetzt.

Nur der Jira-Nutzer, der eine Devin-Aufgabe gestartet hat, kann ihr aus Jira heraus Nachrichten senden oder sie abbrechen. Wenn Devin einen Vorgang nicht annehmen kann, nennt die Karte den Grund – zum Beispiel, dass die Jira-Site noch nicht mit einem Devin-Konto verknüpft ist, Ihr Atlassian-Konto keinem Devin-Nutzer zugeordnet werden konnte oder die Organisation bzw. Ihr Nutzer derzeit keine weiteren Agent Compute Units (ACUs) verbrauchen kann. Beheben Sie die Ursache und weisen Sie den Vorgang anschließend erneut Devin zu.

​

Pull-Request-Links

Devins Antworten im Jira-Agent-Panel enthalten Links zu Pull-Requests. Alle Pull-Requests, die Devin geöffnet, aber nicht erwähnt hat, werden am Ende der Antwort unter Pull requests aufgeführt. Bei Sitzungen, die durch eine @mention gestartet wurden, wird Devins letzte Nachricht außerdem als Kommentar im Work Item veröffentlicht. Den Pull-Request-Link enthält dieser Kommentar nur, wenn Devin ihn selbst eingefügt hat.

​

Option 2: Service-Benutzer in Jira

Bei dieser Option verbindet sich Devin per OAuth mit Ihrer Jira-Site und agiert über ein Jira-Dienstkonto. In Jira wird nichts installiert: Ein Jira-Admin autorisiert Devin in den Einstellungen von Devin, und Sie erstellen in Atlassian ein Dienstkonto, das als Devins Identität in Jira dient – also der Nutzer, dem Sie Arbeitseinträge zuweisen und der als Autor von Devins Kommentaren erscheint. Verwenden Sie diese Option, wenn Rovo in Ihrem Jira-Workspace deaktiviert ist.

​

Setup

​

1. Mit einem Administratorkonto verbinden

1. Gehe in Devin zu Settings > Connections > Jira, klicke auf Connect account und wähle Connect with an admin account.
2. Melde dich bei Atlassian als Jira-Administrator an und erteile den Zugriff. Über dieses Konto registriert Devin seine Webhooks auf der Site.

Solange du kein Dienstkonto hinzugefügt hast, werden Devins Kommentare unter dem Administratorkonto gepostet, mit dem Jira verbunden wurde, und Arbeitseinträge können Devin nicht zugewiesen werden.

​

2. Dienstkonto hinzufügen

1. Konfigurieren Sie ein Atlassian-Dienstkonto mit OAuth-2.0-Anmeldedaten und den folgenden Geltungsbereichen:
   • read:me
   • read:jira-user
   • read:jira-work
   • write:jira-work
2. Erteilen Sie dem Dienstkonto Zugriff auf die Jira-Anwendung sowie die Berechtigung, die relevanten Projekte zu durchsuchen, Kommentare hinzuzufügen, eigene Kommentare zu bearbeiten und zu löschen sowie Vorgänge zu verknüpfen. Devin prüft die Anmeldedaten beim Speichern und meldet fehlende Berechtigungen.
3. Öffnen Sie unter Settings > Connections > Jira das Menü der Verbindung, wählen Sie Add service-account credentials und geben Sie die Client-ID und das Client-Secret ein.

Anschließend erscheinen Devins Kommentare unter dem Dienstkonto, und sobald Sie dem Dienstkonto ein Arbeitselement zuweisen, startet eine Sitzung. Wenn Sie die Anmeldedaten ersetzen oder entfernen, bleiben Ihre Webhooks erhalten. Devin postet normalerweise über das konfigurierte Dienstkonto. Lässt sich dessen Zugriffstoken nicht abrufen, kann Devin auf das OAuth-Token des Admins zurückgreifen, der Jira verbunden hat. Kommentare erscheinen dann möglicherweise unter dem Namen dieses Admins.

​

3. Automatisierung erstellen

Um Devin automatisch über Work-Item-Events zu starten, erstellen Sie eine Devin-Automatisierung mit einem Jira-Auslöser – siehe Devin-Automatisierungen.

​

Auslöser

Um Devin automatisch zu starten, wenn Arbeitselemente erstellt oder geändert werden, verwenden Sie Devin-Automatisierungen. Sie können Devin auch manuell für ein Arbeitselement starten:

• Weisen Sie das Arbeitselement dem Dienstkonto zu. Devin startet eine Sitzung für das Arbeitselement. Erfordert ein Dienstkonto.
• Fügen Sie das Label devin hinzu. Wenn Sie das Label einem vorhandenen Arbeitselement hinzufügen, erfolgt der Abgleich ohne Berücksichtigung der Groß-/Kleinschreibung und auf ganze Wörter: Devin, devin-workshop und devin-task lösen Devin aus, devinworkshop und devin_workshop hingegen nicht. Wird ein Arbeitselement mit bereits gesetzten Labels erstellt, greift der Label-Auslöser nur bei einem Label, das exakt devin lautet (unabhängig von der Groß-/Kleinschreibung); devin-workshop zählt nicht.
• Erwähnen Sie das Dienstkonto per @mention in einem Kommentar. Devin startet eine Sitzung für das Arbeitselement und hängt Ihren Kommentartext an die Aufgabe an. Hat Devin bereits eine aktive Sitzung für das Arbeitselement, wird Ihr Kommentar an diese Sitzung weitergeleitet, statt eine neue zu starten.

Solange Devin eine Sitzung für ein Arbeitselement hat, werden neue Zuweisungen und Labels für dieses Arbeitselement ignoriert, und @mentions gehen an diese Sitzung. Diese Verknüpfung besteht 30 Tage lang oder bis bei einer @mention festgestellt wird, dass die Sitzung beendet oder mit einem Fehler abgebrochen wurde.

​

Unter welchem Nutzer die Sitzung ausgeführt wird

Devin ordnet den Jira-Nutzer, der die Sitzung ausgelöst hat, einem Member des verbundenen Devin-Kontos zu:

1. Zunächst über ein verknüpftes Atlassian-Konto. Member können ihr Konto unter Settings > Connections > Atlassian verknüpfen, damit Devin Jira im Namen dieser Person lesen kann.
2. Andernfalls über die E-Mail-Adresse: Ein Jira-Nutzer, dessen E-Mail-Adresse mit genau einem Member des Kontos übereinstimmt, wird diesem zugeordnet, und die Zuordnung wird gespeichert.

Die Sitzung wird dann als der zugeordnete Devin-Nutzer ausgeführt – in dessen Sitzungsliste und mit dessen Berechtigungen. Wenn kein Member übereinstimmt oder der zugeordnete Member in der Organisation keine Devin-Sitzungen verwenden darf, wird die Sitzung stattdessen als gemeinsamer Devin-Jira-Bot-Nutzer ausgeführt. Kann Devin dem Work Item keine Organisation zuordnen, weist es in einem Kommentar darauf hin.

​

Kommentare und Pull-Request-Links

Wenn eine Sitzung startet, hinterlässt Devin den Kommentar „Devin is working on your request“ und fügt einen Link zur Sitzung hinzu. Sobald Devin einen Pull-Request erstellt, wird dessen URL als Remote-Link zum Vorgang hinzugefügt und zusammen mit dem Link zur Devin-Sitzung als Kommentar gepostet.

​

Voraussetzungen

Für beide Optionen:

• Jira Cloud. Devin for Jira ist eine Forge-App, und die OAuth-Verbindung nutzt Atlassian Cloud OAuth. Für beide ist daher eine Jira-Cloud-Site erforderlich. Für self-hosted Jira siehe Anbindung eines benutzerdefinierten Ticketsystems über die API.
• Einen Jira-Admin, der die App installiert oder die OAuth-Verbindung autorisiert, sowie einen Devin-Admin (jemand, der Integrationen für das Devin-Konto verwalten kann), der die Site verknüpft oder die Verbindung konfiguriert.
• Eine Jira-Site pro Devin-Konto. Eine Jira-Site kann jeweils nur mit einem Devin-Konto verknüpft sein und umgekehrt. Heben Sie die Verknüpfung der aktuellen Site auf, bevor Sie eine andere verknüpfen.
• Verbundene Repositorys, damit Devin Branches pushen und Pull-Requests öffnen kann. Devin kann Pull-Requests nur in Repositorys öffnen, auf die es Zugriff hat. Verbinden Sie daher zuerst Ihren Quellcode-Anbieter, zum Beispiel über die GitHub-Integration.

Für den Rovo-Agenten:

• Die App Devin for Jira, installiert über den Atlassian Marketplace, wobei die Agentenfunktionen von Jira Cloud im Workspace aktiviert sein müssen. Siehe Option 1.
• Einen Devin-Core-, Team- oder Enterprise-Plan mit der Berechtigung, Integrationen zu verwalten, sowie der Berechtigung und ausreichendem Kontingent, um Sitzungen zu starten.
• Jede Person, die Devin auslöst, benötigt einen Devin-Nutzer. Devin ordnet den Jira-Nutzer anhand seines verknüpften Atlassian-Kontos oder seiner E-Mail-Adresse einem Member des verknüpften Devin-Kontos zu. Führt keines von beiden zu einer Übereinstimmung, kann die Person ihr Konto unter Settings > Connections > Atlassian verknüpfen. Andernfalls sollte ein Admin prüfen, ob die Person zum verknüpften Devin-Konto gehört und ihre verifizierte E-Mail-Adresse übereinstimmt. Arbeitseinträge von Jira-Nutzern, die nicht zugeordnet werden können, werden abgelehnt.
• Berechtigung zum Starten von Sitzungen. Der zugeordnete Devin-Nutzer muss in seiner Organisation Devin-Sitzungen verwenden dürfen. Gehört eine Person mehreren Organisationen an, verwendet Devin zunächst ihre Standard-Arbeitsorganisation. Diese legen Sie unter Settings > Preferences fest. Kann Devin keine Organisation auswählen, wird die Person gebeten, einen Standard festzulegen.

Für den Service-Benutzer:

• Ein Jira-Dienstkonto mit den Geltungsbereichen und dem Anwendungszugriff gemäß Dienstkonto hinzufügen, damit Arbeitseinträge Devin zugewiesen werden können und Devins Kommentare im Namen des Bots erscheinen.
• Ein Jira-Admin-Konto, um die Verbindung zu autorisieren. Wenn Sie es später erneut verbinden, wird die Autorisierung aktualisiert, ohne dass Anmeldedaten des Dienstkontos oder Webhooks verloren gehen.

​

Abrechnung

Sitzungen, die aus Jira gestartet werden, sind reguläre Devin-Sitzungen. Sie verbrauchen ACUs in der Devin-Organisation, in der sie ausgeführt werden – zum gleichen Satz wie Sitzungen, die über die Web-App oder eine andere Integration gestartet werden –, und werden auf die Nutzungslimits dieser Organisation angerechnet. Kann die Organisation keine neuen Sitzungen starten, weil sie ihr Nutzungslimit erreicht hat, lehnt Devin das Arbeitselement in Jira ab – beim Rovo-Agent auf dessen Karte, beim Service-Benutzer in einem Kommentar. Die Installation der App ist kostenlos. Die Nutzung von Devin wird über Ihren Devin-Plan abgerechnet. Devin verarbeitet Jira-Inhalte außerhalb von Atlassian.