Tutorial: Utilizzo delle funzionalità di intelligenza artificiale CodeCatalyst generativa per velocizzare il lavoro di sviluppo - Amazon CodeCatalyst
PrerequisitiUtilizzo di Amazon Q per scegliere un blueprint durante la creazione di un progetto o l'aggiunta di funzionalitàAggiungi un riepilogo generato automaticamente durante la creazione di una pull requestCrea un riepilogo dei commenti lasciati sulle modifiche al codice in una pull requestCrea un problema e assegnalo ad Amazon QCrea un problema e chiedi ad Amazon Q di eseguire delle attività consigliate per risolverloPulizia delle risorse

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Tutorial: Utilizzo delle funzionalità di intelligenza artificiale CodeCatalyst generativa per velocizzare il lavoro di sviluppo

Se disponi di un progetto e di un archivio di sorgenti in Amazon CodeCatalyst in uno spazio in cui sono abilitate le funzionalità di intelligenza artificiale generativa, puoi utilizzare queste funzionalità per accelerare lo sviluppo del software. Gli sviluppatori hanno spesso più attività da svolgere che tempo per eseguirle. Spesso non si prendono il tempo di spiegare le modifiche apportate al codice ai colleghi quando creano richieste pull per la revisione di tali modifiche, aspettandosi che gli altri utenti trovino le modifiche da sole. Inoltre, i creatori e i revisori delle pull request non hanno il tempo di trovare e leggere attentamente tutti i commenti su una pull request, in particolare se la pull request ha più revisioni. CodeCatalyst si integra con Amazon Q Developer Agent per lo sviluppo di software per fornire funzionalità di intelligenza artificiale generativa che possono aiutare i membri del team a svolgere le proprie attività più rapidamente e aumentare il tempo a disposizione per concentrarsi sulle parti più importanti del loro lavoro.

Amazon Q Developer è un assistente conversazionale generativo basato sull'intelligenza artificiale che può aiutarti a comprendere, creare, estendere e utilizzare le applicazioni. AWS Per accelerare la tua crescita AWS, il modello alla base di Amazon Q è arricchito con AWS contenuti di alta qualità per produrre risposte più complete, utilizzabili e referenziate. Per ulteriori informazioni, consulta Cos'è Amazon Q Developer? nella Amazon Q Developer User Guide.

Nota

Realizzato da Amazon Bedrock: AWS implementa il rilevamento automatico degli abusi. Poiché le funzioni Scrivi descrizione per me, Crea un riepilogo dei contenuti, Consiglia attività, Usa Amazon Q per creare o aggiungere funzionalità a un progetto e Assegna problemi ad Amazon Q con Amazon Q Developer Agent per le funzionalità di sviluppo software sono basate su Amazon Bedrock, gli utenti possono sfruttare appieno i controlli implementati in Amazon Bedrock per rafforzare la sicurezza e l'uso responsabile dell'intelligenza artificiale (AI).

In questo tutorial, imparerai come utilizzare le funzionalità di intelligenza artificiale generativa CodeCatalyst per aiutarti a creare progetti con blueprint, oltre ad aggiungere blueprint a progetti esistenti. Inoltre, imparerai come riepilogare le modifiche tra i rami durante la creazione di richieste pull e riepilogare i commenti lasciati su una pull request. Imparerai anche a creare problemi con le tue idee per modifiche o miglioramenti al codice e ad assegnarle ad Amazon Q. Nell'ambito della gestione dei problemi assegnati ad Amazon Q, imparerai come consentire ad Amazon Q di suggerire attività e come assegnare e lavorare su qualsiasi attività creata nell'ambito della risoluzione di un problema.

Prerequisiti

Per utilizzare le CodeCatalyst funzionalità di questo tutorial, devi prima aver completato e avere accesso alle seguenti risorse:

  • Hai un AWS Builder ID o un'identità Single Sign-on (SSO) a cui accedere. CodeCatalyst

  • Ti trovi in uno spazio in cui sono abilitate le funzionalità di intelligenza artificiale generativa. Per ulteriori informazioni, consulta Gestione delle funzionalità di intelligenza artificiale generativa.

  • Hai il ruolo di collaboratore o amministratore di progetto in un progetto in quello spazio.

  • A meno che tu non stia creando un progetto con intelligenza artificiale generativa, per il tuo progetto esistente è configurato almeno un repository di sorgenti. Gli archivi collegati non sono supportati.

  • Quando si assegnano problemi a una soluzione iniziale creata dall'intelligenza artificiale generativa, il progetto non può essere configurato con l'estensione Jira Software. L'estensione non è supportata per questa funzionalità.

Per ulteriori informazioni, consulta Creare uno spazio, Tieni traccia e organizza il lavoro con problemi in CodeCatalyst, Aggiungi funzionalità ai progetti con estensioni in CodeCatalyst e Concessione dell'accesso con ruoli utente.

Questo tutorial si basa su un progetto creato utilizzando il modello di applicazione web Modern a tre livelli con Python. Se utilizzi un progetto creato con un progetto diverso, puoi comunque seguire i passaggi, ma alcune specifiche possono variare, come il codice e il linguaggio di esempio.

