Ein Problem erstellen in CodeCatalyst

Entwicklungsteams erstellen Probleme, um ihre Arbeit nachzuverfolgen und zu verwalten. Sie können je nach Bedarf Probleme innerhalb eines Projekts erstellen. Sie könnten beispielsweise ein Problem erstellen, um die Aktualisierung einer Variablen in Ihrem Code nachzuverfolgen. Sie können anderen Benutzern im Projekt Probleme zuweisen, Labels verwenden, um Ihre Arbeit nachzuverfolgen, und vieles mehr.

Folgen Sie diesen Anweisungen, um ein Problem in zu erstellen CodeCatalyst.

Um ein Problem zu erstellen

1. Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.

2. Navigieren Sie zu dem Projekt, in dem Sie ein Problem erstellen möchten.

3. Wählen Sie auf der Projekt-Startseite die Option Problem erstellen aus. Wählen Sie alternativ im Navigationsbereich Probleme aus.

4. Wählen Sie Problem erstellen aus.

   Anmerkung

   Sie können Probleme auch direkt hinzufügen, wenn Sie eine Rasteransicht verwenden.

5. Geben Sie einen Titel für das Problem ein.

6. (Optional) Geben Sie eine Beschreibung ein. Sie können Markdown verwenden, um Formatierungen hinzuzufügen.

7. (Optional) Wählen Sie einen Status, eine Priorität und eine Schätzung für das Problem aus.

   Anmerkung

   Wenn die Einstellung für die Schätzung des Projekts auf Schätzungen ausblenden gesetzt ist, wird kein Feld Schätzung angezeigt.

8. (Optional) Fügen Sie dem Problem Aufgaben hinzu. Aufgaben können verwendet werden, um die Arbeit an einer Ausgabe in kleinere Aufgaben zu unterteilen. Um eine Aufgabe hinzuzufügen, wählen Sie + Aufgaben hinzufügen. Geben Sie dann den Aufgabennamen in das Textfeld ein und drücken Sie die Eingabetaste. Nachdem Sie Aufgaben hinzugefügt haben, können Sie sie als erledigt markieren, indem Sie das Kontrollkästchen aktivieren, oder sie neu anordnen, indem Sie die Aufgabe auswählen und von der linken Seite der Checkbox ziehen.

9. (Optional) Fügen Sie ein vorhandenes Label hinzu oder erstellen Sie ein neues Label und fügen Sie es hinzu, indem Sie + Label hinzufügen wählen.

   1. Um ein vorhandenes Label hinzuzufügen, wählen Sie das Label aus der Liste aus. Sie können einen Suchbegriff in das Feld eingeben, um alle Labels im Projekt zu durchsuchen, die diesen Begriff enthalten.

   2. Um ein neues Label zu erstellen und es hinzuzufügen, geben Sie den Namen des Labels, das Sie erstellen möchten, in das Suchfeld ein und drücken Sie die Eingabetaste.

10. (Optional) Fügen Sie einen Beauftragten hinzu, indem Sie + Bevollmächtigten hinzufügen wählen. Sie können sich schnell selbst als Beauftragten hinzufügen, indem Sie + Mich hinzufügen wählen.

    Tipp

    Sie können Amazon Q ein Problem zuweisen, damit Amazon Q versucht, das Problem zu lösen. Weitere Informationen finden Sie unter Tutorial: Verwenden CodeCatalyst generativer KI-Funktionen zur Beschleunigung Ihrer Entwicklungsarbeit. Diese Funktion ist nur in der Region USA West (Oregon) verfügbar.

    Diese Funktionalität setzt voraus, dass generative KI-Funktionen für den Bereich aktiviert sind. Weitere Informationen finden Sie unter Generative KI-Funktionen verwalten.

