Erste Schritte mit Copilot-Codeüberprüfung für Pull Requests

Azure DevOps Services

Verwenden Sie GitHub Copilot, um Pullanforderungen in Azure Repos zu überprüfen. Copilot fungiert als automatisierter Prüfer, der Kommentare und Vorschläge zu geändertem Code veröffentlicht, sodass Sie Feedback erhalten, bevor sich ein menschlichen Prüfer abmeldet.

Um die Funktion zu verwenden, aktiviert ein Administrator der Projektsammlung sie für die Organisation, ein Projektadministrator verwaltet Standardeinstellungen auf Projektebene und repositoryspezifische Überschreibungen, Repositoryadministratoren konfigurieren einzelne Repositorien, wenn Überschreibungen zulässig sind, und einzelne Benutzer aktivieren sie über die Vorschaufunktionen (es sei denn, der Administrator aktiviert die Vorschau für alle).

Voraussetzungen

Copilot-Codeüberprüfung aktivieren

Auf Organisationsebene

Ein Projectsammlungsadministrator muss die Copilot-Codeüberprüfung für die Organisation aktivieren, bevor Projektbesitzer sie für einzelne Projekte und Repositorien aktivieren können.

Wenn Sie die Option auf Organisationsebene "Alle aktivieren" auswählen, wird Copilot Codeüberprüfung für jedes Projekt in der Organisation und für jedes Repository in diesen Projekten aktiviert. Sie müssen nicht jedes Projekt oder Repository einzeln aktivieren.