Utilizzo di Amazon Q per scegliere un blueprint durante la creazione di un progetto o l'aggiunta di funzionalità

In qualità di sviluppatore di progetti, puoi collaborare con Amazon Q, un assistente AI generativo, durante la creazione di nuovi progetti o l'aggiunta di componenti a progetti esistenti. Puoi fornire ad Amazon Q i requisiti per il tuo progetto interagendo con esso in un'interfaccia simile a una chat. In base ai tuoi requisiti, Amazon Q suggerisce un modello e delinea anche i requisiti che non possono essere soddisfatti. Se il tuo spazio dispone di progetti personalizzati, Amazon Q apprende e include tali progetti anche nei consigli. Puoi quindi procedere con il suggerimento di Amazon Q se sei soddisfatto e creerà le risorse necessarie, come un repository di sorgenti con codice per le tue esigenze. Amazon Q crea anche problemi per requisiti che non possono essere soddisfatti con un blueprint. Per ulteriori informazioni sui CodeCatalyst blueprint disponibili, consulta. Creazione di un progetto completo con CodeCatalyst progetti Per ulteriori informazioni sull'utilizzo di Amazon Q con i blueprint, consultaBest practice per l'utilizzo di Amazon Q per creare progetti o aggiungere funzionalità con blueprint.

Per creare un progetto con Amazon Q

  1. Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.

  2. Nella CodeCatalyst console, accedi allo spazio in cui desideri creare un blueprint.

  3. Nella dashboard dello spazio, scegli Crea con Amazon Q.

  4. Nel campo di immissione del testo del prompt di Amazon Q, fornisci istruzioni scrivendo una breve descrizione del progetto che desideri creare. Ad esempio, “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

    (Facoltativo) In Prova esempi, puoi utilizzare un prompt già scritto scegliendo un blueprint. Ad esempio, se scegli l'app React, viene fornito il seguente prompt: “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

  5. Scegli Invia per inviare le istruzioni ad Amazon Q. L'assistente generativo AI fornisce un suggerimento e delinea i requisiti che non possono essere soddisfatti dal modello. Ad esempio, Amazon Q potrebbe suggerire quanto segue in base ai tuoi criteri:

    I recommend using the Modern three-tier web application blueprint based on 
                    your requirements. Blueprints are dynamic and can always be updated and edited later.

Modern three-tier web application
By Amazon Web Services

This blueprint creates a Mythical Mysfits 3-tier web application with a modular presentation, application, and data layers. 
The application leverages containers, infrastructure as code (IaC), continuous integration and continuous delivery (CI/CD), 
and serverless code functions.

Version: 0.1.163

View details

The following requirements could not be met so I will create issues for you.
• Add authentication and authorization mechanisms for security and allowable actions.

  6. (Facoltativo) Per visualizzare i dettagli approfonditi del blueprint suggerito, scegli Visualizza dettagli.

  7. Esegui una di queste operazioni:

    1. Scegli Sì, usa questo blueprint se sei soddisfatto del suggerimento.

    2. Scegli Modifica richiesta se desideri modificare la richiesta.

    3. Scegli Ricomincia se desideri cancellare completamente il prompt.

  8. Esegui una di queste operazioni:

    1. Scegli Configura se desideri configurare il blueprint suggerito. Puoi anche configurare il blueprint in un secondo momento.

    2. Scegli Salta se al momento non desideri modificare le configurazioni del blueprint.

  9. Se hai scelto di configurare il blueprint, scegli Continua dopo aver modificato le risorse del progetto.

  10. Quando richiesto, inserisci il nome che desideri assegnare al progetto e i nomi delle risorse associate. Il nome deve essere univoco all'interno del tuo spazio.

  11. Scegli Crea progetto per creare un progetto con il blueprint. Amazon Q crea risorse utilizzando il blueprint. Ad esempio, se crei un progetto con il blueprint di un'applicazione a pagina singola, viene creato un repository di origine per il codice e i flussi di lavoro pertinenti per CI/CD.

  12. (Facoltativo) Per impostazione predefinita, Amazon Q crea anche problemi per i requisiti che non sono soddisfatti da un blueprint. Puoi scegliere per quali articoli non vuoi creare problemi. Dopo aver scelto di lasciare che Amazon Q crei problemi, puoi assegnare un problema anche ad Amazon Q. Analizzerà il problema nel contesto degli archivi di origine indicati, fornendo un riepilogo dei file e del codice sorgente pertinenti. Per ulteriori informazioni, consulta Individuazione e visualizzazione dei problemi, Crea un problema e assegnalo ad Amazon Q e Procedure consigliate per la creazione e l'utilizzo di problemi assegnati ad Amazon Q.

Dopo aver creato un progetto con Amazon Q, puoi anche utilizzare Amazon Q per aggiungere nuovi componenti in quanto suggerisce CodeCatalyst progetti in base alle tue esigenze.

