Integration des Copilot Cloud-Agent mit Jira

Die GitHub Copilot Integration in Jira ermöglicht es Ihnen, aufzurufen Copilot-Cloud-Agent , ohne Ihren Jira-Arbeitsbereich zu verlassen. Direkt in Jira können Sie Cloud-Agent Sitzungen starten und Pull-Requests öffnen, wobei der Kontext des Titels, der Beschreibung, der Labels, der Kommentare und aller benutzerdefinierten Atlassian-Felder wie Akzeptanzkriterien genutzt wird.

Voraussetzungen

• Sie müssen ein GitHub-Konto haben, das über einen kostenpflichtigen Copilot-Plan Zugriff auf Copilot bietet.
• Sie müssen über ein Jira Cloud-Konto verfügen, Jira muss eine KI-fähige App sein, und Rovo muss für Ihre Organisation aktiviert werden. Siehe Aktivieren von KI für Apps in der Atlassian-Dokumentation.
• Die Installation und Authentifizierung muss sowohl für Jira als auch für GitHub abgeschlossen werden.

Installation

Um die GitHub Copilot für Jira-App zu installieren und sie für Ihr GitHub Organisations- oder Unternehmenskonto zu autorisieren, benötigen Sie Folgendes:

• Administratorberechtigung für Ihre Jira-Website.
• Besitzer- oder GitHub App-Manager-Berechtigungen für Ihre GitHub Organisation.

Diese Integration basiert auf einer Atlassian Forge-Anwendung und einer GitHub Anwendung. Beide sind für die Integration erforderlich. Nach der erfolgreichen Installation können autorisierte Benutzer des Jira-Arbeitsbereichs mit Schreibzugriff auf ein GitHub Repository den Agent von Jira auslösen.

Installation der GitHub Copilot-App für Jira für GitHub.com

1. Navigieren Sie zur GitHub Copilot Seite für Jira-Installation auf dem Atlassian Marketplace.

2. Klicken Sie auf "Jetzt abrufen".

3. Wählen Sie die Atlassian-Website aus, in der Sie die GitHub Anwendung installieren möchten.

4. Klicken Sie auf "Überprüfen ", um die Installationsdetails zu überprüfen, und klicken Sie dann auf " Jetzt abrufen".

   Sobald GitHub Copilot Jira auf Ihrer Jira-Website installiert ist, müssen Sie die App für den Zugriff auf Ihre GitHub Organisation und Repositorys autorisieren.

5. Klicken Sie auf "Konfigurieren" in der Bestätigungsmeldung in Jira nach der Installation.

   • Wenn Sie nicht automatisch weitergeleitet werden, gehen Sie zur GitHub CopilotJira-Installationsseite auf GitHub Marketplace. Klicke auf Installieren.

6. Wenn Sie noch nicht bei GitHub angemeldet sind, klicken Sie auf die hervorgehobene Option Bei GitHub anmelden und folgen Sie den Anweisungen, um sich bei Ihrem GitHub-Konto anzumelden und die Anwendung zu autorisieren.

   • Wenn Ihre Organisation oder Ihr Unternehmen einmaliges Anmelden (Single Sign-On, SSO) verwendet, müssen Sie möglicherweise eine aktive SAML-Sitzung für Ihre Organisation starten und einen zusätzlichen Autorisierungsschritt ausführen.

7. Klicken Sie auf "App installieren", um der App die Berechtigung zum Zugriff auf Informationen zu Ihrem GitHub Konto zu erteilen.

8. Wählen Sie die Organisation und Repositorys aus, auf die die App Zugriff hat. Ihre GitHub Organisationen sind standardmäßig für Ihren Jira-Arbeitsbereich aktiviert. Optional können Sie auf der Seite Installieren Sie GitHub Copilot für Jira die Organisation und die Repositories, auf die die Anwendung keinen Zugriff haben soll, abwählen.

9. Klicke auf Installieren.

10. Nach Abschluss der Installation wird eine Liste der verbundenen Organisationen auf der Seite für die GitHub Copilot Jira-App-Konfiguration in Jira angezeigt.

Installation der GitHub Copilot-App für Jira für GHE.com

1. Navigieren Sie zur Installationsseite für Jira (GHEC mit Data Residency) auf dem GitHub Copilot Atlassian Marketplace.

2. Klicken Sie rechts neben dem App-Namen auf , und geben Sie Ihr SUBDOMAIN.ghe.com in das Textfeld ein. Ersetzen Sie SUBDOMÄNE durch die Unterdomäne Ihres Unternehmens von GHE.com.