1. Melden Sie sich bei Ihrer Azure DevOps-Organisation (https://dev.azure.com/{yourorganization}) an.

2. Wählen Sie Organization settings>Repos>Repositories aus.

3. Schalten Sie unter GitHub Copilot-Codeüberprüfung die Option Repositorys in dieser Organisation die Verwendung der Copilot-Codeüberprüfung erlauben auf Ein.

   

Auf Projektebene

Nachdem der Zugriff auf Organisationsebene aktiviert wurde, kann ein Project Administrator das Feature optional auf project-Ebene aktivieren. Diese Option bietet eine differenzierte Kontrolle darüber, welche Projekte in der Organisation Copilot Codeüberprüfung verwenden können.

Wenn Sie die Option auf Projektebene "Alle aktivieren" auswählen, ist Copilot Codeüberprüfung für jedes Repository in diesem Projekt aktiviert. Sie müssen nicht jedes Repository einzeln aktivieren.

1. Wählen Sie Project Einstellungen>Repos>Repositories aus.

2. Unter GitHub Copilot code review aktivieren Sie die Option Copilot-Codeüberprüfung für dieses Projekt aktivieren, indem Sie sie auf Ein setzen.

   

   Diese Einstellung gilt für alle Repositorys im Projekt, es sei denn, diese Einstellung wird auf Repositoryebene außer Kraft gesetzt. Sie können das Feature für einzelne Repositorys nach Bedarf weiterhin aktivieren oder deaktivieren.

Auf Repositoryebene

Nachdem Sie den Zugriff auf Organisationsebene (und optional den Zugriff auf Projektebene) aktiviert haben, aktiviert ein Repositorybesitzer Copilot Codeüberprüfung für jedes Repository, das es verwenden sollte.

1. Wählen Sie Project Einstellungen>Repos>Repositories aus.

2. Wählen Sie das Repository aus, das Sie aktivieren möchten.

3. Stellen Sie auf der Registerkarte Einstellungen die Option Copilot-Codeüberprüfungen für Pull Requests in diesem Repository aktivieren, auf Ein.

   

Um zu überprüfen, ob das Feature aktiviert ist, öffnen Sie alle Pull-Anforderungen im Repository. GitHub Copilot sollte jetzt als verfügbarer Prüfer in der Liste Reviewers angezeigt werden.

Copilot-Codeüberprüfung konfigurieren

Nachdem Sie die Funktion auf allen drei Ebenen aktiviert haben, können Sie konfigurieren, wie Copilot Pull Requests in Ihren Repositorys überprüft.

Konfigurieren des Standardüberprüfungsaufwands

Der Überprüfungsaufwand steuert, wie gründlich Copilot eine Pullanforderung analysiert. Ein Projektadministrator legt den Standardaufwand für alle Repositorys in einem Projekt fest und entscheidet, ob Repositoryadministratoren ihn überschreiben können. Benutzer können eine andere Leistungsstufe für eine einzelne Überprüfung auswählen, ohne den Projekt- oder Repositorystandard zu ändern.

Höhere Leistungsstufen verbrauchen im Allgemeinen mehr Token und können die Kosten einer Überprüfung erhöhen. Weitere Informationen finden Sie unter Abrechnung.

Projektstandard festlegen

1. Wählen Sie Project Einstellungen>Repos>Repositories aus.

2. Wählen Sie unter GitHub Copilot Codeüberprüfung eine Option aus der Standardaufwandsstufe aus.

3. Um Repositoryadministratoren eine andere Standardeinstellung festlegen zu lassen, wählen Sie "Einzelne Repositorys zulassen" aus, um ihre eigene Standardleistungsstufe festzulegen. Deaktivieren Sie diese Option, damit alle Repositorys den Projektstandard verwenden können.

   

Einen Standardwert für das Repository festlegen

Wenn das Projekt Repositoryüberschreibungen zulässt, kann ein Repositoryadministrator einen anderen Standardwert festlegen:

1. Wählen Sie Project Einstellungen>Repos>Repositories aus.
2. Wählen Sie das Repository und dann die Registerkarte "Einstellungen " aus.
3. Wählen Sie unter GitHub Copilot Codeüberprüfung eine Option aus der Standardaufwandsstufe aus.

Wenn das Projekt keine Repositoryüberschreibungen zulässt, ist die Standardaufwandsstufe schreibgeschützt und zeigt die geerbte Projekteinstellung an.

Einrichten von Richtlinien für die automatische Überprüfung

Copilot kann neue Pull Requests automatisch überprüfen, ohne dass dies manuell angefordert werden muss. Sie können diese Richtlinie für alle Repositorys in einem Projekt oder für einzelne Repositorys konfigurieren.

Featureaktivierung und automatische Überprüfung sind separate Einstellungen. Durch das Aktivieren der Copilot-Codeüberprüfung wird diese für ein Repository verfügbar. Eine Richtlinie zur automatischen Überprüfung fordert eine Copilot-Überprüfung an, wenn ein neuer Pull Request erstellt wird.

Konfigurieren der automatischen Überprüfung für alle Repositorys in einem Projekt

Verwenden Sie die Richtlinie auf Projektebene, um automatisch Copilot-Reviews für jedes Repository im Projekt anzufordern. Sie müssen die Richtlinie für jedes Repository nicht einzeln konfigurieren.

1. Wählen Sie Project Einstellungen>Repos>Repositories aus.

2. Setzen Sie unter GitHub Copilot-CodeüberprüfungAutomatisches Anfordern von Copilot-Codeüberprüfungen für neue Pull Requests für alle Repositorys in diesem Projekt auf Ein.

   Diese Einstellung gilt für alle Repositorys im Projekt, es sei denn, eine Richtlinie auf Repositoryebene überschreibt sie.

Konfigurieren der automatischen Überprüfung für ein Repository

Verwenden Sie die Richtlinie auf Repositoryebene, wenn Sie repositoryspezifisches Verhalten benötigen.

1. Wählen Sie Project Einstellungen>Repos>Repositories aus.

2. Wählen Sie das Repository aus, das Sie konfigurieren möchten.

3. Aktivieren Sie auf der Registerkarte Einstellungen unter GitHub Copilot Code Review die Option Copilot-Code-Review für neue Pull Requests automatisch anfordern, indem Sie sie auf Ein stellen.

4. (Optional) Überprüfungsbereich konfigurieren:

   • Gilt für alle Pullanforderungen: Copilot überprüft jede neue Pullanforderung im Repository.
   • Anwenden auf bestimmte Branchrichtlinien: Copilot überprüft nur Pull Requests, die auf angegebene Branches (z. B. main oder develop) abzielen.

   Richtlinienrang für automatische Überprüfungen:

   • Die Richtlinie für die automatische Überprüfung auf Projektebene gilt für alle Repositorys im Projekt.
   • Einstellungen für die automatische Überprüfung auf Repositoryebene setzen den Standardwert auf Projektebene für dieses Repository außer Kraft.

Wenn Sie die automatische Überprüfung aktivieren, beginnt Copilot mit der Überprüfung neuer Pullanforderungen sofort beim Erstellen. Sie können weitere Rezensionen weiterhin manuell anfordern, indem Sie "Anforderung" neben GitHub Copilot in der Pull-Anforderung auswählen.

Auswählen eines Agentpools

Copilot-Codeüberprüfung führt Überprüfungsaufträge mithilfe eines Azure Pipelines-Agent-Pools aus. Standardmäßig wird der Standardmäßige Azure Pipelines Pool in Ihrer Organisation verwendet.

Einige Organisationen deaktivieren den Standardpool Azure Pipelines. In dieser Konfiguration kann die Copilot-Codeüberprüfung erst ausgeführt werden, wenn Sie einen anderen unterstützten Pool auswählen.

Wenn Ihre Organisation einen verwalteten DevOps-Pool konfiguriert hat, können Sie ihn auswählen, um Copilot Codeüberprüfung anstelle des Standardpools auszuführen.

Wenn Sie ein Image für Managed DevOps Pool auswählen, stellen Sie sicher, dass Sie die neueste Ubuntu Server auswählen.

Windows Bilder werden für Copilot Codeüberprüfungen nicht unterstützt. Mischen Sie Ihren Pool nicht mit Ubuntu und Windows Agents.

1. Wählen Sie Organization settings>Repos>Repositories aus.

2. Wählen Sie unter GitHub Copilot Codeüberprüfung im Dropdownmenü "Computepool" aus.

   Die Computepoolkonfiguration Ihrer Organisation bestimmt die verfügbaren Pools. Wenn keine Pools verfügbar sind, wenden Sie sich an den Organisationsadministrator.

3. Wählen Sie "Speichern" aus.

Der ausgewählte Pool verarbeitet alle Copilot-Codeüberprüfungen für Repositorien in Ihrer Organisation. Sie können diese Einstellung jederzeit ändern. Um unterschiedliche Pools für verschiedene Projekte oder Repositorys zu verwenden, konfigurieren Sie Poolzuweisungen über verwaltete DevOps-Pools.

Copilots Prüfverhalten anpassen

Informationen zur Verwendung benutzerdefinierter Anweisungen und von Agent-Fähigkeiten, um das Feedback von Copilot zur Codeüberprüfung anzupassen, finden Sie unter Anweisungen für die Copilot-Codeüberprüfung konfigurieren.

Copilot-Codeüberprüfung verwenden

Wenn das Feature in allen drei Bereichen aktiviert ist, können Sie Copilot bitten, eine Pullanforderung zu überprüfen. In den folgenden Abschnitten wird beschrieben, was Sie erwarten müssen.

Anfordern einer Überprüfung

Standardmäßig überprüft GitHub Copilot einen Pull Request nur, wenn Sie darum bitten:

1. Öffnen eines Pull Requests.

2. Verwenden Sie im Abschnitt "Prüfer" eine der folgenden Optionen neben GitHub Copilot:

   • Um die Standard-Leistungsstufe des Repositorys zu verwenden, wählen Sie "Anforderung" aus.
   • Um eine andere Leistungsstufe für diese Überprüfung zu verwenden, öffnen Sie das Dropdownmenü neben "Anfordern ", und wählen Sie eine Leistungsstufe aus.

3. Warten Sie, bis die Überprüfung abgeschlossen ist. Die Überprüfung kann je nach Größe des Repositorys und der Anzahl der Änderungen in der Pullanforderung einige Minuten dauern. Nach Abschluss der Überprüfung ändert sich der Status in "Überprüfen abgeschlossen".

   

Wenn Copilot potenzielle Probleme identifiziert, werden kommentare und Vorschläge direkt zur Pullanforderung hinzugefügt, die Sie untersuchen und adressieren können.

Die ausgewählte Leistungsstufe gilt nur für diese Überprüfung. Azure DevOps zeichnet den Anforderer und die Aufwandsstufe in der Aktivität der Pullanforderung auf.

Lesen der Kommentare von Copilot

• Copilot hinterlässt sein Feedback als normaler Reviewer namens GitHub Copilot im Pull Request.
• Jeder Kommentar wird in der Codezeile angezeigt, auf die er angewendet wird, und enthält, sofern möglich, eine vorgeschlagene Änderung, die Sie mit nur einem Klick anwenden können.
• Copilot hinterlässt immer einen Comment Review. Sie genehmigt weder den Pull Request noch fordert sie Änderungen an, sodass ihre Überprüfung die Regeln für erforderliche Reviewer nicht erfüllt und das Mergen nicht blockiert.
• Copilots Kommentare verhalten sich wie die Kommentare eines menschlichen Prüfers. Sie können auf sie antworten, auf sie reagieren, sie auflösen oder ausblenden. Copilot liest keine Antworten und fasst nicht nach.

Nach neuen Commits erneut überprüfen

Copilot überprüft einen Pull Request nicht automatisch erneut, wenn Sie neue Commits pushen. Um eine neue Überprüfung nach einem Commit zu erhalten, wählen Sie Request erneut neben GitHub Copilot in der Liste Reviewers aus.

Abbrechen einer laufenden Überprüfung

Wenn eine Codeüberprüfung länger als erwartet dauert oder Sie sie beenden müssen, können Sie die Überprüfungsausführung abbrechen.

1. Öffnen Sie den Pull Request, den Copilot derzeit überprüft.
2. Wählen Sie im Abschnitt „Reviewer“ neben GitHub Copilot die Schaltfläche „Abbrechen“ aus (oder wählen Sie „Weitere Optionen“>„Überprüfung abbrechen“).
3. Bestätigen Sie die Stornierung, wenn Sie dazu aufgefordert werden.

Die Überprüfungsausführung wird sofort beendet, und es werden keine weiteren Kommentare hinzugefügt. Die teilweisen Prüfergebnisse, einschließlich der vor dem Abbruch hinzugefügten Kommentare, bleiben im Pull Request erhalten. Sie können jederzeit eine neue Überprüfung anfordern.

Anforderungen und Grenzwerte

Die folgenden Anforderungen und Grenzwerte gelten während der Vorschau und können sich ändern.

Copilot überprüft eine Pullanforderung nur, wenn sie diese Anforderungen erfüllt:

Diese Parallelitäts- und Zinsgrenzwerte gelten auch:

Abrechnung

Jede abgeschlossene Codeüberprüfung verwendet Token, einschließlich Eingabetoken, die Sie an das Modell senden, Ausgabetoken, die das Modell generiert, und zwischengespeicherte Token, die vorhandenen Kontext wiederverwenden. Token, die für jede Überprüfung verwendet werden, werden in eine Standardabrechnungseinheit namens GitHub KI-Gutschrift umgewandelt, wobei 1 Gutschrift 0,01 USD entspricht.

Der ausgewählte Überprüfungsaufwand wirkt sich auf den Verbrauch aus. Höhere Leistungsstufen analysieren im Allgemeinen mehr Kontext und verbrauchen mehr Token als niedrigere Aufwandsstufen. Die Größe des Pull Requests, benutzerdefinierte Anweisungen für das Repository und Modelländerungen können sich ebenfalls auf den Verbrauch auswirken. Informationen zu aktuellen Referenzbereichen und Einschränkungen finden Sie unter "Geschätzter Verbrauch".

Antworten auf häufig gestellte Fragen zur Abrechnung und zu den Kosten der Copilot-Codeüberprüfung finden Sie unter Problembehandlung für die Copilot-Codeüberprüfung.

Gebühren gehen zum Azure-Abonnement, das mit Ihrer Azure DevOps Organisation verknüpft ist, und werden in Azure Cost Management als separater Zähler angezeigt. Um die erwarteten Kosten in Ihrer Umgebung zu schätzen, aktivieren Sie das Feature für ein oder zwei Repositorys, vergleichen Sie die Leistungsstufen, und überwachen Sie die tägliche Nutzung.

Die Gebühren für Copilot-Codeüberprüfungen in Azure Cost Management umfassen jetzt auch Azure DevOps-Projekttags, sodass eine projektbezogene Kostenberichterstattung möglich ist. Sie können die Kostenanalyse nach diesen Projekt-Tags filtern oder gruppieren, um die Nutzung und die Ausgaben einzelnen Azure-DevOps-Projekten zuzuordnen.

So überwachen Sie Ihre täglichen Gebühren:

1. Wechseln Sie im Azure-Portal zu Ihrem Abonnement.

2. Wählen Sie Kostenverwaltung>Kostenanalyse aus.

3. Filtern Sie nach Produkt, um die täglichen Kosten der Organisation anzuzeigen. Um Kosten für ein bestimmtes Projekt anzuzeigen, fügen Sie einen Filter oder eine Gruppe nach dem Azure DevOps Projekttag hinzu.

   

Budgetwarnung festlegen

Erstellen Sie ein Azure Budget, das Sie benachrichtigt, wenn die Ausgaben einen von Ihnen festgelegten Schwellenwert erreichen. Budgets dienen nur zur Benachrichtigung. Sie beenden keine Rezensionen oder ändern keine Ressourcen. Sie benötigen Besitzer-, Mitwirkender- oder Kostenverwaltungsmitwirkender-Zugriff auf das Abonnement, das mit Ihrer Azure-DevOps-Organisation verknüpft ist.

1. Öffnen Sie im Azure-Portal das Abonnement, das mit Ihrer Azure DevOps Organisation verknüpft ist.

2. Wählen Sie "Kostenverwaltungsbudgets>" und dann "Hinzufügen" aus.

3. Fügen Sie unter "Filter" einen Filter für "Produkt" hinzu, und wählen Sie GitHub Copilot für AzDO aus.

   

4. Wenn das Abonnement mit mehreren Azure DevOps Organisationen verknüpft ist, fügen Sie einen Filter für Tag hinzu, und wählen Sie die Organisationsnamentags aus, auf die die Warnung ausgerichtet werden soll. Wenn Projekttags vorhanden sind, können Sie auch nach Projekttag filtern oder gruppieren, um Budgetwarnungen auf Projektebene zu erstellen.

5. Geben Sie einen Budgetnamen ein, wählen Sie einen Zurücksetzungszeitraum und ein Ablaufdatum aus, legen Sie den Budgetbetrag fest, und wählen Sie dann "Weiter" aus.

6. Fügen Sie eine oder mehrere Warnschwellen als Prozentsatz des Budgets hinzu (z. B. 75 % und 90 %), setzen Sie Typ auf Ist oder Prognostiziert, und geben Sie die E-Mail-Adressen ein, die benachrichtigt werden sollen.

7. Wählen Sie "Erstellen" aus.

   

Wenn die Ausgaben einen Schwellenwert erreichen, sendet Azure innerhalb einer Stunde nach der nächsten Auswertung eine E-Mail. Um ausgelöste Warnungen zu prüfen, wählen Sie Kostenverwaltung>Kostenwarnungen. Damit Benachrichtigungs-E-Mails nicht in Ihrem Junk-Ordner landen, fügen Sie azure-noreply@microsoft.com zu Ihrer Liste sicherer Absender hinzu. Weitere Informationen finden Sie unter Erstellen und Verwalten von Budgets.

Copilot-Codeüberprüfung deaktivieren

Um die Copilot-Codeüberprüfung nicht mehr zu verwenden, stellen Sie den Schalter für den Bereich, den Sie deaktivieren möchten, auf Off:

• Für einen Nutzer: Deaktivieren Sie den Schalter „Vorschaufunktionen“ in Ihren Benutzereinstellungen.
• Für ein Repository: Deaktivieren Sie den Repository-Schalter in den Projekteinstellungen>Repos>Repositorien.
• Für die gesamte Organisation: Deaktivieren Sie den Schalter für die Organisation in Organisationseinstellungen>Repos>Repositorys. Mit dieser Aktion wird das Feature für alle Repositorys deaktiviert.

Feedback teilen

Wenn Sie Probleme melden oder Feedback zu dieser Vorschau teilen möchten, besuchen Sie die Azure DevOps Entwicklercommunity.

Fehlerbehebung für die Copilot-Codeüberprüfung

Antworten auf häufige Fragen zu Abrechnung, Datenverarbeitung, Compliance und zur Problembehandlung bei benutzerdefinierten Anweisungen finden Sie unter Problembehandlung bei der Copilot-Codeüberprüfung.

Nächster Schritt

Verwandte Inhalte

• Beheben von Problemen bei der Copilot-Codeüberprüfung
• Copilot-Anweisungen für die Codeüberprüfung konfigurieren
• Informationen zu GitHub Copilot Code Review
• Informationen zu Pull Requests
• Repositoryeinstellungen und -richtlinien