Per aggiungere un blueprint con Amazon Q

  1. Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.

  2. Nella CodeCatalyst console, accedi al progetto a cui desideri aggiungere un blueprint.

  3. Scegli Aggiungi con Amazon Q.

  4. Nel campo di immissione del testo del prompt di Amazon Q, fornisci istruzioni scrivendo una breve descrizione del progetto che desideri creare. Ad esempio, “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

    (Facoltativo) In Prova esempi, puoi utilizzare un prompt già scritto scegliendo un blueprint. Ad esempio, se scegli l'app React, viene fornito il seguente prompt: “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

  5. Scegli Invia per inviare le istruzioni ad Amazon Q. L'assistente generativo AI fornisce un suggerimento e delinea i requisiti che non possono essere soddisfatti dal modello. Ad esempio, Amazon Q potrebbe suggerire quanto segue in base ai tuoi criteri:

    I recommend using the Single-page application blueprint based on your requirements. Blueprints are dynamic and can always be updated and edited later.

Single-page application
By Amazon Web Services

This blueprint creates a SPA (single-page application) using React, Vue, or Angular frameworks and deploys to AWS Amplify Hosting.

Version: 0.2.15
View details

The following requirements could not be met so I will create issues for you.
• The application should have reusable UI components
• The application should support for client-side routing
• The application may require server-side rendering for improved performance and SEO

  6. (Facoltativo) Per visualizzare i dettagli approfonditi del blueprint suggerito, scegli Visualizza dettagli.

  7. Esegui una di queste operazioni:

    1. Scegli Sì, usa questo blueprint se sei soddisfatto del suggerimento.

    2. Scegli Modifica richiesta se desideri modificare la richiesta.

    3. Scegli Ricomincia se desideri cancellare completamente il prompt.

  8. Esegui una di queste operazioni:

    1. Scegli Configura se desideri configurare il blueprint suggerito. Puoi anche configurare il blueprint in un secondo momento.

    2. Scegli Salta se al momento non desideri modificare le configurazioni del blueprint.

  9. Se hai scelto di configurare il blueprint, scegli Continua dopo aver modificato le risorse del progetto.

  10. Scegli Aggiungi al progetto per aggiungere risorse a un progetto con il blueprint. Amazon Q crea risorse utilizzando il blueprint. Ad esempio, se si aggiunge un progetto con il blueprint di un'applicazione a pagina singola, viene creato un repository di origine per il codice e i flussi di lavoro pertinenti per CI/CD.

  11. (Facoltativo) Per impostazione predefinita, Amazon Q crea anche problemi per i requisiti che non sono soddisfatti da un blueprint. Puoi scegliere per quali articoli non vuoi creare problemi. Dopo aver scelto di lasciare che Amazon Q crei problemi, puoi assegnare un problema anche ad Amazon Q. Analizzerà il problema nel contesto degli archivi di origine indicati, fornendo un riepilogo dei file e del codice sorgente pertinenti. Per ulteriori informazioni, consulta Crea un problema e assegnalo ad Amazon Q e Procedure consigliate per la creazione e l'utilizzo di problemi assegnati ad Amazon Q.

Crea un riepilogo delle modifiche al codice tra i rami durante la creazione di una pull request

Una pull request è il modo principale con cui tu e gli altri membri del progetto potete rivedere, commentare e unire le modifiche al codice da una filiale all'altra. Puoi utilizzare le pull request per esaminare le modifiche al codice in modo collaborativo per apportare modifiche o correzioni minori, aggiunte di funzionalità importanti o nuove versioni del software rilasciato. Riassumere le modifiche al codice e l'intento alla base delle modifiche come parte della descrizione della pull request è utile per gli altri utenti che esamineranno il codice e aiuta anche a comprendere lo storico delle modifiche apportate al codice nel tempo. Tuttavia, gli sviluppatori spesso si affidano al codice per spiegare se stesso o fornire dettagli ambigui anziché descrivere le modifiche con dettagli sufficienti per consentire ai revisori di capire cosa stanno esaminando o quale fosse l'intento alla base delle modifiche al codice.

Puoi utilizzare la funzione Write description for me durante la creazione di richieste pull per fare in modo che Amazon Q crei una descrizione delle modifiche contenute in una richiesta pull. Quando scegli questa opzione, Amazon Q analizza le differenze tra il ramo di origine che contiene le modifiche al codice e il ramo di destinazione in cui desideri unire queste modifiche. Quindi crea un riepilogo di quali sono tali modifiche, nonché la migliore interpretazione dell'intento e dell'effetto di tali modifiche.

Nota

Questa funzionalità non funziona con i sottomoduli Git. Non riassumerà alcuna modifica in un sottomodulo Git che fa parte della pull request.

Questa funzionalità non è disponibile per le richieste pull nei repository collegati.

Puoi provare questa funzionalità con qualsiasi pull request che crei, ma in questo tutorial la testeremo apportando alcune semplici modifiche al codice contenuto in un progetto creato in un modello di applicazione web Modern a tre livelli basato su Python.

Suggerimento