3. Klicke auf Konfiguration speichern.

4. Klicken Sie auf "Jetzt abrufen".

5. Wählen Sie die Atlassian-Website aus, in der Sie die GitHub Anwendung installieren möchten.

6. Klicken Sie auf "Überprüfen ", um die Installationsdetails zu überprüfen, und klicken Sie dann auf " Jetzt abrufen".

   Sobald GitHub Copilot Jira auf Ihrer Jira-Website installiert ist, müssen Sie die App für den Zugriff auf Ihre GitHub Organisation und Repositorys autorisieren.

7. Klicken Sie auf "Konfigurieren" in der Bestätigungsmeldung in Jira nach der Installation.

   • Wenn Sie nicht automatisch umgeleitet werden, suchen Sie die GitHub Copilot für Jira-App in der Liste der Apps, die für Ihr Unternehmen verfügbar sind.SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira Klicke auf Installieren.

8. Wenn Sie noch nicht bei GitHub angemeldet sind, klicken Sie auf das hervorgehobene Log-in bei GitHub und folgen Sie den Anweisungen, um sich bei Ihrem GitHub-Konto anzumelden und die Anwendung zu autorisieren.

   • Wenn Ihre Organisation oder Ihr Unternehmen SSO verwendet, müssen Sie möglicherweise eine aktive SAML-Sitzung für Ihre Organisation starten und einen zusätzlichen Autorisierungsschritt ausführen.

9. Klicken Sie auf "App installieren", um der App die Berechtigung zum Zugriff auf Informationen zu Ihrem GitHub Konto zu erteilen.

10. Wählen Sie die Organisation und Repositorys aus, auf die die App Zugriff hat. Ihre GitHub Organisationen sind standardmäßig für Ihren Jira-Arbeitsbereich aktiviert. Optional können Sie auf der Seite Install GitHub Copilot for Jira die Auswahl der Organisation und der Repositories aufheben, auf die die Anwendung keinen Zugriff haben soll.

11. Klicke auf Installieren.

12. Sobald die Installation abgeschlossen ist, wird auf der Konfigurationsseite der GitHub Copilot-für-Jira-App in Jira eine Liste der verbundenen Organisationen angezeigt.

Verwendung der GitHub Copilot-App in Jira

Die Copilot App muss für eine GitHub Organisation aktiviert sein, in der Sie Mitglied sind, bevor Sie mit der Verwendung beginnen können.

Wenn Sie zum ersten Mal Copilot-Cloud-Agent in Jira verwenden, müssen Sie ihn mit Ihrem GitHub-Konto verbinden.

Nur Benutzer mit Schreibzugriff auf ein Repository können Copilot-Cloud-Agent auslösen, um in diesem Repository zu arbeiten.

Sie können Copilot-Cloud-Agent auf verschiedene Arten auslösen:

• ZuweisenGitHub Copilot zu einem Arbeitselement mithilfe des Felds „Zugewiesene Person”.
• Erwähnen@GitHub Copilot in einem Kommentar zu einer Arbeitsaufgabe.
• Verwenden Sie eine Jira-Automatisierung. Wählen Sie in Ihren Jira-Automatisierungsregeln die Aktion "Verwenden GitHub Copilot " aus, und konfigurieren Sie Ihren Fluss, um einen benutzerdefinierten Trigger basierend auf Jira-Ereignissen zu verwenden, z. B. wenn eine Arbeitsaufgabe erstellt oder übergestellt wird, oder eine Bezeichnung angewendet wird. Weitere Informationen finden Sie unter Arbeiten mit KI-Agents in Jira in der Atlassian-Dokumentation.

Beispiel: Auslösen von Copilot-Cloud-Agent aus einem Jira-Arbeitselement

1. Öffnen oder erstellen Sie in Jira eine Arbeitsaufgabe, die klare Anforderungen enthält, an Copilot-Cloud-Agentdie Sie delegieren möchten.

2. Wenn Sie ein Repository angeben möchten, in dem Sie arbeiten möchten Copilot , erwähnen Sie es in der Beschreibung der Arbeitsaufgabe oder in einem Kommentar.

3. Weisen Sie GitHub Copilot dem Arbeitselement zu, oder erwähnen Sie @GitHub Copilot in einem Kommentar. Beispiel:

   @GitHub Copilot create a new API endpoint for user authentication in octo-org/octorepo
   