11. (Optional) Fügen Sie ein vorhandenes benutzerdefiniertes Feld hinzu oder erstellen Sie ein neues benutzerdefiniertes Feld. Probleme können mehrere benutzerdefinierte Felder haben.

    1. Um ein vorhandenes benutzerdefiniertes Feld hinzuzufügen, wählen Sie das benutzerdefinierte Feld aus der Liste aus. Sie können einen Suchbegriff in das Feld eingeben, um alle benutzerdefinierten Felder im Projekt zu durchsuchen, die diesen Begriff enthalten.

    2. Um ein neues benutzerdefiniertes Feld zu erstellen und hinzuzufügen, geben Sie den Namen des benutzerdefinierten Felds, das Sie erstellen möchten, in das Suchfeld ein und drücken Sie die Eingabetaste. Wählen Sie dann den Typ des benutzerdefinierten Felds aus, das Sie erstellen möchten, und legen Sie einen Wert fest.

12. Wählen Sie „Problem erstellen“. In der unteren rechten Ecke wird eine Benachrichtigung angezeigt: Wenn das Problem erfolgreich erstellt wurde, wird eine Bestätigungsmeldung angezeigt, dass das Problem erfolgreich erstellt wurde. Wenn das Problem nicht erfolgreich erstellt wurde, wird eine Fehlermeldung mit dem Grund für den Fehler angezeigt. Sie können dann „Erneut versuchen“ wählen, um das Problem zu bearbeiten und erneut zu erstellen, oder „Verwerfen“ wählen, um das Problem zu verwerfen. Bei beiden Optionen wird die Benachrichtigung verworfen.

    Anmerkung

    Du kannst einen Pull-Request nicht mit einem Issue verknüpfen, wenn du ihn erstellst. Du kannst ihn jedoch bearbeiten, nachdem du ihn erstellt hast, um Links zu Pull Requests hinzuzufügen.

Bewährte Methoden bei der Erstellung und Bearbeitung von Problemen, die Amazon Q zugewiesen wurden

Wenn Sie Probleme erstellen, bleiben einige davon manchmal bestehen. Die Ursachen dafür können komplex und unterschiedlich sein. Manchmal liegt es daran, dass nicht klar ist, wer daran arbeiten soll. In anderen Fällen erfordert das Problem Recherchen oder Fachwissen in einem bestimmten Teil der Codebasis, und die besten Kandidaten für die Arbeit sind mit anderen Problemen beschäftigt. Oft gibt es andere dringende Aufgaben, die zuerst erledigt werden müssen. Eine oder alle dieser Ursachen können zu Problemen führen, an denen nicht gearbeitet wird. CodeCatalyst beinhaltet die Integration mit einem generativen KI-Assistenten namens Amazon Q, der ein Problem anhand seines Titels und seiner Beschreibung analysieren kann. Wenn Sie das Problem Amazon Q zuweisen, wird Amazon Q versuchen, einen Lösungsentwurf zu erstellen, den Sie bewerten können. Dies kann Ihnen und Ihrem Team helfen, sich auf Probleme zu konzentrieren und diese zu optimieren, während Amazon Q an einer Lösung für Probleme arbeitet, für die Sie keine Ressourcen haben, um sie sofort zu lösen.

Anmerkung

Anmerkung

Bereitgestellt von Amazon Bedrock: AWS implementiert automatisierte Missbrauchserkennung. Da die Funktionen Beschreibung für mich schreiben, Inhaltszusammenfassung erstellen, Aufgaben empfehlen, Funktionen mit Amazon Q erstellen oder zu einem Projekt hinzufügen und Amazon Q Probleme zuweisen mit dem Amazon Q Developer Agent für Softwareentwicklung auf Amazon Bedrock aufbauen, können Benutzer die in Amazon Bedrock implementierten Kontrollen voll ausnutzen, um Sicherheit und den verantwortungsvollen Umgang mit künstlicher Intelligenz (KI) zu gewährleisten.

Amazon Q schneidet bei einfachen und unkomplizierten Problemen am besten ab. Die besten Ergebnisse erzielen Sie, wenn Sie klar und deutlich erklären, was Sie tun möchten. Im Folgenden finden Sie einige bewährte Methoden, die Ihnen bei der Erstellung von Problemen helfen sollen, die für Amazon Q optimiert wurden.

Wichtig

Generative KI-Funktionen sind nur in der Region USA West (Oregon) verfügbar.