Se stai usando un progetto creato con un progetto diverso o con il tuo codice, puoi comunque seguire questo tutorial, ma gli esempi in questo tutorial non corrisponderanno al codice del tuo progetto. Invece dell'esempio suggerito di seguito, apporta semplici modifiche al codice del progetto in un ramo, quindi crea una pull request per testare la funzionalità, come mostrato nei passaggi seguenti.

Innanzitutto, creerai un ramo nel repository dei sorgenti. Quindi apporterai una rapida modifica al codice di un file in quel ramo utilizzando l'editor di testo nella console. Creerai quindi una pull request e utilizzerai la funzione Scrivi una descrizione per me per riepilogare le modifiche apportate.

Per creare un ramo (console)

  1. Nella CodeCatalyst console, accedi al progetto in cui risiede il tuo repository di origine.

  2. Scegli il nome del repository dall'elenco dei repository di origine per il progetto. In alternativa, nel riquadro di navigazione, scegli Codice, quindi scegli Archivi di origine.

  3. Scegli il repository in cui desideri creare un ramo.

  4. Nella pagina di panoramica del repository, scegli Altro, quindi scegli Crea ramo.

  5. Inserisci un nome per il ramo.

  6. Scegliete un ramo da cui creare il ramo, quindi scegliete Crea.

Una volta creato un ramo, modifica un file in quel ramo con una semplice modifica. In questo esempio, modificherai il test_endpoint.py file per cambiare il numero di tentativi per i test da 0 3 a 5.

Suggerimento

Puoi anche scegliere di creare o utilizzare un ambiente di sviluppo per apportare questa modifica al codice. Per ulteriori informazioni, consulta Creazione di un ambiente di sviluppo.

Per modificare il test_endpoint.py file nella console

  1. Nella pagina di panoramica del repository di mysfits origine, scegli il menu a discesa del ramo e scegli il ramo creato nella procedura precedente.

  2. In File, accedi al file che desideri modificare. Ad esempio, per modificare il test_endpoint.py file, espandi test, espandi integ e quindi sceglitest_endpoint.py.

  3. Scegli Modifica.

  4. Alla riga 7, modifica il numero di volte in cui verranno ripetuti tutti i test:

    def test_list_all(retry=3):

    to:

    def test_list_all(retry=5):

  5. Scegli Commit e invia le modifiche alla tua filiale.

Ora che hai una filiale con una modifica, puoi creare una pull request.

Crea una pull request con un riepilogo delle modifiche

  1. Nella pagina di panoramica del repository, scegli Altro, quindi scegli Crea richiesta pull.

  2. Nel ramo di destinazione, scegli il ramo in cui unire il codice dopo averlo esaminato.

    Suggerimento

    Scegli il ramo da cui hai creato il ramo nella procedura precedente per una dimostrazione più semplice di questa funzionalità. Ad esempio, se hai creato la filiale dal ramo predefinito del repository, scegli quel ramo come ramo di destinazione per la tua pull request.

  3. Nel ramo Source, scegli il ramo che contiene le modifiche che hai appena eseguito nel test_endpoint.py file.

  4. In Pull request title, inserisci un titolo che aiuti gli altri utenti a capire cosa deve essere esaminato e perché.

  5. In Pull request description, scegli Write description for me per fare in modo che Amazon Q crei una descrizione delle modifiche contenute nella pull request.

  6. Viene visualizzato un riepilogo delle modifiche. Controlla il testo suggerito, quindi scegli Accetta e aggiungi alla descrizione.

  7. Facoltativamente, modifica il riepilogo per riflettere meglio le modifiche apportate al codice. Puoi anche scegliere di aggiungere revisori o collegare i problemi a questa pull request. Quando hai finito di apportare le modifiche aggiuntive che desideri, scegli Crea.

Crea un riepilogo dei commenti lasciati sulle modifiche al codice in una pull request

Quando gli utenti esaminano una pull request, spesso lasciano più commenti sulle modifiche apportate a quella pull request. Se ci sono molti commenti da parte di molti revisori, può essere difficile individuare temi comuni nel feedback o addirittura assicurarsi di aver esaminato tutti i commenti in tutte le revisioni. Puoi utilizzare la funzione Crea riepilogo commenti per consentire ad Amazon Q di analizzare tutti i commenti lasciati sulle modifiche al codice in una pull request e creare un riepilogo di tali commenti.

Nota

I riepiloghi dei commenti sono temporanei. Se aggiorni una pull request, il riepilogo scomparirà. I riepiloghi dei contenuti non includono commenti sulla pull request complessiva, ma solo commenti lasciati sulle differenze di codice nelle revisioni della pull request.

Questa funzionalità non funziona con i commenti lasciati sulle modifiche al codice nei sottomoduli Git.

Questa funzionalità non è disponibile per le richieste pull nei repository collegati.