4. Wenn Sie die GitHub Anwendung in Jira noch nicht mit Ihrem GitHub Konto verbunden haben, folgen Sie den Anweisungen, um sowohl GitHub als auch Atlassian Berechtigungen zu erteilen.

5. Sobald Copilot-Cloud-Agent die Arbeit an der Pull-Anforderung begonnen hat, wird ein Kommentar im Chatbereich in Jira angezeigt. Der Benutzer, der die Agentsitzung initiiert hat, kann dort den Fortschritt anzeigen.

6. Sie können mit weiteren Anweisungen für Copilot fortfahren:

   • Verwenden Sie die Schaltfläche „Im Chat fortsetzen“ unter der Überschrift „Agents“, um direkt mit Copilot zu chatten und Änderungen am aktuellen Pull Request vornehmen zu lassen.
   • Erwähnen Sie @GitHub Copilot in einem Kommentar zu der Arbeitsaufgabe, dass Aktualisierungen in einer neuen Pullanforderung vorgenommen wurden.

Agentenaktivität in Jira anzeigen

Während Cloud-Agent seine Aktivitäts-Streams live in den Chatbereich in Jira einspeist, können Sie verfolgen, was der Agent tut, ohne Ihr Arbeitselement zu verlassen. Der Aktivitätsstream enthält einen Link zur zugehörigen Agent-Sitzung auf GitHub.

Copilot Regie von Jira nach der Sitzung

Wenn Copilot-Cloud-Agent eine Sitzung abgeschlossen hat, z. B. wenn ein Pull Request zur Prüfung bereit ist, können Sie Copilot anweisen, die Arbeit fortzusetzen:

• Wählen Sie im Chatbereich in Jira den Link zur zugehörigen Agent-Sitzung auf GitHub. Dadurch wird der Agentbereich geöffnet, in GitHubdem Sie die Sitzung überprüfen und Nachverfolgungsanweisungen senden können, um die vorhandene Pullanforderung zu aktualisieren.
• Fügen Sie eine anschließende Erwähnung @GitHub Copilot oder einen Kommentar zum Jira-Arbeitselement hinzu. Dadurch wird eine neue Sitzung gestartet und eine neue Pullanforderung geöffnet, anstatt die vorhandene zu aktualisieren.

Personalisierung von Copilot-Cloud-Agent in Jira

Sie können anpassen, wie Copilot-Cloud-Agent in Ihrem Jira-Arbeitsbereich funktioniert, indem Sie Modelle, Agenten und benutzerdefinierte Anweisungen angeben.

Angeben eines Modells

Geben Sie ein Modell an, wenn eine Aufgabe auf einem bestimmten Modell anstelle der Standardversion ausgeführt werden soll. Sie können zum Beispiel für routinemäßige, klar abgegrenzte Änderungen ein leichteres Modell wählen. Wenn Sie das für eine bestimmte Aufgabe verwendete Copilot-Cloud-Agent Modell ändern möchten, fügen Sie den Modellnamen in Ihre Anweisungen Copilotein, siehe Ändern des KI-Modells für GitHub Copilot Cloud-Agent.

Angeben eines benutzerdefinierten Agents

Geben Sie einen benutzerdefinierten Agent an, um das Verhalten eines bestimmten Workflows oder Repositorys anzupassen Cloud-Agent. Sie können einen benutzerdefinierten Agent aus Ihrem GitHub Repository direkt im Jira-Ticket angeben. Weitere Informationen findest du unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

Verwenden von benutzerdefinierten Anweisungen

Verwenden Sie benutzerdefinierte Anweisungen, um Standardeinstellungen festzulegen, die für jede Sitzung gelten, z. B. das Ziel-Repository, damit Copilot nicht mitten in der Sitzung anhalten und Sie um Eingaben bitten muss. Sie können benutzerdefinierte Instruktionen auf der Ebene des Jira-Arbeitsbereichs definieren, die jedes Mal angewendet werden, wenn Copilot-Cloud-Agent ausgelöst wird.

Nutzungskosten

Copilot-Cloud-Agent verwendet GitHub Actions Minuten und AI credits.

Weitere Informationen findest du unter Nutzungsbasierte Abrechnung für Organisationen und Unternehmen.

Hinzufügen oder Entfernen einer Organisation zur GitHub Copilot Jira-App

Ein Jira-Administrator und GitHub Organisationsbesitzer kann Organisationen für die Integration aktivieren oder deaktivieren.

So ändern Sie den Zugriff für die GitHub Copilot Jira-App für eine Organisation:

