View a markdown version of this page

Tutorial: utilizzo delle funzionalità di intelligenza artificiale CodeCatalyst generativa per velocizzare il lavoro di sviluppo - Amazon CodeCatalyst
PrerequisitiUsare Amazon Q per scegliere un modello durante la creazione di un progetto o l'aggiunta di funzionalitàAggiungi un riepilogo generato automaticamente durante la creazione di una richiesta pullCrea un riepilogo dei commenti lasciati sulle modifiche al codice in una pull requestCrea un problema e assegnalo ad Amazon QCrea un problema e fatti consigliare delle attività da Amazon QEseguire la pulizia delle risorse

Amazon non CodeCatalyst è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta Come migrare da CodeCatalyst.

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 hai un progetto e un repository di sorgenti in Amazon in uno spazio CodeCatalyst 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 portarle a termine. Spesso non si prendono il tempo di spiegare le modifiche al codice ai colleghi quando creano richieste pull per la revisione di tali modifiche, aspettandosi che gli altri utenti trovino le modifiche autoesplicative. Inoltre, i creatori e i revisori delle pull request non hanno il tempo di trovare e leggere a fondo 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 sia aiutare i membri del team a svolgere le proprie attività più rapidamente sia aumentare il tempo a loro disposizione per concentrarsi sulle parti più importanti del loro lavoro.

Amazon Q Developer è un assistente AI-powered conversazionale generativo che può aiutarti a comprendere, creare, estendere e gestire le applicazioni. AWS Per accelerare il processo di sviluppo AWS, il modello su cui si basa Amazon Q è arricchito con AWS contenuti di alta qualità per produrre risposte più complete, fruibili e referenziate. Per ulteriori informazioni, consulta Cos'è Amazon Q Developer? nella Guida per l'utente di Amazon Q Developer.

Nota

Realizzato da Amazon Bedrock: AWS implementa il rilevamento automatico degli abusi. https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html Poiché le funzionalità Scrivi una descrizione per me, Crea un riepilogo dei commenti, Attività consigliate, Usa Amazon Q per creare o aggiungere funzionalità a un progetto e Assegna i problemi ad Amazon Q con Amazon Q Developer Agent per lo sviluppo software sono supportate da Amazon Bedrock, gli utenti possono utilizzare al meglio i controlli implementati in Amazon Bedrock per rafforzare la protezione, la sicurezza e l’uso responsabile dell’intelligenza artificiale (IA).

In questo tutorial, imparerai come utilizzare le funzionalità di intelligenza artificiale generativa CodeCatalyst per aiutarti a creare progetti con blueprint, nonché ad aggiungere blueprint a progetti esistenti. Inoltre, imparerai a riepilogare le modifiche tra le filiali durante la creazione di richieste pull e a riepilogare i commenti lasciati su una richiesta pull. Imparerai anche come creare problemi con le tue idee per modifiche o miglioramenti al codice e assegnarli ad Amazon Q. Come parte 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 Gestire le 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, il tuo progetto esistente ha almeno un repository di sorgenti configurato per esso. I repository collegati non sono supportati.

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

Per ulteriori informazioni, consulta Creazione di 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 a tre livelli Modern con Python. Se usi un progetto creato con un modello diverso, puoi comunque seguire i passaggi, ma alcune specifiche possono variare, come il codice di esempio e il linguaggio.

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

In qualità di sviluppatore di progetti, puoi collaborare con Amazon Q, un assistente di intelligenza artificiale generativa, per creare nuovi progetti o aggiungere 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 alle tue esigenze, Amazon Q suggerisce un modello e delinea anche i requisiti che non possono essere soddisfatti. Se il tuo spazio ha progetti personalizzati, Amazon Q lo apprende e include anche questi progetti nei consigli. Se sei soddisfatto, puoi quindi procedere con il suggerimento di Amazon Q, che creerà le risorse necessarie, ad esempio un repository di sorgenti con il codice adatto alle tue esigenze. Amazon Q crea anche problemi relativi ai requisiti che non possono essere soddisfatti con un progetto. Per saperne di più sui CodeCatalyst blueprint disponibili, consulta. Creazione di un progetto completo con CodeCatalyst blueprint Per ulteriori informazioni sull'utilizzo di Amazon Q con i blueprint, consulta. Le migliori pratiche per l'utilizzo di Amazon Q per creare progetti o aggiungere funzionalità con i blueprint