Per creare un riepilogo dei commenti in una pull request

  1. Passa alla pull request creata nella procedura precedente.

    Suggerimento

    Se preferisci, puoi utilizzare qualsiasi pull request aperta nel tuo progetto. Nella barra di navigazione, scegli Code, scegli Pull request e scegli una pull request aperta.

  2. Aggiungi alcuni commenti alla pull request in Modifiche se la pull request non contiene già commenti.

  3. In Panoramica, scegli Crea riepilogo dei commenti. Al termine, la sezione di riepilogo dei commenti si espande.

  4. Esamina il riepilogo dei commenti lasciati sulle modifiche al codice nelle revisioni della pull request e confrontalo con i commenti nella pull request.

Crea un problema e assegnalo ad Amazon Q

I team di sviluppo creano problemi per tracciare e gestire il proprio lavoro, ma a volte un problema persiste perché non è chiaro chi debba occuparsene, oppure il problema richiede una ricerca su una parte particolare della base di codice o perché è necessario prima occuparsi di altri lavori urgenti. CodeCatalyst include l'integrazione con Amazon Q Developer Agent per lo sviluppo di software. Puoi assegnare i problemi a un assistente AI generativo chiamato Amazon Q che può analizzare un problema in base al titolo e alla descrizione. Se assegni il problema ad Amazon Q, quest'ultima tenterà di creare una bozza di soluzione da valutare. Questo può aiutare te e il tuo team a concentrarti e ottimizzare il lavoro su questioni che richiedono la tua attenzione, mentre Amazon Q lavora a una soluzione per problemi che non hai risorse per risolvere immediatamente.

Suggerimento

Amazon Q offre le migliori prestazioni su problemi semplici e diretti. Per ottenere i migliori risultati, usa un linguaggio semplice per spiegare chiaramente cosa vuoi fare.

Quando assegni un problema ad Amazon Q, CodeCatalyst lo contrassegnerà come bloccato finché non confermerai come desideri che Amazon Q risolva il problema. È necessario rispondere a tre domande prima di continuare:

  • Sia che tu voglia confermare ogni passaggio necessario o che proceda senza feedback. Se scegli di confermare ogni passaggio, puoi rispondere ad Amazon Q con un feedback sull'approccio che ha creato, in modo che possa ripetere il suo approccio, se necessario. Amazon Q può anche esaminare il feedback che gli utenti lasciano su qualsiasi pull request creata se scegli questa opzione. Se scegli di non confermare ogni passaggio, Amazon Q potrebbe completare il lavoro più rapidamente, ma non esaminerà alcun feedback fornito nel problema o nelle pull request che crea.

  • Sia che tu voglia consentirgli di aggiornare i file del flusso di lavoro come parte del suo lavoro. Il tuo progetto potrebbe avere flussi di lavoro configurati per avviare esecuzioni in base a eventi di pull request. In tal caso, qualsiasi richiesta pull creata da Amazon Q che includa la creazione o l'aggiornamento del flusso di lavoro YAML potrebbe avviare un'esecuzione dei flussi di lavoro inclusi nella richiesta pull. Come best practice, non scegliere di consentire ad Amazon Q di lavorare su file di workflow a meno che tu non sia sicuro che nel tuo progetto non ci siano flussi di lavoro che eseguano automaticamente tali flussi di lavoro prima di rivedere e approvare la pull request creata.

  • Se vuoi consentirgli di suggerire la creazione di attività per suddividere il lavoro sul problema in incrementi più piccoli che possono essere assegnati individualmente agli utenti, incluso Amazon Q stesso. Consentire ad Amazon Q di suggerire e creare attività può aiutare ad accelerare lo sviluppo di problemi complessi, permettendo a più persone di lavorare su parti distinte del problema. Può anche aiutare a ridurre la complessità della comprensione dell'intero lavoro, poiché il lavoro necessario per completare ogni attività è idealmente più semplice del problema a cui appartiene.

  • In quale archivio sorgente vuoi che funzioni. Anche se il tuo progetto ha più repository di sorgenti, Amazon Q può lavorare solo sul codice in un unico repository di sorgenti. Gli archivi collegati non sono supportati.

Dopo aver effettuato e confermato le tue scelte, Amazon Q sposterà il problema nello stato In corso mentre tenta di determinare la richiesta in base al titolo del problema e alla sua descrizione, nonché al codice nel repository specificato. Creerà un commento aggiunto in cui fornirà aggiornamenti sullo stato del suo lavoro. Dopo aver esaminato i dati, Amazon Q formulerà un potenziale approccio a una soluzione. Amazon Q registra le sue azioni aggiornando il commento aggiunto e commentando lo stato di avanzamento del problema in ogni fase. A differenza dei commenti e delle risposte bloccati, non conserva una registrazione strettamente cronologica del suo lavoro. Piuttosto, inserisce le informazioni più rilevanti sul suo lavoro al primo livello del commento aggiunto. Tenterà di creare codice in base al suo approccio e alla sua analisi del codice già presente nel repository. Se genera con successo una potenziale soluzione, creerà un ramo e inserirà il codice in quel ramo. Quindi crea una pull request che unirà quel ramo con il ramo predefinito. Quando Amazon Q completa il suo lavoro, sposta il problema su In review in modo che tu e il tuo team sappiate che c'è un codice pronto per la valutazione.