1. Wechseln Sie in Jira zur Seite "Einstellungen" für Ihren Arbeitsbereich.
2. Wechseln Sie zur Seite "Anwendungseinstellung" für die GitHub Copilot App.
3. Klicken Sie optional auf "Weitere GitHub Organisationen verbinden ", um der Liste neue Organisationen hinzuzufügen.
4. Aktivieren oder deaktivieren Sie die Copilot App für eine oder mehrere der aufgeführten Organisationen.

Problembehandlung

Wenn Probleme auftreten, probieren Sie die folgenden Lösungen aus.

Sie können das Copilot-Cloud-Agent Element nicht sehen, und es ist nicht möglich, es einer Jira-Arbeitsaufgabe zuzuweisen.

Stellen Sie sicher, dass Ihre Atlassian-Administratoreinstellungen in Jira wie folgt für Ihre Organisation festgelegt sind.

1. Jira ist eine KI-fähige App, siehe Aktivieren von KI für Apps in der Atlassian-Dokumentation.

Sie können das Copilot-Cloud-Agent Element sehen, aber es ist nicht möglich, es einem Jira-Arbeitselement zuzuweisen.

Überprüfen Sie, ob Sie Ihr persönliches Konto mit GitHub der GitHub Copilot Jira-App verbunden haben.

1. Wechseln Sie in Jira zur Seite "Einstellungen" für Ihr persönliches Konto.
2. Wählen Sie unter Ihren allgemeinen Einstellungen die GitHub Copilot Jira-App aus.
3. Wenn Sie noch nicht mit GitHub angemeldet sind, folgen Sie den Anweisungen zur Anmeldung und Autorisierung der Anwendung.

Wenn Sie mit GitHub Copilotchatten, werden Sie aufgefordert, sich anzumelden.

Wenn Sie sich bei der Jira-App anmelden möchten GitHub Copilot , führen Sie die oben aufgeführten Schritte aus. Sie können dies Copilot-Cloud-Agent sehen, aber es ist nicht möglich, sie einem Jira-Arbeitselement zuzuweisen.

Andere Benutzer in Ihrem Arbeitsbereich können Copilot-Cloud-Agent einem Jira-Arbeitselement zuweisen, Sie selbst können dies jedoch nicht.

Wenn Copilot-Cloud-Agent die Ressourcen Ihrer Organisation in Jira nicht sehen oder damit arbeiten kann und Ihre Organisation SSO in GitHub verwendet, müssen Sie die App GitHub Copilot for Jira für Ihr GitHub-Konto möglicherweise erneut autorisieren. Weitere Informationen findest du unter Informationen zur Authentifizierung mit einmaligem Anmelden.

Um dieses Problem zu beheben, führen Sie die folgenden Schritte aus, um eine neue aktive SSO-Sitzung für Ihre Organisation zu starten:

1. Wechseln Sie zu den Organisationseinstellungen in GitHub.
2. Suchen Sie unter "Einmaliges Anmelden" die Organisation, bei der Sie sich authentifizieren müssen, und klicken Sie auf "Abmelden", und melden Sie sich dann an.
   • Wenn Ihr Unternehmen SSO für Ihre Organisation verwaltet, funktioniert die Anmeldung bei einer Organisation im Unternehmen als SSO-Sitzung für alle Organisationen im Unternehmen.
3. Kehren Sie zu Jira zurück, und aktualisieren Sie die Seite, in der Sie arbeiten.
4. Versuchen Sie erneut, in Jira mit Copilot-Cloud-Agent zu arbeiten.

GitHub Copilot reagiert nicht

• Überprüfen Sie GitHubdie Statusseite auf etwaige aktive Vorfälle.
• Überprüfen Sie die Atlassian-Statusseite auf alle aktiven Vorfälle.
• Überprüfen Sie, ob Copilot-Cloud-Agent Zugriff auf das Repository hat, indem Sie testen, ob Sie ein Problem Copilot auf GitHub zuweisen können.
• Überprüfen Sie, ob die GitHub Copilot Jira-Anwendung Zugriff auf das Repository hat. Siehe Überprüfen und Ändern der installierten GitHub Apps.

Weiterführende Lektüre

• Informationen zu GitHub Copilot Cloud-Agent
• Verwalten des Zugriffs auf GitHub Copilot Cloud-Agent
• Konfigurieren von MCP-Servern für Ihr Repository
• Zusammenarbeiten an Arbeitsaufgaben mit KI-Agenten in der Atlassian-Dokumentation