• Halte es einfach. Amazon Q eignet sich am besten für einfache Codeänderungen und Korrekturen, die im Titel und in der Beschreibung des Problems erklärt werden können. Weisen Sie Problemen keine vagen Titel oder übermäßig blumige oder widersprüchliche Beschreibungen zu.

• Seien Sie spezifisch. Je mehr Informationen Sie über die genauen Änderungen bereitstellen können, die zur Lösung des Problems erforderlich sind, desto wahrscheinlicher ist es, dass Amazon Q eine Lösung entwickeln kann, die das Problem löst. Geben Sie nach Möglichkeit spezifische Details an, z. B. den Namen, den APIs Sie ändern möchten, die Methoden, die Sie aktualisieren möchten, Tests, die geändert werden müssen, und alle anderen Details, die Ihnen einfallen.

• Stellen Sie sicher, dass Sie alle Details im Titel und in der Beschreibung des Problems enthalten haben, bevor Sie es Amazon Q zuweisen. Sie können den Titel oder die Beschreibung eines Problems nicht ändern, nachdem Sie es Amazon Q zugewiesen haben. Stellen Sie daher sicher, dass Sie über alle für ein Problem erforderlichen Informationen verfügen, bevor Sie es Amazon Q zuweisen.

• Weisen Sie nur Probleme, die Codeänderungen erfordern, in einem einzigen Quell-Repository zu. Amazon Q kann nur mit Code in einem einzigen Quell-Repository in arbeiten CodeCatalyst. Verknüpfte Repositorys werden nicht unterstützt. Stellen Sie sicher, dass für das Problem nur Änderungen in einem einzigen Quell-Repository erforderlich sind, bevor Sie das Problem Amazon Q zuweisen.

• Verwenden Sie die von Amazon Q vorgeschlagene Standardeinstellung, um jeden Schritt zu genehmigen. Standardmäßig benötigt Amazon Q für jeden Schritt Ihre Zustimmung. Auf diese Weise können Sie mit Amazon Q nicht nur in Kommentaren zu dem Problem, sondern auch zu allen Pull-Requests, die es erstellt, interagieren. Dies bietet ein interaktiveres Erlebnis mit Amazon Q, das Ihnen hilft, den Ansatz anzupassen und den Code zu verfeinern, der zur Lösung des Problems erstellt wird.

  Anmerkung

  Amazon Q reagiert nicht auf einzelne Kommentare zu Issues oder Pull Requests, überprüft sie jedoch, wenn es darum gebeten wird, seinen Ansatz zu überdenken oder eine Überarbeitung zu erstellen.

• Prüfen Sie den von Amazon Q vorgeschlagenen Ansatz immer sorgfältig. Sobald Sie den Ansatz genehmigt haben, beginnt Amazon Q mit der Generierung von Code, der auf diesem Ansatz basiert. Vergewissern Sie sich, dass der Ansatz korrekt erscheint und alle Informationen enthält, die Sie erwarten, bevor Sie Amazon Q anweisen, fortzufahren.

• Stellen Sie sicher, dass Amazon Q nur dann an Workflows arbeiten darf, wenn Sie nicht über bestehende Workflows verfügen, die diese möglicherweise bereitstellen, bevor sie überprüft wurden. In Ihrem Projekt sind möglicherweise Workflows so konfiguriert, dass sie Läufe bei Pull-Request-Ereignissen starten. Wenn ja, kann jede von Amazon Q erstellte Pull-Anfrage, die das Erstellen oder Aktualisieren von Workflows YAML beinhaltet, eine Ausführung der in der Pull-Anfrage enthaltenen Workflows starten. Als bewährte Methode sollten Sie Amazon Q nicht erlauben, an Workflow-Dateien zu arbeiten, es sei denn, Sie sind sich sicher, dass es in Ihrem Projekt keine Workflows gibt, die diese Workflows automatisch ausführen, bevor Sie den erstellten Pull-Request überprüfen und genehmigen.

Weitere Informationen finden Sie unter Tutorial: Verwenden CodeCatalyst generativer KI-Funktionen zur Beschleunigung Ihrer Entwicklungsarbeit und Generative KI-Funktionen verwalten.