Nota

Questa funzionalità è disponibile solo tramite Issues in the US West (Oregon) Region. Non è disponibile se hai configurato il progetto per utilizzare Jira con l'estensione Jira Software. Inoltre, se hai personalizzato il layout della scheda, il problema potrebbe non modificare lo stato. Per ottenere i migliori risultati, usa questa funzionalità solo con progetti con un layout di scheda standard.

Questa funzionalità non funziona con i sottomoduli Git. Non può apportare modifiche a nessun sottomodulo Git incluso nel repository.

Dopo aver assegnato un problema ad Amazon Q, non puoi modificare il titolo o la descrizione del problema o assegnarlo a nessun altro. Se annulli l'assegnazione di Amazon Q al problema, completerà la fase attuale e poi smetterà di funzionare. Una volta annullata l'assegnazione, non può riprendere a funzionare o essere riassegnato al problema.

Un problema può essere spostato automaticamente nella colonna In revisione se assegnato ad Amazon Q se un utente sceglie di consentirgli di creare attività. Tuttavia, il problema in In revisione potrebbe avere ancora attività che si trovano in uno stato diverso, ad esempio nello stato In corso.

In questa parte del tutorial, creerai tre problemi basati sulle potenziali funzionalità del codice incluse nei progetti creati con il blueprint di un'applicazione web moderna a tre livelli: uno per aggiungere uno per creare una nuova creatura mysfit, uno per aggiungere una funzionalità di ordinamento e uno per aggiornare un flusso di lavoro per includere un ramo denominato. test

Nota

Se state lavorando a un progetto con codice diverso, create problemi con i titoli e le descrizioni che si riferiscono a quel codice base.

Per creare un problema e far sì che venga generata una soluzione da valutare

  1. Nel riquadro di navigazione, scegli Problemi e assicurati di essere nella visualizzazione Bacheca.

  2. Scegli Crea problema.

  3. Assegna al numero un titolo che spieghi cosa vuoi fare in un linguaggio semplice. Ad esempio, per questo problema, inserisci un titolo diCreate another mysfit named Quokkapus. In Descrizione, fornisci i seguenti dettagli:

    Expand the table of mysfits to 13, and give the new mysfit the following characteristics:

Name: Quokkapus

Species: Quokka-Octopus hybrid

Good/Evil: Good

Lawful/Chaotic: Chaotic

Age: 216

Description: Australia is full of amazing marsupials, but there's nothing there quite like the Quokkapus. 
She's always got a friendly smile on her face, especially when she's using her eight limbs to wrap you up 
in a great big hug. She exists on a diet of code bugs and caffeine. If you've got some gnarly code that needsa
assistance, adopt Quokkapus and put her to work - she'll love it! Just make sure you leave enough room for 
her to grow, and keep that coffee coming.

  4. (Facoltativo) Allega al problema un'immagine da utilizzare come miniatura e immagine del profilo per mysfit. Se lo fai, aggiorna la descrizione per includere dettagli su quali immagini vuoi usare e perché. Ad esempio, potresti aggiungere quanto segue alla descrizione: «Il mysfit richiede che i file di immagine vengano distribuiti sul sito web. Aggiungi queste immagini allegate a questo numero all'archivio di origine come parte del lavoro e distribuiscile sul sito web».

    Nota

    Le immagini allegate potrebbero o meno essere distribuite sul sito Web durante le interazioni di questo tutorial. Puoi aggiungere tu stesso le immagini al sito Web e quindi lasciare commenti affinché Amazon Q aggiorni il codice in modo che punti alle immagini che desideri che utilizzi dopo aver creato una pull request.

    Controlla la descrizione e assicurati che contenga tutti i dettagli che potrebbero essere necessari prima di procedere al passaggio successivo.

  5. In Assegnatari, scegli Assegna ad Amazon Q.

  6. Nel repository Source, scegli il repository di origine che contiene il codice del progetto.

  7. Fai scorrere il pulsante Require Amazon Q per interromperlo dopo ogni passaggio e, se necessario, attendi che il selettore di lavoro ritorni attivo.

    Nota

    Scegliendo l'opzione di interruzione di Amazon Q dopo ogni passaggio, puoi commentare il problema o qualsiasi attività creata e avere la possibilità che Amazon Q cambi il suo approccio fino a tre volte in base ai tuoi commenti. Se scegli di non lasciare che Amazon Q si fermi dopo ogni fase in modo da poterne controllare il funzionamento, il lavoro potrebbe procedere più rapidamente perché Amazon Q non aspetta il tuo feedback, ma non sarai in grado di influenzare la direzione intrapresa da Amazon Q lasciando commenti. Inoltre, Amazon Q non risponderà ai commenti lasciati in una pull request se scegli questa opzione.

  8. Lascia il selettore Consenti ad Amazon Q di modificare i file del flusso di lavoro nello stato inattivo.

  9. Fai scorrere il selettore Consenti ad Amazon Q di suggerire la creazione di attività sullo stato attivo.

  10. Scegli Crea problema. La tua visualizzazione viene modificata nella scheda Problemi.

  11. Scegli Crea problema per creare un altro numero, questa volta con lo stesso titoloChange the get_all_mysfits() API to return mysfits sorted by the Age attribute. Assegna questo problema ad Amazon Q e crea il problema.

  12. Scegli Crea problema per creare un altro numero, questa volta con lo stesso titoloUpdate the OnPullRequest workflow to include a branch named test in its triggers. Se lo desideri, inserisci un link al flusso di lavoro nella descrizione. Assegna questo problema ad Amazon Q ma questa volta assicurati che il selettore Consenti ad Amazon Q di modificare i file del flusso di lavoro sia impostato sullo stato attivo. Crea il problema per tornare alla scheda Problemi.

    Suggerimento

    È possibile cercare file, inclusi i file del flusso di lavoro, inserendo il simbolo at (@) e il nome del file.

