View a markdown version of this page

Ein Problem erstellen in CodeCatalyst - Amazon CodeCatalyst
Bewährte Methoden für Probleme, die Amazon Q zugewiesen wurden

Amazon CodeCatalyst ist nicht mehr offen für neue Kunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Wie migriert man von CodeCatalyst.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Ein Problem erstellen in CodeCatalyst

Entwicklungsteams erstellen Probleme, um ihre Arbeit nachzuverfolgen und zu verwalten. Sie können Probleme innerhalb eines Projekts auf der Grundlage Ihrer Bedürfnisse erstellen. Sie könnten beispielsweise ein Problem erstellen, um die Aktualisierung einer Variablen in Ihrem Code nachzuverfolgen. Sie können Probleme anderen Benutzern im Projekt 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 Ausgabe erstellen aus. Wählen Sie alternativ im Navigationsbereich Probleme aus.

  4. Wählen Sie Ausgabe erstellen aus.

    Anmerkung

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

  5. Geben Sie einen Titel für die Ausgabe 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 Schätzungseinstellung des Projekts auf Schätzungen ausblenden gesetzt ist, wird kein Schätzungsfeld angezeigt.

  8. (Optional) Fügen Sie dem Problem Aufgaben hinzu. Aufgaben können verwendet werden, um die Arbeit an einem Problem in kleinere Ziele 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 abgeschlossen markieren, indem Sie das Kontrollkästchen auswählen, oder sie neu anordnen, indem Sie die Aufgabe auswählen und von der linken Seite des Kästchens 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 Etikett hinzuzufügen, wählen Sie das Etikett 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 + Beauftragten 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, um Ihre Entwicklungsarbeit zu beschleunigen. Diese Funktion ist nur in der Region USA West (Oregon) verfügbar.

    Diese Funktion setzt voraus, dass generative KI-Funktionen für den Space 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 enthalten.

    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 es 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, das Sie erstellen möchten, und legen Sie einen Wert fest.

  12. Wählen Sie Ausgabe erstellen aus. In der unteren rechten Ecke wird eine Benachrichtigung angezeigt: Wenn das Problem erfolgreich erstellt wurde, erscheint eine Bestätigungsmeldung, 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 „Wiederholen“ 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 beim Erstellen und Arbeiten mit Issues, die Amazon Q zugewiesen sind

Wenn Sie Probleme erstellen, bleiben einige von ihnen manchmal bestehen. Die Ursachen dafür können komplex und variabel sein. Manchmal liegt es daran, dass nicht klar ist, wer daran arbeiten soll. In anderen Fällen erfordert das Problem Recherchen oder Fachwissen zu einem bestimmten Teil der Codebasis, und die besten Kandidaten für die Arbeit sind mit anderen Problemen beschäftigt. Oft gibt es andere dringende Arbeiten, die zuerst erledigt werden müssen. Eine oder alle dieser Ursachen können zu Problemen führen, an denen nicht gearbeitet wurde. 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 Amazon Q das Problem zuweisen, wird versucht, einen Lösungsentwurf zu erstellen, den Sie evaluieren können. Dies kann Ihnen und Ihrem Team helfen, die Arbeit auf Probleme zu konzentrieren und zu optimieren, die Ihre Aufmerksamkeit erfordern, während Amazon Q an einer Lösung für Probleme arbeitet, für die Sie nicht über Ressourcen verfügen, um sie sofort zu lösen.

Anmerkung
Anmerkung

Bereitgestellt von Amazon Bedrock: AWS implementiert eine automatische Missbrauchserkennung. Da die Features Beschreibung für mich schreiben, Inhaltszusammenfassung erstellen, Aufgaben empfehlen, Features mit Amazon Q erstellen oder zu einem Projekt hinzufügen und Probleme Amazon Q zuweisen mit Amazon-Q-Developer-Agent für die Softwareentwicklung auf Amazon Bedrock basieren, können Benutzer die in Amazon Bedrock implementierten Steuerelemente in vollem Umfang nutzen, um die Sicherheit und den verantwortungsvollen Umgang mit künstlicher Intelligenz (KI) durchzusetzen.

Amazon Q schneidet bei einfachen und unkomplizierten Problemen am besten ab. Die besten Ergebnisse erzielen Sie, wenn Sie im Klartext erklären, was Sie tun möchten. Im Folgenden finden Sie einige bewährte Methoden, die Ihnen helfen sollen, Probleme zu erstellen, die für Amazon Q optimiert sind.

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 zu den genauen Änderungen bereitstellen können, die zur Behebung des Problems erforderlich sind, desto wahrscheinlicher ist es, dass Amazon Q in der Lage ist, eine Lösung zu finden, die das Problem löst. Wenn möglich, geben Sie spezifische Details an, z. B. den Namen der APIs, die Sie ändern möchten, Methoden, die Sie aktualisieren möchten, Tests, die geändert werden müssen, und alle anderen Details, die Ihnen einfallen.

  • Vergewissern Sie sich, dass Sie über alle im Titel und in der Beschreibung des Problems enthaltenen Informationen verfügen, bevor Sie es Amazon Q zuweisen. Sie können den Titel oder die Beschreibung eines Problems nicht mehr ä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 Ausgaben zu, für die Codeänderungen erforderlich sind, in einem einzigen Quell-Repository. Amazon Q kann nur an 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 für die Genehmigung der einzelnen Schritte die von Amazon Q vorgeschlagene Standardeinstellung. Standardmäßig benötigt Amazon Q für jeden einzelnen Schritt Ihre Zustimmung. Auf diese Weise können Sie mit Amazon Q in Kommentaren nicht nur zu dem Problem, sondern auch zu allen von Amazon Q erstellten Pull-Requests interagieren. Dies bietet eine interaktivere Erfahrung mit Amazon Q, mit der Sie den Ansatz anpassen und den Code, den es zur Lösung des Problems erstellt, verfeinern können.

    Anmerkung

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

  • Prüfen Sie den von Amazon Q vorgeschlagenen Ansatz stets sorgfältig. Sobald Sie den Ansatz genehmigt haben, beginnt Amazon Q mit der Generierung von Code, der auf diesem Ansatz basiert. Stellen Sie sicher, dass der Ansatz korrekt erscheint und alle Details enthält, die Sie erwarten, bevor Sie Amazon Q auffordern, fortzufahren.

  • Stellen Sie sicher, dass Amazon Q nur dann an Workflows arbeiten darf, wenn Sie noch keine Workflows haben, die diese bereitstellen könnten, bevor sie überprüft werden. In Ihrem Projekt sind möglicherweise Workflows so konfiguriert, dass sie Läufe bei Pull-Request-Ereignissen starten. Wenn ja, kann jeder von Amazon Q erstellte Pull Request, der das Erstellen oder Aktualisieren des Workflow-YAML beinhaltet, einen Lauf der im Pull Request enthaltenen Workflows starten. Es empfiehlt sich, Amazon Q nicht zu erlauben, an Workflow-Dateien zu arbeiten, es sei denn, Sie sind 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, um Ihre Entwicklungsarbeit zu beschleunigen und Verwaltung generativer KI-Funktionen.