Per creare un progetto con Amazon Q

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

  2. Nella CodeCatalyst console, vai 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 le 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) Nella sezione Try examples, puoi utilizzare un prompt prestabilito 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 AI generativo fornisce un suggerimento e delinea i requisiti che non possono essere soddisfatti dal progetto. Ad esempio, Amazon Q potrebbe suggerirti 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 delle seguenti operazioni:

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

    2. Scegli Modifica prompt se desideri modificare il prompt.

    3. Scegli Ricomincia da capo se desideri cancellare completamente il prompt.

  8. Esegui una delle seguenti operazioni:

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

    2. Scegli Ignora 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 progetto. Ad esempio, se crei un progetto con il blueprint dell' Single-page applicazione, viene creato un repository sorgente per il codice e i flussi di lavoro pertinenti. CI/CD

  12. (Facoltativo) Per impostazione predefinita, Amazon Q crea problemi anche per i requisiti che non sono soddisfatti da un progetto. Puoi scegliere per quali articoli non vuoi creare problemi. Dopo aver scelto di consentire ad Amazon Q di creare problemi, puoi assegnare un problema anche ad Amazon Q. Analizzerà il problema nel contesto dei repository di origine indicati, fornendo un riepilogo dei file sorgente e del codice pertinenti. Per ulteriori informazioni, consultare Individuazione e visualizzazione dei problemi, Crea un problema e assegnalo ad Amazon Q e Le migliori pratiche per la creazione e la gestione 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 modelli basati sui tuoi requisiti.

Per aggiungere un progetto con Amazon Q

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

  2. Nella CodeCatalyst console, vai al progetto in cui desideri aggiungere un blueprint.

  3. Scegli Aggiungi con Amazon Q.

  4. Nel campo di immissione del testo richiesto di Amazon Q, fornisci le 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) Nella sezione Try examples, puoi utilizzare un prompt prestabilito 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 AI generativo fornisce un suggerimento e delinea i requisiti che non possono essere soddisfatti dal progetto. Ad esempio, Amazon Q potrebbe suggerirti 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 delle seguenti operazioni:

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

    2. Scegli Modifica prompt se desideri modificare il prompt.

    3. Scegli Ricomincia da capo se desideri cancellare completamente il prompt.

  8. Esegui una delle seguenti operazioni:

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

    2. Scegli Ignora 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 aggiungi a un progetto il blueprint dell' Single-page applicazione, viene creato un repository sorgente per il codice e i flussi di lavoro pertinenti. CI/CD

  11. (Facoltativo) Per impostazione predefinita, Amazon Q crea problemi anche per i requisiti che non sono soddisfatti da un progetto. Puoi scegliere per quali articoli non vuoi creare problemi. Dopo aver scelto di consentire ad Amazon Q di creare problemi, puoi assegnare un problema anche ad Amazon Q. Analizzerà il problema nel contesto dei repository di origine indicati, fornendo un riepilogo dei file sorgente e del codice pertinenti. Per ulteriori informazioni, consulta Crea un problema e assegnalo ad Amazon Q e Le migliori pratiche per la creazione e la gestione di problemi assegnati ad Amazon Q.

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

Una pull request è il modo principale in cui tu e gli altri membri del progetto potete rivedere, commentare e unire le modifiche al codice da un ramo all'altro. Puoi utilizzare le pull request per esaminare le modifiche al codice in modo collaborativo per apportare modifiche o correzioni minori, aggiungere 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 che esamineranno il codice e aiuta anche a comprendere la cronologia delle modifiche apportate al codice nel tempo. Tuttavia, gli sviluppatori spesso si affidano al codice per spiegarsi da solo o fornire dettagli ambigui anziché descrivere le modifiche in modo sufficientemente dettagliato da consentire ai revisori di capire cosa stanno esaminando o qual era l'intento alla base delle modifiche apportate al codice.

