Verwalten von Begründungen, Konfidenz und Genehmigungen bei Problemen

Rationale und Konfidenz benötigen keine zusätzliche Konfiguration. Wenn ein Automatisierung-Agent ein unterstütztes Issue-Attribut ändert, fügt er automatisch eine Begründung und ein Vertrauensniveau hinzu. Ob diese Änderung direkt angewendet wird oder auf die Überprüfung wartet, hängt von der Automatisierungsebene Ihres Repositorys oder von einer expliziten Anforderung zum Vorschlagen ab, anstatt die Änderung anzuwenden.

Festlegen der Automatisierungsebene Ihres Repositorys

Die Automatisierungsebene Ihres Repositorys legt den Konfidenzschwellenwert fest, mit dem jede unterstützte Änderung weitergeleitet wird. Änderungen, die unter dem Schwellenwert bewertet werden, werden als Vorschläge behandelt; Änderungen, die den Schwellenwert erreichen oder überschreiten, werden automatisch angewendet. Die Standardstufe ist vorsichtig, sodass nur vertrauenswürdige Änderungen automatisch angewendet werden, bis Sie sie ändern.

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicken Sie im Abschnitt "Planung" der Randleiste auf Agent-Vorschläge für Probleme.

4. Wählen Sie unter "Automatisierungsebene" die Ebene aus, die Ihrem Repository entspricht:

   • Vollständige Kontrolle: Jede Änderung wird zur Überprüfung zurückgehalten. Nichts wird automatisch angewendet.
   • Vorsichtig (Standard): Nur änderungen mit hoher Vertrauenswürdigkeit werden automatisch angewendet. Alles andere wird zur Überprüfung durch Sie zurückgehalten.
   • Ausgewogen: Routinemäßige, eindeutige Änderungen werden automatisch vorgenommen. Alles, was mehrdeutig ist, wird zur Prüfung zurückgehalten.
   • Vollständige Automatisierung: Jede Änderung wird automatisch angewendet. Der Agent hält nur eine Änderung zurück, wenn sie als unsicher gekennzeichnet ist.

5. Klicke auf Speichern.

Mit Copilot-Cloud-Agent

1. Erstellen Sie ein Automatisierung, das Issues gemäß Erstellen von Automatisierungen mit Copilot Cloud-Agent triagiert. Verwenden Sie den Trigger Wenn ein Vorgang erstellt wird, oder führen Sie Automatisierung nach Zeitplan aus.
2. Geben Sie dem Automatisierung die Issue-Tools für die Attribute, die geändert werden sollen, z. B. zum Aktualisieren von Labels, zum Setzen des Typs, zum Bearbeiten von Feldern, zum Zuweisen von Benutzern oder zum Schließen von Issues.
3. Beschreiben Sie in der Eingabeaufforderung die Triageaufgabe, z. B.: Triage this issue by setting a type, labels, and priority, and explain your reasoning for each. Sie müssen keine Rationale, Konfidenz oder Vorschläge explizit erwähnen. Um bestimmte Änderungen für die Überprüfung unabhängig von der Vertrauenswürdigkeit zu halten, bitten Sie den Agent, diese Änderungen vorzuschlagen, anstatt sie anzuwenden.
4. Speichern Sie das Automatisierung. Wenn es ausgeführt wird, sind seine Änderungen mit einer Begründung und einem Vertrauenswert versehen. Änderungen unterhalb der Automatisierungsstufe Ihres Repositorys sowie alle Änderungen, die der Agent auf Ihre Bitte hin vorschlagen soll, warten im Freigabebereich des Issues.

Mit GitHub agentenbasierte Workflows

Issue-Intents, also die Begründungs- und Konfidenzmetadaten, die den Issue-Änderungen eines Workflows zugeordnet sind, sind optional und standardmäßig aktiviert. Vorhandene Workflows funktionieren weiterhin ohne Änderungen.

1. Aktualisieren Sie die Erweiterung GitHub agentenbasierte Workflows auf die neueste Version, indem Sie gh aw upgrade ausführen.

2. Fügen Sie einen Workflow hinzu, der Probleme an das Verzeichnis .github/workflows Ihres Repositorys weiterleitet. Sie können mit einem Beispiel zur Issue-Triage beginnen oder ein eigenes erstellen. Weitere Informationen finden Sie in der GitHub agentenbasierte Workflows Dokumentation.