Dopo aver creato e assegnato i problemi, i problemi passeranno alla sezione In corso. Amazon Q aggiungerà commenti che ne tracciano l'avanzamento all'interno del problema in un commento aggiunto. Se è in grado di definire un approccio a una soluzione, aggiornerà la descrizione del problema con una sezione Background che contiene l'analisi del codice base e una sezione Approccio che descrive in dettaglio l'approccio proposto per la creazione di una soluzione. Se Amazon Q riesce a trovare una soluzione al problema descritto nel problema, creerà una filiale e apporterà modifiche al codice in quella filiale che implementeranno la soluzione proposta. Se il codice proposto contiene somiglianze con il codice open source di cui Amazon Q è a conoscenza, fornirà un file che include collegamenti a quel codice in modo che tu possa esaminarlo. Una volta che il codice è pronto, crea una pull request in modo da poter esaminare le modifiche al codice suggerite, aggiunge un link a quella pull request al problema e sposta il problema in In review.

Importante

Dovresti sempre rivedere tutte le modifiche al codice in una pull request prima di unirla. L'unione delle modifiche al codice apportate da Amazon Q, come qualsiasi altra modifica al codice, può avere un impatto negativo sulla base di codice e sul codice dell'infrastruttura se il codice unito non viene esaminato correttamente e contiene errori durante l'unione.

Per esaminare un problema e una pull request collegata che contiene le modifiche apportate da Amazon Q

  1. In Problemi, scegli un problema assegnato ad Amazon Q che è in corso. Esamina i commenti per monitorare lo stato di avanzamento di Amazon Q. Se presenti, esamina lo sfondo e consulta i record nella descrizione del problema. Se hai scelto di consentire ad Amazon Q di suggerire attività, esamina le attività proposte e intraprendi le azioni necessarie. Ad esempio, se Amazon Q ha suggerito delle attività e desideri modificare l'ordine o assegnare attività a utenti specifici, scegli Modifica, aggiungi o riordina le attività ed esegui gli aggiornamenti necessari. Quando hai finito di visualizzare il problema, scegli X per chiudere il riquadro del problema.

    Suggerimento

    Per visualizzare lo stato di avanzamento delle attività, scegli l'attività dall'elenco delle attività del numero. Le attività non vengono visualizzate come elementi separati sulla lavagna e sono accessibili solo tramite un numero. Se un'attività è assegnata ad Amazon Q, devi aprirla per approvare le azioni che desidera eseguire. È inoltre necessario aprire un'attività per visualizzare le richieste pull collegate, in quanto non verranno visualizzate come collegamenti nel problema, ma solo nell'attività. Per tornare a un problema da un'attività, scegli il link al problema.

  2. Ora scegli un problema assegnato ad Amazon Q che si trova in In revisione. Esamina lo sfondo e consulta i dati riportati nella descrizione del problema. Esamina i commenti per comprendere le azioni che ha eseguito. Esamina tutte le attività create per il lavoro correlato a questo problema, inclusi lo stato di avanzamento, le azioni che potresti dover intraprendere e gli eventuali commenti. Nelle richieste Pull, scegli il link alla pull request accanto all'etichetta Open per rivedere il codice.

    Suggerimento

    Le richieste pull generate per le attività vengono visualizzate solo come richieste pull collegate nella visualizzazione delle attività. Non vengono visualizzate come richieste pull collegate per il problema.

  3. Nella pull request, esamina le modifiche al codice. Per ulteriori informazioni, consulta Revisione di una pull request. Lascia commenti sulla pull request se desideri che Amazon Q modifichi uno dei suoi codici suggeriti. Sii specifico quando lasci commenti per Amazon Q per ottenere i migliori risultati.

    Ad esempio, quando esamini la pull request creata perCreate another mysfit named Quokkapus, potresti notare che c'è un errore di battitura nella descrizione. Puoi lasciare un commento per Amazon Q che indichi «Modifica la descrizione per correggere l'errore di battitura «needsa» aggiungendo uno spazio tra «needs» e «a».» In alternativa, puoi lasciare un commento che indichi ad Amazon Q di aggiornare la descrizione e fornire l'intera descrizione rivista da incorporare.

    Se hai caricato immagini per il nuovo mysfit sul sito Web, puoi lasciare un commento ad Amazon Q per aggiornare mysfit con puntatori all'immagine e miniature da utilizzare per il nuovo mysfit.

    Nota

    Amazon Q non risponderà ai commenti individuali. Amazon Q includerà il feedback lasciato nei commenti nelle pull request solo se hai scelto l'opzione predefinita di fermarti dopo ogni passaggio per l'approvazione quando hai creato il problema.

  4. (Facoltativo) Dopo che tu e gli altri utenti del progetto avete lasciato tutti i commenti desiderati per le modifiche al codice, scegli Crea revisione per fare in modo che Amazon Q crei una revisione della pull request che incorpori le modifiche richieste nei commenti. Lo stato di avanzamento della creazione della revisione verrà segnalato da Amazon Q in Panoramica, non in Modifiche. Assicurati di aggiornare il browser per visualizzare gli ultimi aggiornamenti di Amazon Q sulla creazione della revisione.

    Nota

    Solo l'utente che ha creato il problema può creare una revisione della pull request. Puoi richiedere una sola revisione di una pull request. Assicurati di aver risolto tutti i problemi relativi ai commenti e di essere soddisfatto del contenuto dei commenti prima di scegliere Crea revisione.

  5. In questo progetto di esempio viene eseguito un flusso di lavoro per ogni pull request. Assicurati di vedere un flusso di lavoro eseguito correttamente prima di unire la pull request. Puoi anche scegliere di creare flussi di lavoro e ambienti aggiuntivi per testare il codice prima di unirlo. Per ulteriori informazioni, consulta Guida introduttiva ai flussi di lavoro.

  6. Quando sei soddisfatto dell'ultima revisione della pull request, scegli Merge.