Puoi utilizzare la funzione Scrivi descrizione per me quando crei 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 Python-based moderno blueprint di applicazione web a tre livelli.

Suggerimento

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

Innanzitutto, creerai un ramo nel repository dei sorgenti. Effettuerai quindi una rapida modifica del codice a 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 una filiale (console)

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

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

  3. Scegli il repository in cui desideri creare una filiale.

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

  5. Inserisci un nome per la filiale.

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

Una volta che hai 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 3 a 5.

Suggerimento

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

Per modificare il file test_endpoint.py nella console

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

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

  3. Scegli Modifica.

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

    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 richiesta pull con un riepilogo delle modifiche

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

  2. Nella filiale di destinazione, scegli la filiale in cui unire il codice dopo averlo esaminato.

    Suggerimento

    Scegli la filiale da cui hai creato la filiale nella procedura precedente per la dimostrazione più semplice di questa funzionalità. Ad esempio, se hai creato il ramo 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 salvato nel test_endpoint.py file.

  4. Nel titolo della richiesta Pull, inserisci un titolo che aiuti gli altri utenti a capire cosa deve essere esaminato e perché.

  5. Nella descrizione della richiesta pull, scegli Scrivi una descrizione per me per fare in modo che Amazon Q crei una descrizione delle modifiche contenute nella richiesta pull.

  6. Viene visualizzato un riepilogo delle modifiche. Rivedi 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 tale pull request. Se ci sono molti commenti da parte di molti revisori, può essere difficile individuare temi comuni nel feedback o persino assicurarsi di aver esaminato tutti i commenti in tutte le revisioni. Puoi utilizzare la funzione Crea un riepilogo dei commenti per fare in modo che Amazon Q analizzi tutti i commenti lasciati sulle modifiche al codice in una richiesta pull e crei un riepilogo di tali commenti.

Nota

I riepiloghi dei commenti sono transitori. Se aggiorni una richiesta pull, 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 richiesta pull

  1. Passa alla pull request che hai creato nella procedura precedente.

    Suggerimento

    Se preferisci, puoi utilizzare qualsiasi pull request aperta nel tuo progetto. Nella barra di navigazione, scegli Codice, scegli Richieste pull e scegli qualsiasi richiesta pull aperta.

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

  3. In Panoramica, scegli Crea un riepilogo dei commenti. Una volta completata, la sezione di riepilogo dei commenti si espande.

  4. Rivedi 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 il problema persiste perché non è chiaro chi debba occuparsene, o il problema richiede una ricerca su una particolare parte della base di codice, o è necessario prima occuparsi di altri lavori urgenti. CodeCatalyst include l'integrazione con Amazon Q Developer Agent per lo sviluppo del 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'ultimo tenterà di creare una bozza di soluzione da valutare. Questo può aiutare te e il tuo team a concentrare e ottimizzare il lavoro sui problemi 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 risultati ottimali, usa un linguaggio semplice per spiegare chiaramente cosa vuoi fare.

Quando assegni un problema ad Amazon Q, CodeCatalyst lo contrassegni come bloccato finché non confermi come desideri che Amazon Q lavori sul problema. È necessario rispondere a tre domande prima di poter continuare:

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

  • Se vuoi 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 le esecuzioni su 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 sui file di flusso di lavoro a meno che tu non sia sicuro che nel tuo progetto non ci siano flussi di lavoro che eseguano automaticamente questi flussi di lavoro prima di esaminare e approvare la pull request creata.

  • Se vuoi consentirgli di suggerire la creazione di attività per suddividere il lavoro relativo al 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ò contribuire ad accelerare lo sviluppo di problemi complessi, consentendo 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 di sorgenti 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. I repository collegati non sono supportati.