3. Geben Sie dem Workflow die Ausgaben für die Attribute, die der Workflow ändern soll, indem Sie sie im Frontmatter des Workflows unter safe-outputs auflisten. Zum Beispiel add-labels, um Labels zuzuweisen, set-issue-type, um den Vorgangstyp festzulegen, set-issue-field, um Felder zu bearbeiten, assign-to-user oder assign-to-agent, um Vorgänge zuzuweisen, und close-issue, um sie zu schließen. Das Hinzufügen dieser Ausgaben reicht für den Workflow aus, um die entsprechenden Problemänderungen mit einem Rationale- und Konfidenzniveau vorzunehmen.

4. Steuern Sie optional, ob für eine sichere Ausgabe Absichtsmetadaten erforderlich sind, indem Sie sie festlegen issue-intent :

   safe-outputs:
     add-labels:
       issue-intent: true
   

   • issue-intent weglassen oder nicht setzen, damit es optional bleibt: Der Agent soll nach Möglichkeit eine Begründung und einen Konfidenzwert angeben, aber die Ausgabe funktioniert auch ohne diese Angaben.
   • Legen Sie issue-intent: true so fest, dass für diese Ausgabe eine Begründung und ein Grad der Zuversicht erforderlich sind. Der Workflow schlägt fehl, wenn der Agent sie auslässt.
   • Setzen Sie issue-intent: false so, dass es vollständig deaktiviert ist: die Ausgabe enthält niemals Begründungen oder Metadaten zu Konfidenzwerten.

5. Beschreiben Sie in der Workflowaufforderung die Triageaufgabe. Um bestimmte Änderungen für die Überprüfung unabhängig von der Vertrauenswürdigkeit zu halten, bitten Sie den Agent, diese Änderungen vorzuschlagen, anstatt sie anzuwenden.

6. Kompilieren Sie den Workflow durch Ausführen von gh aw compile, und committen Sie dann die Workflowdatei und die generierte Lock-Datei.

7. Wenn der Workflow ausgeführt wird, enthalten seine Änderungen eine Begründung und eine Konfidenzstufe (es sei denn, Sie haben dies deaktiviert). Änderungen unterhalb der für Ihr Repository festgelegten Automatisierungsstufe sowie alle Änderungen, die der Agent vorgeschlagen hat, warten im Genehmigungsbereich des Issue.

Mit der REST- oder GraphQL-API

Wenn Sie statt der Verwendung eines Automatisierung eine eigene Integration erstellen, können Sie dieselben REST- und GraphQL-APIs zum Schreiben von Issues verwenden, um eine Begründung und ein Konfidenzniveau zusammen mit einer Änderung einzuschließen oder eine Änderung als Vorschlag zu kennzeichnen, damit sie zur Überprüfung zurückgehalten wird. Die Änderung wird auf dieselbe Weise verarbeitet wie eine Änderung aus einem Automatisierung- oder GitHub agentenbasierte Workflows-Workflow: je nach Automatisierungsgrad Ihres Repositorys automatisch oder, falls Sie sie als Vorschlag markiert haben, zur Prüfung zurückgehalten.

Probleme bei ausstehenden Vorschlägen finden

Um Issues zu finden, für die noch Vorschläge zur Überprüfung ausstehen, suchen Sie mithilfe des has:suggestions Qualifizierers, zum Beispiel is:issue is:open has:suggestions.

Überprüfen von Vorschlägen im Genehmigungsbereich

Wenn eine Änderung zur Überprüfung gehalten wird, wartet sie in einem Genehmigungsbereich auf das Problem, anstatt wirksam zu werden. Verwenden Sie das Panel, um jeden Vorschlag zu prüfen und zu entscheiden, was angewendet werden soll.

1. Öffnen Sie das Issue. Vorgeschlagene Änderungen werden im Genehmigungsbereich angezeigt.
2. Prüfen Sie jeden Vorschlag. Es zeigt die vorgeschlagene Änderung an, wie etwa ein Label, einen Typ, ein Feld, eine zuständige Person oder das Schließen, zusammen mit der Begründung und dem Konfidenzniveau.
3. Setzen Sie die Vorschläge um:
   • Wählen Sie "Annehmen" aus, um einen Vorschlag anzuwenden, oder "Ablehnen ", um ihn zu schließen.
   • Wählen Sie "Alle annehmen " oder "Alle ablehnen " aus, um auf jeden ausstehenden Vorschlag gleichzeitig zu reagieren.

Akzeptierte Änderungen wirken sich sofort auf das Problem aus. Abgelehnte Vorschläge werden verworfen, ohne das Problem zu ändern.

Sind Sie bereit, dies in die Praxis umzusetzen? Siehe Erstellen von Automatisierungen mit Copilot Cloud-Agent, um ein Automatisierung zu erstellen, das Probleme für Sie sortiert.