Crea un problema e chiedi ad Amazon Q di eseguire delle attività consigliate per risolverlo

A volte un problema può comportare una mole di lavoro lunga o complessa. CodeCatalyst include l'integrazione con Amazon Q Developer Agent per lo sviluppo di software. Puoi chiedere ad Amazon Q di analizzare un problema in base al titolo e alla descrizione e consigliare una suddivisione logica del lavoro in attività separate. Tenterà di creare un elenco di attività consigliate da rivedere, modificare e scegliere se creare o meno. Questo può aiutare te e il tuo team ad assegnare singole parti del lavoro agli utenti in modi più gestibili e più rapidamente.

Per creare ed esaminare un elenco di attività consigliate per un problema

  1. Nel riquadro di navigazione, scegli Problemi e assicurati di essere nella visualizzazione Bacheca.

  2. Scegli Crea problema.

  3. Assegna al numero un titolo che spieghi cosa vuoi fare in un linguaggio semplice. Ad esempio, per questo problema, inserisci un titolo diChange the get_all_mysfits() API to return mysfits sorted by the Good/Evil attribute. In Descrizione, fornisci i seguenti dettagli:

    Update the API to allow sorting of mysfits by whether they are Good, Neutral, or Evil. Add a button on the website that allows users to quickly choose this sort and to exclude alignments that they don't want to see.

  4. Controlla la descrizione e assicurati che contenga tutti i dettagli che potrebbero essere necessari prima di procedere al passaggio successivo.

  5. In Assegnatari, scegli di assegnare il problema a te stesso.

  6. Scegli Crea problema. La tua visualizzazione viene modificata nella scheda Problemi.

  7. Scegli il problema che hai appena creato per aprirlo. Scegli Consiglia attività.

  8. Scegli il repository di origine che contiene il codice per i problemi. Scegli Inizia a consigliare attività.

La finestra di dialogo si chiuderà e Amazon Q inizierà ad analizzare la complessità del problema. Se il problema è complesso, suggerirà una suddivisione del lavoro in attività sequenziali separate. Quando l'elenco è pronto, scegli Visualizza attività consigliate. Puoi aggiungere attività aggiuntive, modificare le attività consigliate e riordinare le attività. Se sei d'accordo con i consigli, selezionando Crea attività verranno create le attività. Puoi quindi assegnare tali attività agli utenti affinché ci lavorino o anche ad Amazon Q stesso.

Pulizia delle risorse

Una volta completato questo tutorial, prendi in considerazione l'idea di intraprendere le seguenti azioni per ripulire tutte le risorse che hai creato durante questo tutorial che non ti servono più.

  • Annulla Amazon Q da eventuali problemi su cui non stai più lavorando. Se Amazon Q ha terminato il lavoro su un problema o non è riuscito a trovare una soluzione, assicurati di annullare l'assegnazione di Amazon Q per evitare di raggiungere la quota massima per le funzionalità di intelligenza artificiale generativa. Per ulteriori informazioni, consulta Gestione delle funzionalità e prezzi dell'IA generativa.

  • Sposta tutti i problemi in cui il lavoro è completo su Fine.

  • Se il progetto non è più necessario, eliminalo.