Una volta effettuate e confermate 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 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 i progressi sulla questione in ogni fase. A differenza dei commenti e delle risposte bloccati, non tiene una registrazione strettamente cronologica del suo lavoro. Piuttosto, colloca le informazioni più rilevanti sul suo lavoro al livello più alto del commento aggiunto. Tenterà di creare codice in base al suo approccio e all'analisi del codice già presente nel repository. Se genera con successo una potenziale soluzione, creerà un ramo e invierà il codice a quel ramo. Quindi crea una richiesta pull che unirà quel ramo con il ramo predefinito. Quando Amazon Q completa il suo lavoro, sposta il problema in In review in modo che tu e il tuo team sappiate che c'è del codice pronto per essere valutato.

Nota

Questa funzionalità è disponibile solo tramite Issues nella regione Stati Uniti occidentali (Oregon). Non è disponibile se hai configurato il tuo progetto per utilizzare Jira con l'estensione Jira Software. Inoltre, se hai personalizzato il layout della tua bacheca, il problema potrebbe non cambiare stato. Per ottenere risultati ottimali, utilizza questa funzione 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 modificarne il titolo o la descrizione né assegnarlo a nessun altro. Se annulli l'assegnazione del problema ad Amazon Q, questo terminerà la fase corrente e quindi smetterà di funzionare. Non può riprendere il lavoro o essere riassegnato al problema una volta annullato l'assegnazione.

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à in uno stato diverso, ad esempio nello stato In corso.

In questa parte del tutorial, creerai tre problemi in base alle potenziali funzionalità del codice incluso nei progetti creati con il modello di applicazione web a tre livelli Modern: uno per aggiungere un file 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 stai lavorando a un progetto con codice diverso, crea problemi con titoli e descrizioni relativi a quella base di codice.

Per creare un problema e generare una soluzione da valutare

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

  2. Scegli Crea problema.

  3. Assegna al problema un titolo che spieghi cosa vuoi fare in un linguaggio semplice. Ad esempio, per questo numero, 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 un'immagine da utilizzare come miniatura e immagine del profilo per consentire a mysfit di rispondere al problema. In tal caso, aggiorna la descrizione per includere i dettagli delle immagini che desideri utilizzare e perché. Ad esempio, potresti aggiungere quanto segue alla descrizione: «mysfit richiede che i file di immagine siano distribuiti sul sito web. Aggiungete le immagini allegate a questo problema all'archivio di origine come parte del lavoro e distribuite le immagini sul sito web.»

    Nota

    Le immagini allegate possono essere o meno distribuite al 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 indichi le immagini che desideri utilizzare dopo aver creato una pull request.

    Rivedi 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. In Source repository, scegli il repository sorgente che contiene il codice del progetto.

  7. Fai scorrere Require Amazon Q to stop dopo ogni passaggio e attendi la revisione del selettore di lavoro sullo stato attivo, se necessario.

    Nota

    Se scegli di far arrestare Amazon Q dopo ogni passaggio, puoi commentare il problema o qualsiasi attività creata e fare in modo che Amazon Q modifichi il suo approccio fino a tre volte in base ai tuoi commenti. Se scegli l'opzione che fa sì che Amazon Q non si fermi dopo ogni passaggio in modo da poterne esaminare il funzionamento, il lavoro potrebbe procedere più rapidamente perché Amazon Q non è in attesa del tuo feedback, ma non sarai in grado di influenzare la direzione di 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 di 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 passa alla scheda Problemi.

  11. Scegli Crea problema per creare un altro problema, 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. Facoltativamente, collega il 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 i file, inclusi i file del flusso di lavoro, inserendo il simbolo chiocciola (@) e inserendo il nome del file.

Una volta creati e assegnati i problemi, questi passeranno a In corso. Amazon Q aggiungerà commenti che ne monitorano l'avanzamento all'interno del problema in un commento bloccato. Se è in grado di definire un approccio a una soluzione, aggiornerà la descrizione del problema con una sezione Background che contiene l'analisi della base di codice e una sezione Approccio che descrive in dettaglio l'approccio proposto alla creazione di una soluzione. Se Amazon Q riesce a trovare una soluzione al problema descritto nel problema, creerà un ramo e apporterà modifiche al codice in quel ramo che implementeranno la soluzione proposta. Se il codice proposto contiene analogie 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 suggerite, aggiunge un link alla pull request relativa al problema e sposta il problema in In review.

Importante

Dovresti sempre esaminare eventuali 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 quando viene unito.

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

  1. In Problemi, scegli un problema assegnato ad Amazon Q che è in corso. Rivedi i commenti per monitorare lo stato di avanzamento di Amazon Q. Se presente, esamina i retroscena e affronta i dati riportati nella descrizione del problema. Se hai scelto di consentire ad Amazon Q di suggerire attività, esamina tutte 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 problema. Le attività non vengono visualizzate come elementi separati sulla lavagna e sono accessibili solo tramite un problema. Se un'attività è assegnata ad Amazon Q, devi aprirla per approvare le azioni che desidera eseguire. È inoltre necessario aprire un'attività per visualizzare eventuali richieste pull collegate, poiché 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 è in fase di revisione. Esamina il contesto e affronta i dati riportati nella descrizione del problema. Esamina i commenti per comprendere le azioni eseguite. Esamina tutte le attività create per il lavoro relativo a questo problema, inclusi i relativi progressi, eventuali azioni che potresti dover intraprendere ed eventuali commenti. Nelle richieste pull, scegli il link alla pull request accanto all'etichetta Apri per rivedere il codice.

    Suggerimento

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

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

    Ad esempio, esaminando la pull request creata perCreate another mysfit named Quokkapus, potresti notare che c'è un errore di battitura nella descrizione. Potresti 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 alla miniatura da utilizzare per il nuovo mysfit.

    Nota

    Amazon Q non risponderà ai singoli commenti. Amazon Q incorporerà il feedback lasciato nei commenti nelle richieste pull solo se hai scelto l'opzione predefinita di interromperti dopo ogni passaggio per l'approvazione al momento della creazione del problema.

  4. (Facoltativo) Dopo che tu e gli altri utenti del progetto avete lasciato tutti i commenti che desiderate per le modifiche al codice, scegli Crea revisione per fare in modo che Amazon Q crei una revisione della pull request che includa le modifiche richieste nei commenti. L'avanzamento della creazione della revisione verrà riportato da Amazon Q in Overview, non in Changes. 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 Unisci.

Crea un problema e fatti consigliare delle attività da Amazon Q

A volte un problema può comportare una mole di lavoro complessa o lunga. CodeCatalyst include l'integrazione con Amazon Q Developer Agent per lo sviluppo del 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 che potrà quindi rivedere, modificare e scegliere se creare. Questo può aiutare te e il tuo team ad assegnare singole parti del lavoro agli utenti in modi più gestibili e realizzabili 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 vista Bacheca.

  2. Scegli Crea problema.

  3. Assegna al problema un titolo che spieghi cosa vuoi fare in un linguaggio semplice. Ad esempio, per questo numero, 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. Rivedi 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 passa alla scheda Problemi.

  7. Scegli il problema che hai appena creato per aprirlo. Scegli Attività consigliate.

  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à di suddividere il lavoro in attività separate e sequenziali. Quando l'elenco è pronto, scegli Visualizza le attività consigliate. Puoi aggiungere altre attività, modificare le attività consigliate e riordinare le attività. Se sei d'accordo con i consigli, scegliendo Crea attività verranno create le attività. Puoi quindi assegnare tali attività agli utenti per lavorarci sopra o persino ad Amazon Q stesso.

Eseguire la pulizia delle risorse

Una volta completato questo tutorial, valuta la possibilità di intraprendere le seguenti azioni per ripulire tutte le risorse che hai creato durante questo tutorial e che non ti servono più.

  • Annulla l'assegnazione di Amazon Q a eventuali problemi su cui non si sta 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 di funzionalità di intelligenza artificiale generativa. Per ulteriori informazioni, consulta Gestione delle funzionalità e dei prezzi dell'IA generativa. https://codecatalyst.aws/explore/pricing

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

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