

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à.

# Amazon Q Developer per GitHub (anteprima)
<a name="amazon-q-for-github"></a>

**Nota**  
Amazon Q Developer per GitHub è disponibile nella versione di anteprima ed è soggetto a modifiche.

[Amazon Q Developer per GitHub o GitHub Enterprise Cloud](https://github.com/marketplace/amazon-q-developer) ti consente di sfruttare le funzionalità di Amazon Q Developer per i flussi di lavoro di sviluppo software. Con agenti di sviluppo specializzati, puoi implementare nuove idee, esaminare il codice per individuare problemi di qualità e risolvere le vulnerabilità con test unitari. Una volta che l’agente ha completato un’attività, è possibile fornire un feedback e l’agente ripete sulla soluzione precedente. Per ulteriori informazioni, consulta [Agenti di Amazon Q Developer](#github-agents).

Puoi accedere all’integrazione con Amazon Q Developer tramite [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer) e autorizzarla a fornire l’accesso ai repository della tua organizzazione. Per iniziare a utilizzare Amazon Q Developer per GitHub, consulta [Quickstart: installazione, utilizzo delle funzionalità in GitHub e aumento dei limiti di utilizzo](github-quickstart.md).

**Importante**  
Per installare l’app Amazon Q Developer e autorizzare l’accesso ai repository di GitHub, devi soddisfare i requisiti dell’organizzazione GitHub. Per ulteriori informazioni, consulta [Requirements to install a GitHub App](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) e [Roles in organization](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) nella *documentazione di GitHub*.

**Nota**  
L’integrazione di Amazon Q Developer con i dati di processo di GitHub negli Stati Uniti d’America. Per ulteriori informazioni, consulta [Elaborazione tra regioni in Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/cross-region-processing.html).

**Nota**  
Amazon Q Developer per GitHub (Anteprima) attualmente non utilizza i tuoi contenuti per migliorare il servizio. Se lo abiliteremo in futuro, forniremo all’utente un avviso adeguato e un modo per disattivare tale utilizzo.

**Topics**
+ [Installazione dell’app Amazon Q Developer e processo di autorizzazione](#github-concepts-set-up)
+ [Agenti di Amazon Q Developer](#github-agents)
+ [Registrazione dell’installazione di un’app](#github-concepts-register-app-install)
+ [Utilizzo delle estensioni del browser in GitHub](#github-concepts-extensions)
+ [Utilizzo dei comandi slash nei problemi e nelle richieste pull di GitHub](#github-slash-commands)
+ [Quickstart: installazione, utilizzo delle funzionalità in GitHub e aumento dei limiti di utilizzo](github-quickstart.md)
+ [Sviluppo di funzionalità e iterazione con Amazon Q Developer in GitHub](github-feature-development.md)
+ [Revisione del codice con Amazon Q Developer in GitHub](github-code-reviews.md)
+ [Aumento dei limiti di utilizzo e dei dettagli di configurazione nella console Amazon Q Developer](github-register-app-install.md)
+ [Configurazione dei dettagli dell’installazione registrata](github-configuration.md)
+ [Risoluzione dei problemi di Amazon Q Developer per GitHub](github-troubleshooting.md)

## Installazione dell’app Amazon Q Developer e processo di autorizzazione
<a name="github-concepts-set-up"></a>

In qualità di amministratore GitHub dell'organizzazione, puoi installare e configurare l'app Amazon Q Developer [https://github.com/apps/amazon-q-developer](https://github.com/apps/amazon-q-developer)gratuitamente senza dover configurare un AWS account per iniziare. Durante il processo di installazione, scegli di fornire l’accesso a tutti o a determinati repository della tua organizzazione GitHub. Dopo l’installazione e l’autorizzazione, avrai accesso all’utilizzo gratuito delle funzionalità di Amazon Q Developer in GitHub. Puoi aumentare l’utilizzo gratuito registrando l’installazione dell’app nella [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github). Per ulteriori informazioni, consulta [Quickstart: installazione, utilizzo delle funzionalità in GitHub e aumento dei limiti di utilizzo](github-quickstart.md).

**Importante**  
Per installare l’app Amazon Q Developer e autorizzare l’accesso ai repository di GitHub, devi soddisfare i requisiti dell’organizzazione GitHub. Per ulteriori informazioni, consulta [Requirements to install a GitHub App](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) e [Roles in organization](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) nella *documentazione di GitHub*.

**Nota**  
Se l’organizzazione enterprise GitHub ha abilitato l’elenco degli IP consentiti, devi accettare gli indirizzi IP consentiti sull’app GitHub. Puoi anche scegliere di aggiungere automaticamente gli indirizzi IP all’elenco degli elementi consentiti. Per ulteriori informazioni, consulta [Allowing access by GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps) e [Enabling allowed IP addresses](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#enabling-allowed-ip-addresses) nella *documentazione di GitHub*.  
Per accedere alle risorse GitHub vengono utilizzati i seguenti indirizzi IP:  

```
34.228.181.128
44.219.176.187
54.226.244.221
```

## Agenti di Amazon Q Developer
<a name="github-agents"></a>

Gli agenti Amazon Q Developer forniscono supporto per tutto il ciclo di vita dello sviluppo del software, dalla codifica, al test e alla distribuzione fino alla risoluzione dei problemi.
+ **Agente di sviluppo Amazon Q** - Dopo aver creato un problema e aggiunto l’etichetta di sviluppo delle funzionalità, Amazon Q Developer implementa automaticamente le nuove funzionalità e le correzioni di bug. Amazon Q Developer crea una richiesta pull con le modifiche e un riepilogo delle modifiche. Invece di applicare un’etichetta, puoi anche avviare lo sviluppo di funzionalità con il comando slash `/q dev` in un commento al problema. Per ulteriori informazioni, consulta [Sviluppo di funzionalità e iterazione con Amazon Q Developer in GitHub](github-feature-development.md).
+ **Agente di revisione del codice di Amazon Q** - Quando viene creata una nuova richiesta pull o viene riaperta una richiesta pull chiusa, Amazon Q Developer esegue automaticamente una revisione del codice e fornisce feedback sulla qualità del codice, sui potenziali problemi e sui problemi di sicurezza. Amazon Q Developer genera inoltre delle correzioni per i problemi identificati, che puoi esaminare e scegliere di inserire nella richiesta di pull. La revisione del codice include un riepilogo con gli esiti suddivisi in thread. Puoi interagire con Amazon Q Developer utilizzando il comando `/q` nei commenti della richiesta pull per porre domande sugli esiti della revisione del codice.

  Le revisioni automatiche del codice non vengono attivate dai commit successivi effettuati all’interno di una richiesta pull esistente. È possibile avviare ulteriori revisioni del codice all’interno delle richieste pull con il comando slash `/q review`. Per ulteriori informazioni, consulta [Revisione del codice con Amazon Q Developer in GitHub](github-code-reviews.md).

**Importante**  
L'app Amazon Q Developer tenta di creare automaticamente l'etichetta dell'**agente di sviluppo Amazon Q** nei GitHub repository a cui autorizzi l'accesso. Se l'etichetta non viene creata automaticamente o se viene eliminata involontariamente, puoi crearla manualmente. GitHub L'etichetta deve essere denominata **agente di sviluppo Amazon Q** per poter essere riconosciuta ed elaborata come etichetta Amazon Q Developer. Per ulteriori informazioni, consulta [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) nella *documentazione di GitHub*.

## Registrazione dell’installazione di un’app
<a name="github-concepts-register-app-install"></a>

L’integrazione di Amazon Q Developer per GitHub è disponibile gratuitamente senza la necessità di configurare un account AWS per iniziare. Ti vengono fornite chiamate limitate al mese per lo sviluppo di funzionalità, oltre a un numero limitato di righe per le revisioni del codice al mese. Puoi aumentare l’utilizzo gratuito registrando l’installazione dell’app Amazon Q Developer con il tuo account AWS . Per ulteriori informazioni, consulta [Aumento dei limiti di utilizzo e dei dettagli di configurazione nella console Amazon Q Developer](github-register-app-install.md).

**Importante**  
Per registrare l’installazione dell’app nella console Amazon Q Developer, devi soddisfare i requisiti dell’organizzazione GitHub. *Per ulteriori informazioni, consulta [Requisiti per l'installazione di un'GitHubapp](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) e [OAuth app e organizzazioni](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) nella GitHub documentazione.*

## Utilizzo delle estensioni del browser in GitHub
<a name="github-concepts-extensions"></a>

Puoi utilizzare l'estensione Amazon Q Developer in un browser supportato per aggiungere rapidamente un'etichetta per lo sviluppo di funzionalità nei GitHub problemi senza dover cercare nei menu delle etichette.

L’estensione Amazon Q Developer è disponibile per i seguenti browser:
+ [Google Chrome](https://chromewebstore.google.com/detail/amazon-q-github-issue-hel/oefafjbablenakmhacfllkmpaeabnnfi)
+ [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/amazon-q-github-issue-helper)
+ [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/amazon-q-github-issue-helper/poghackjbfhejeppjaegbnblangjbmmc)

## Utilizzo dei comandi slash nei problemi e nelle richieste pull di GitHub
<a name="github-slash-commands"></a>

Puoi utilizzare i comandi slash nei commenti all’interno dei problemi o delle richieste pull di GitHub per invocare Amazon Q Developer ed eseguire attività di sviluppo o fornire supporto.
+ `/q dev` - Invoca Amazon Q Developer in un problema di GitHub per implementare automaticamente nuove funzionalità e correzioni di bug. Amazon Q Developer crea una richiesta pull con le modifiche e un riepilogo delle modifiche.
+ `/q review` - Invoca Amazon Q Developer per eseguire automaticamente revisioni del codice quando le richieste pull vengono create o riaperte. Le revisioni del codice forniscono feedback sulla qualità del codice, sui potenziali problemi e sui problemi di sicurezza, oltre a correzioni suggerite e riepiloghi di revisione del codice con esiti suddivisi in thread. Utilizza `/q` nelle richieste pull per interagire con gli esiti. Le revisioni automatiche non vengono attivate dai commit successivi nelle richieste pull esistenti.
+ `/q help` - Fornisce informazioni su Amazon Q Developer per GitHub, inclusi comandi slash, funzionalità, dettagli di personalizzazione e un link alla documentazione [Amazon Q Developer per GitHub (anteprima)](#amazon-q-for-github) nella *Guida per l’utente a Amazon Q Developer*.

# Quickstart: installazione, utilizzo delle funzionalità in GitHub e aumento dei limiti di utilizzo
<a name="github-quickstart"></a>

**Nota**  
Amazon Q Developer per GitHub è disponibile nella versione di anteprima ed è soggetto a modifiche.

Questo tutorial fornisce una panoramica delle seguenti attività:

1. Installare l’app Amazon Q Developer dal GitHub Marketplace e fornire l’accesso ai repository.

1. Inizia a usare Amazon Q Developer in un problema aggiungendo un'etichetta per lo sviluppo di funzionalità o creando una nuova pull request per la revisione del codice. In alternativa, puoi usare i comandi slash nei numeri per avviare lo sviluppo di funzionalità. Puoi anche avviare ulteriori revisioni del codice all’interno delle richieste pull con un comando slash.

1. (Facoltativo) Registra l'installazione dell'app Amazon Q Developer con il tuo AWS account per aumentare i limiti di utilizzo.

## Fase 1: installa Amazon Q Developer in GitHub e autorizza l’accesso
<a name="github-quickstart-step-1"></a>

Puoi usare Amazon Q Developer GitHub gratuitamente senza dover configurare un AWS account per iniziare. La prima fase per utilizzare Amazon Q Developer in GitHub è installare l’app da [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer). Durante questo processo, puoi fornire ad Amazon Q Developer l’accesso a tutti i tuoi repository GitHub o a repository selezionati.

**Importante**  
Per installare l’app Amazon Q Developer e autorizzare l’accesso ai repository di GitHub, devi soddisfare i requisiti dell’organizzazione GitHub. Per ulteriori informazioni, consulta [Requirements to install a GitHub App](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) e [Roles in organization](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) nella *documentazione di GitHub*.

**Per installare Amazon Q Developer e autorizzare l’accesso**

1. Vai alla pagina [Amazon Q Developer for GitHub app](https://github.com/marketplace/amazon-q-developer).

1. Se necessario, accedi al tuo account [https://github.com/](https://github.com/) utilizzando le credenziali GitHub.

1. Consulta la panoramica e le funzionalità dell’app Amazon Q Developer, quindi scegli **Installa**.

1. Esegui una delle seguenti operazioni per configurare l’accesso ai repository GitHub:

   1. Per fornire l’accesso a tutti i repository attuali e futuri, scegli **Tutti i repository**.

   1. Per fornire l’accesso a repository specifici, scegli **Solo repository selezionati**, scegli il menu a discesa **Seleziona repository**, quindi scegli un repository a cui desideri consentire l’accesso.

1. Scegli **Installa** per completare l’installazione di Amazon Q Developer in GitHub e autorizzarlo ad accedere ai tuoi repository.

Dopo aver installato l’app in GitHub e autorizzato l’accesso, verrai reindirizzato alla pagina di panoramica di Amazon Q Developer in GitHub. Puoi accedere al tuo repository GitHub per iniziare a utilizzare le funzionalità di Amazon Q Developer.

**Nota**  
Se l’organizzazione enterprise GitHub ha abilitato l’elenco degli IP consentiti, devi accettare gli indirizzi IP consentiti sull’app GitHub. Puoi anche scegliere di aggiungere automaticamente gli indirizzi IP all’elenco degli elementi consentiti. Per ulteriori informazioni, consulta [Allowing access by GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps) e [Enabling allowed IP addresses](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#enabling-allowed-ip-addresses) nella *documentazione di GitHub*.  
Per accedere alle risorse GitHub vengono utilizzati i seguenti indirizzi IP:  

```
34.228.181.128
44.219.176.187
54.226.244.221
```

## Fase 2: Utilizzo delle funzionalità di Amazon Q Developer in GitHub
<a name="github-quickstart-step-2"></a>

Dopo aver installato l'app Amazon Q Developer GitHub e aver autorizzato l'accesso ai tuoi repository, puoi iniziare a utilizzare gli agenti Amazon Q Developer per il supporto durante tutto il ciclo di vita dello sviluppo del software, dalla codifica, al test e alla distribuzione fino alla risoluzione dei problemi delle applicazioni. Per ulteriori informazioni, consultare uno dei seguenti argomenti:

**Importante**  
L'app Amazon Q Developer tenta di creare automaticamente l'etichetta dell'**agente di sviluppo Amazon Q** nei GitHub repository a cui autorizzi l'accesso. Se l'etichetta non viene creata automaticamente o se viene eliminata involontariamente, puoi crearla manualmente. GitHub L'etichetta deve essere denominata **agente di sviluppo Amazon Q** per poter essere riconosciuta ed elaborata come etichetta Amazon Q Developer. Per ulteriori informazioni, consulta [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) nella *documentazione di GitHub*.
+ [Sviluppo di funzionalità e iterazione con Amazon Q Developer in GitHub](github-feature-development.md)
+ [Revisione del codice con Amazon Q Developer in GitHub](github-code-reviews.md)

## Fase 3: aumenta i limiti di utilizzo gratuiti e configura i dettagli
<a name="github-quickstart-step-3"></a>

Puoi utilizzare gli agenti di Amazon Q Developer in GitHub gratuitamente senza la necessità di configurare un account AWS per iniziare. Ti vengono fornite chiamate limitate al mese per lo sviluppo di funzionalità e la revisione del codice. Puoi aumentare l'utilizzo gratuito in qualsiasi momento registrando l'installazione dell'app Amazon Q Developer con il tuo AWS account. La registrazione offre inoltre la possibilità di configurare dettagli come la disabilitazione delle revisioni del codice e l’aggiunta dei tag per la ricerca e il filtraggio. Per ulteriori informazioni, consulta [Aumento dei limiti di utilizzo e dei dettagli di configurazione nella console Amazon Q Developer](github-register-app-install.md).

**Importante**  
Per registrare l’installazione dell’app nella console Amazon Q Developer, devi soddisfare i requisiti dell’organizzazione GitHub. Per ulteriori informazioni, consulta [Requisiti per l'installazione di un'GitHubOAuth app](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) [e app e organizzazioni](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) nella *GitHubdocumentazione*.

# Sviluppo di funzionalità e iterazione con Amazon Q Developer in GitHub
<a name="github-feature-development"></a>

**Nota**  
Amazon Q Developer per GitHub è disponibile nella versione di anteprima ed è soggetto a modifiche.

Puoi utilizzare Amazon Q Developer in GitHub per semplificare lo sviluppo implementando automaticamente nuove funzionalità e correzioni di bug, trasferendo le attività dall’idea alla richiesta pull completata. Quando aggiungi l’etichetta di sviluppo della funzionalità a un problema o utilizzi il comando slash `/q dev`, Amazon Q Developer utilizza il problema, inclusi il titolo e la descrizione, nonché il codice del repository come contesto per generare nuove correzioni al codice e creare una richiesta pull. Nella richiesta pull, puoi fornire feedback e Amazon Q Developer esegue le iterazioni sul codice suggerito.

Puoi fare in modo che Amazon Q Developer esegua lo sviluppo di funzionalità un numero limitato di volte al mese. Puoi aumentare l'utilizzo gratuito in qualsiasi momento registrando l'installazione dell'app Amazon Q Developer con il tuo AWS account. Per ulteriori informazioni, consulta [Aumento dei limiti di utilizzo e dei dettagli di configurazione nella console Amazon Q Developer](github-register-app-install.md).

**Importante**  
L'app Amazon Q Developer tenta di creare automaticamente l'etichetta dell'**agente di sviluppo Amazon Q** nei GitHub repository a cui autorizzi l'accesso. Se l'etichetta non viene creata automaticamente o se viene eliminata involontariamente, puoi crearla manualmente. GitHub L'etichetta deve essere denominata **agente di sviluppo Amazon Q** per poter essere riconosciuta ed elaborata come etichetta Amazon Q Developer. Per ulteriori informazioni, consulta [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) nella *documentazione di GitHub*.

**Per utilizzare Amazon Q Developer per lo sviluppo di funzionalità**

1. Se necessario, accedi al tuo account [https://github.com/](https://github.com/) utilizzando le credenziali GitHub.

1. Accedi alla tua GitHub organizzazione, quindi vai al repository in cui desideri implementare nuove funzionalità con Amazon Q Developer.

1. Scegli **Problemi**, quindi crea un nuovo problema o scegli un problema esistente. Per ulteriori informazioni, consulta [Create an issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue) nella *documentazione di GitHub*.

   1. Per un nuovo problema, nel campo di immissione del testo **Aggiungi un titolo**, inserisci un titolo che fornisca un contesto ad Amazon Q Developer per lo sviluppo di funzionalità (esempio: “Crea un’app di riconoscimento delle immagini”). È inoltre necessario includere la descrizione del problema in quanto fornisce anche un contesto.

     Per un problema esistente, puoi modificare il titolo e la descrizione del problema per fornire un contesto ad Amazon Q Developer per lo sviluppo delle funzionalità. *Per ulteriori informazioni, consulta [Editing an issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/editing-an-issue) nella documentazione GitHub*.

1. Quando crei un problema o configuri un problema esistente, puoi applicare l’etichetta Amazon Q Developer per lo sviluppo di funzionalità o utilizzare il comando slash `/q dev`. Esegui una delle seguenti operazioni:
   + Per applicare l’etichetta al problema, procedi in uno dei seguenti modi:
     + Scegli il menu a discesa **Assegna ad Amazon Q** fornito come estensione del browser, quindi scegli l’etichetta **agente di sviluppo Amazon Q**.
     + Nel menu a destra, scegli **Etichette**, quindi scegli l’etichetta **agente di sviluppo Amazon Q**.
   + Per utilizzare il comando slash `/q dev` in un commento:

     1. All’interno del problema, vai su **Aggiungi un commento** e nel campo di immissione del testo del commento, inserisci `/q dev`.

     1. Scegliere **Comment (Commento)**.

1. Per un nuovo problema, scegli **Crea problema** per completare la creazione del problema con i dettagli necessari per consentire ad Amazon Q Developer di sviluppare le funzionalità. Se configuri un problema esistente, assicurati di salvare le modifiche. *Per ulteriori informazioni, consulta [Editing an issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/editing-an-issue) nella documentazione GitHub*.

   Quando Amazon Q Developer termina di generare modifiche al codice per lo sviluppo delle funzionalità, commenta il problema e apre una richiesta pull.

1. Vai al commento lasciato da Amazon Q Developer (esempio: “`I finished the proposed code changes, and the pull request is ready for review: [PR link]`“), quindi scegli il link della richiesta pull.

   Puoi anche accedere alla scheda **Richiesta pull** e quindi scegliere la richiesta pull creata da Amazon Q Developer.

1. Scegli la scheda **File modificati** per visualizzare le modifiche al codice.

1. Se le modifiche al codice suggerite ti soddisfano, puoi unire la richiesta pull. Per ulteriori informazioni, consulta [Merge a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request).

Puoi anche esaminare la richiesta pull per lo sviluppo della funzionalità e iterare sulle modifiche al codice suggerite fornendo feedback ad Amazon Q Developer.

**Per iterare sul codice di sviluppo delle funzionalità di Amazon Q Developer**

1. Scegli la richiesta pull creata da Amazon Q Developer, quindi scegli la scheda **File modificati** per visualizzare le modifiche al codice.

1. Facoltativamente, per righe di codice specifiche su cui desideri fornire un feedback, scegli **\$1** per aggiungere un commento con feedback.

   Nella conversazione, puoi usare il `/q` comando seguito dalle tue istruzioni in linguaggio naturale (ad esempio, `/q implement my suggestions` o`/q refactor this function for better performance`). Amazon Q Developer risponderà con un commento che descrive le modifiche che apporterà in base al tuo feedback (ad esempio, «Implementerò le seguenti modifiche in base al feedback:...»). Una volta completata l'implementazione, Amazon Q Developer pubblicherà un altro commento a conferma delle modifiche (ad esempio, «Ho implementato le modifiche suggerite») insieme a un link al commit generato in cui è possibile visualizzare le modifiche.

1. Controlla le modifiche apportate da Amazon Q Developer seguendo il link di commit fornito nella conversazione. Puoi continuare a fornire feedback aggiuntivi utilizzando il `/q` comando per ulteriori iterazioni, se necessario.

1. Se le modifiche al codice aggiornate ti soddisfano, puoi unire la richiesta pull o iterare il codice con un nuovo feedback. Per ulteriori informazioni, consulta [Merge a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request).

# Revisione del codice con Amazon Q Developer in GitHub
<a name="github-code-reviews"></a>

**Nota**  
Amazon Q Developer per GitHub è disponibile nella versione di anteprima ed è soggetto a modifiche.

Amazon Q Developer abilita revisioni automatiche del codice all’interno di GitHub. Quando crei una nuova richiesta pull o ne riapri una chiusa, Amazon Q Developer esegue automaticamente una revisione del codice e fornisce feedback sulla qualità del codice, sui potenziali problemi e sugli esiti di elevata gravità. Ogni revisione include un riepilogo sulla revisione del codice con esiti suddivisi in thread. Amazon Q Developer genera inoltre delle correzioni per i problemi identificati, che puoi esaminare e scegliere di inserire nella richiesta di pull. Puoi utilizzare il comando `/q` nei commenti delle richieste pull per porre domande e interagire in merito agli esiti della revisione del codice. Le revisioni automatiche del codice non vengono attivate dai commit successivi effettuati all’interno di una richiesta pull esistente.

**Nota**  
L'impostazione della funzionalità di revisione dei codici nella console Amazon Q Developer controlla le revisioni automatiche del codice che vengono eseguite quando le richieste pull vengono create o riaperte. L'avvio delle revisioni del codice utilizzando il comando `/q review` slash nei commenti delle richieste pull non è influenzato da questa impostazione.

È inoltre possibile avviare revisioni del codice all’interno delle richieste pull con il comando slash `/q review`. Il comando slash può essere aggiunto a un nuovo commento della richiesta pull, che avvia una nuova revisione del codice della richiesta pull nel suo stato attuale, inclusi eventuali commenti e nuovi commit. Per ulteriori informazioni, consulta [Avvio delle revisioni del codice all’interno delle richieste pull di GitHub](#github-code-reviews-in-pr).

Puoi fare in modo che Amazon Q Developer esegua una revisione del codice per un numero limitato di righe al mese. Puoi aumentare l'utilizzo gratuito in qualsiasi momento registrando l'installazione dell'app Amazon Q Developer con il tuo AWS account. Per ulteriori informazioni, consulta [Aumento dei limiti di utilizzo e dei dettagli di configurazione nella console Amazon Q Developer](github-register-app-install.md).

**Nota**  
Se la funzionalità di revisione del codice era precedentemente disabilitata, deve essere abilitata nella [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github) prima di poter applicare l’etichetta GitHub. Per ulteriori informazioni, consulta [Modifica delle funzionalità di Amazon Q Developer in GitHub](github-configuration.md#github-edit-features).

## Prerequisiti
<a name="github-code-reviews-prerequisites"></a>

Prima di poter avviare la revisione del codice con Amazon Q Developer, sono necessarie le autorizzazioni appropriate per il repository GitHub di destinazione. I ruoli del repository supportati sono Write, Maintain o Admin. Gli utenti con ruoli Read o Triage, così come i membri senza un ruolo, non possono avviare revisioni del codice con Amazon Q Developer.

Gli utenti GitHub con il ruolo Triage possono comunque esaminare le richieste pull in un repository. Qualsiasi utente, indipendentemente dal ruolo, può esaminare le richieste pull nei repository pubblici.

Per ulteriori informazioni, consulta [Repository roles for organizations](https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization#repository-roles-for-organizations) e [About pre-defined organization roles](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#about-pre-defined-organization-roles) nella *documentazione di GitHub*.

## Avvio delle revisioni del codice per le richieste pull di GitHub
<a name="github-new-code-reviews-pr"></a>

Quando apri una nuova richiesta pull o ne riapri una precedentemente chiusa, Amazon Q Developer esegue automaticamente una revisione del codice e fornisce feedback sulla qualità del codice, sui possibili problemi ed esiti critici.

**Per utilizzare Amazon Q Developer per la revisione del codice e l’applicazione di correzioni**

Prima di iniziare una revisione, puoi personalizzare una revisione della qualità del codice definendo standard di codifica personalizzati in semplici file Markdown nella directory `project-root/.amazonq/rules`. Amazon Q segue automaticamente le tue linee guida, garantendo una qualità del codice costante per l’intero progetto. Per ulteriori informazioni, consulta [Creazione di regole di progetto per Amazon Q Developer in piattaforme di terze parti](third-party-context-project-rules.md).

1. Se necessario, accedi al tuo account [https://github.com/](https://github.com/) utilizzando le credenziali GitHub.

1. Accedi alla tua organizzazione GitHub, quindi vai al repository in cui desideri eseguire una revisione del codice con Amazon Q Developer.

1. Crea una nuova richiesta pull per le modifiche apportate al codice sorgente. Per ulteriori informazioni, consulta [Creating a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) nella *documentazione di GitHub*.

   Quando crei una nuova richiesta pull, Amazon Q Developer avvia automaticamente una revisione del codice per individuare potenziali problemi. Una volta completata la revisione, Amazon Q Developer fornisce un riepilogo della revisione del codice. Ogni esito appare sotto forma di commento in thread sotto il riepilogo, insieme alle correzioni suggerite che puoi inserire nella richiesta pull.

1. Chiedi all'agente di implementare le modifiche e creare commit direttamente sul ramo sorgente della pull request. Puoi farlo pubblicando un commento che inizia con `/q` e seguito dalla tua richiesta in linguaggio naturale affinché l'agente apporti modifiche.

1. (Facoltativo) Poni domande sugli esiti specifici. All’interno della richiesta pull, accedi a **Aggiungi un commento** e, nel campo di immissione del testo del commento, inserisci `/q` seguito dalla tua domanda (ad esempio, “`/q explain the importance of this finding`“).

1. Esamina le modifiche al codice proposte da Amazon Q Developer, scegli **Esegui il commit del suggerimento**, quindi scegli **Esegui il commit delle modifiche** per aggiornare la richiesta pull.

1. Se sei soddisfatto delle correzioni al codice suggerite, puoi unire la richiesta pull per applicare le modifiche al codice suggerite da Amazon Q Developer. Per ulteriori informazioni, consulta [Merging a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request) nella *documentazione di GitHub*.

## Avvio delle revisioni del codice all’interno delle richieste pull di GitHub
<a name="github-code-reviews-in-pr"></a>

Dopo una revisione automatica del codice eseguita da Amazon Q Developer per una richiesta pull GitHub nuova o riaperta, puoi avviare ulteriori revisioni del codice per iterarlo utilizzando il comando slash `/q review`. La revisione del codice viene eseguita sul file diff dell’intera richiesta pull.

**Nota**  
È possibile avviare una revisione del codice all’interno di una richiesta pull solo con un nuovo commento. Il comando slash `/q review` non funzionerà in un thread di commenti esistente. L'avvio di una revisione del codice utilizzando il comando `/q review` slash non è influenzato dall'impostazione della funzionalità Code reviews nella console Amazon Q Developer.

**Per utilizzare l’avvio delle revisioni del codice in una richiesta pull**

1. Se necessario, accedi al tuo account [https://github.com/](https://github.com/) utilizzando le credenziali GitHub.

1. Accedi alla tua organizzazione GitHub, quindi vai alla richiesta pull in cui desideri eseguire una revisione del codice con Amazon Q Developer. Per ulteriori informazioni, consulta [About pull requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests).

1. All’interno della richiesta pull, vai su **Aggiungi un commento** e nel campo di immissione del testo del commento, inserisci `/q review`.

1. Scegli **Commento** per avviare la revisione del codice.

   Amazon Q Developer potrebbe richiedere alcuni minuti per completare l’analisi del codice della richiesta pull. Al termine dell’analisi, Amazon Q Developer fornisce un riepilogo di revisione del codice. Ogni esito appare sotto forma di commento in thread sotto il riepilogo, insieme alle modifiche proposte che puoi scegliere di confermare e aggiornare la richiesta pull.

1. (Facoltativo) Poni domande sugli esiti specifici. All’interno della richiesta pull, accedi a **Aggiungi un commento** e, nel campo di immissione del testo del commento, inserisci `/q` seguito dalla tua domanda (ad esempio, “`/q explain the importance of this finding`“).

1. Se sei soddisfatto delle correzioni al codice suggerite, puoi unire la richiesta pull per applicare le modifiche al codice suggerite da Amazon Q Developer. Per ulteriori informazioni, consulta [Merging a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request) nella *documentazione di GitHub*.

# Aumento dei limiti di utilizzo e dei dettagli di configurazione nella console Amazon Q Developer
<a name="github-register-app-install"></a>

**Nota**  
Amazon Q Developer per GitHub è disponibile nella versione di anteprima ed è soggetto a modifiche.

Puoi utilizzare gli agenti di sviluppo di Amazon Q GitHub gratuitamente senza la necessità di configurare un AWS account per iniziare. Ti vengono fornite chiamate limitate al mese per lo sviluppo di funzionalità e le funzionalità di revisione del codice. Puoi aumentare l'utilizzo gratuito in qualsiasi momento registrando l'installazione dell'app Amazon Q Developer con il tuo AWS account.

Per impostazione predefinita, le **funzionalità di **revisione del codice** e di sviluppo** delle funzionalità sono abilitate al GitHub momento dell'installazione dell'app. Puoi disabilitare ognuna di queste funzionalità al momento della registrazione. La registrazione richiede un profilo Amazon Q Developer per gestire le funzionalità dalla console. Il profilo memorizza le impostazioni e la personalizzazione dei suggerimenti sul codice.

**Importante**  
Per registrare l’installazione dell’app nella console Amazon Q Developer, devi soddisfare i requisiti dell’organizzazione GitHub. Per ulteriori informazioni, consulta [Requisiti per l'installazione di un'GitHubOAuth app](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) [e app e organizzazioni](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) nella *GitHubdocumentazione*.

**Per registrare la tua installazione di Amazon Q Developer**

1. Accedi alla [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home).

1. Scegli **Abilita Q Developer** nella parte superiore della pagina e segui le istruzioni per abilitare Kiro e Amazon Q Developer.

   Se in precedenza hai abilitato Kiro e Amazon Q Developer, vai al passaggio 3.

1. Nel riquadro di navigazione, scegli **Amazon Q Developer in GitHub**.

1. Scegli **Registra installazione**, quindi scegli **Autorizza** per essere indirizzato a GitHub.

   Se in precedenza hai autorizzato Amazon Q Developer ad accedere alla tua organizzazione GitHub, verrai reindirizzato alla console Amazon Q Developer. In questo caso, vai al passaggio 7.

1. Accedere alla GitHub tramite le credenziali GitHub. Se disponi di più account, seleziona l’account a cui desideri fornire l’accesso ad Amazon Q Developer.

1. Scegli **Authorize Amazon Q Developer** per fornire l’accesso al tuo account GitHub. Verrai reindirizzato alla console Amazon Q Developer dopo l’autorizzazione.

1. In **Dettagli di registrazione**, inserisci i tuoi dati GitHub, configura facoltativamente la funzionalità di revisione del codice e aggiungi i tag.

   1. Nel campo di immissione del **Nome di registrazione**, inserisci un nome per l’installazione dell’app.

   1. (Facoltativo) Nel campo di immissione di testo **Nome dell’organizzazione -*facoltativo***, inserisci un nome per l’organizzazione associata all’installazione dell’app.

   1. (Facoltativo) In **Funzionalità**, configura la funzionalità di **Revisione del codice** scegliendo l’interruttore per abilitarla o disabilitarla. La configurazione di **sviluppo delle funzionalità** non può essere modificata ed è abilitata per impostazione predefinita.

   1. (Facoltativo) In **Tag: opzionale**, scegli **Aggiungi nuovo tag** per aggiungere un tag che possa aiutarti a cercare e filtrare AWS le tue risorseGitHub.

1. Scegli **Registra** per registrare l'installazione dell'app GitHub con il tuo AWS account.

Dopo aver registrato correttamente l'installazione dell'app, puoi visualizzare i dettagli della registrazione. Puoi comunque abilitare o disabilitare la funzione di revisione dei codici e aggiungere tag in un secondo momento. Puoi anche eliminare la registrazione. Per ulteriori informazioni, consulta [Configurazione dei dettagli dell’installazione registrata](github-configuration.md).

# Configurazione dei dettagli dell’installazione registrata
<a name="github-configuration"></a>

**Nota**  
Amazon Q Developer per GitHub è disponibile nella versione di anteprima ed è soggetto a modifiche.

Dopo aver creato un profilo Amazon Q Developer e registrato l’installazione dell’app GitHub, puoi effettuare le seguenti operazioni dalla console Amazon Q Developer:
+ Abilitare o disabilitare l’uso delle revisioni del codice. La configurazione di sviluppo delle funzionalità non può attualmente essere modificata.
+ Trovare i link alle estensioni del browser che forniscono un modo per aggiungere le etichette delle funzionalità di Amazon Q Developer nei problemi di GitHub.
+ Aggiungi tag per cercare e filtrare le tue risorse o tenere traccia AWS dei costi.
+ Eliminare una registrazione dell’installazione di un’app GitHub.

## Modifica delle funzionalità di Amazon Q Developer in GitHub
<a name="github-edit-features"></a>

Le funzionalità disponibili per Amazon Q Developer in GitHub sono abilitate per impostazione predefinita quando installi l’app GitHub e fornisci l’autorizzazione per accedere alla tua organizzazione. Puoi scegliere di disabilitare una funzionalità se non desideri più utilizzarla in GitHub.

**Per abilitare o disabilitare una funzionalità per Amazon Q Developer in GitHub**

1. Accedi alla [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).

1. Nel riquadro di navigazione, alla voce **Amazon Q Developer in GitHub**, scegli **Installazioni registrate**.

1. Nella colonna **Nome**, scegli il nome della registrazione per l’installazione in cui desideri abilitare o disabilitare una funzionalità.

1. In **Funzionalità**, scegli **Modifica** per configurare la disponibilità della funzionalità.

1. Nel modale, scegli l’interruttore relativo alla funzionalità che desideri abilitare o disabilitare, quindi scegli **Salva** per confermare le modifiche.

Dopo aver abilitato o disabilitato una funzionalità nella [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github), le modifiche si riflettono in GitHub. Il tentativo di assegnare un problema a un’etichetta Amazon Q Developer dopo aver disabilitato la funzionalità genererà un errore. Le revisioni del codice non verranno più eseguite nelle nuove richieste pull se la funzionalità è disabilitata.

## Installazione delle estensioni del browser
<a name="github-extensions"></a>

Puoi installare l’estensione Amazon Q Developer in uno dei browser supportati. L'estensione consente di assegnare rapidamente attività di sviluppo di funzionalità ad Amazon Q Developer in caso di GitHub problemi senza dover cercare nei menu delle etichette.

L’estensione Amazon Q Developer è disponibile per i seguenti browser:
+ [Google Chrome](https://chromewebstore.google.com/detail/amazon-q-github-issue-hel/oefafjbablenakmhacfllkmpaeabnnfi)
+ [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/amazon-q-github-issue-helper)
+ [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/amazon-q-github-issue-helper/poghackjbfhejeppjaegbnblangjbmmc)

Puoi anche visualizzare i browser supportati nella pagina dei dettagli di installazione della registrazione nella [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).

## Eliminazione della registrazione per un’installazione dell’app GitHub con Amazon Q Developer
<a name="github-delete-app-install"></a>

Puoi eliminare una registrazione per una o più installazioni dell’app GitHub tramite la console Amazon Q Developer. Dopo aver eliminato definitivamente la registrazione, vengono eliminati anche tutti i dati ad essa associati. L’operazione non può essere annullata.

**Per eliminare l’installazione dell’app GitHub**

1. Accedi alla [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).

1. Nel riquadro di navigazione, alla voce **Amazon Q Developer in GitHub**, scegli **Installazioni registrate**.

1. Esegui una delle seguenti operazioni:
   + Nella colonna **Azioni**, scegli **Elimina registrazione** per l’installazione che desideri eliminare.
   + Nella colonna **Nome**, scegli il nome della registrazione per l’installazione che desideri eliminare, quindi scegli **Elimina**.

   Nella colonna **Azioni**, scegli **Elimina registrazione** per l’installazione registrata che desideri eliminare.

1. Nel modale, rivedi i dettagli per l’eliminazione della registrazione.

1. Nel campo di immissione del testo, immetti **confirm**, quindi scegli **Elimina** per confermare le modifiche.

Dopo aver eliminato l’installazione di un’app GitHub, puoi scegliere di registrarne una nuova.

# Risoluzione dei problemi di Amazon Q Developer per GitHub
<a name="github-troubleshooting"></a>

Consulta la sezione seguente per risolvere i problemi più comuni relativi all’utilizzo di Amazon Q Developer per GitHub.

## Amazon Q Developer non genera richieste pull in repository con regole di protezione dei rami
<a name="github-troubleshooting-branch-protection"></a>

**Problema**: Amazon Q Developer non è in grado di creare una richiesta pull nel mio repository GitHub, che prevede regole di protezione dei rami.

**Soluzione**: le regole di protezione dei rami impediscono ad Amazon Q Developer di creare un ramo per generare una richiesta pull. Per utilizzare Amazon Q Developer per GitHub in repository con regole di protezione dei rami, devi aggiungere l’app Amazon Q Developer all’elenco dei file consentiti.

**Per aggiungere l’app Amazon Q Developer all’elenco degli utenti consentiti**

1. Se necessario, accedi al tuo account [https://github.com/](https://github.com/) utilizzando le credenziali GitHub.

1. Accedi alla tua organizzazione GitHub, quindi vai al repository in cui desideri consentire Amazon Q Developer per l’app GitHub.

1. Scegli **Impostazioni**, quindi scegli **Rami** dal riquadro di navigazione.

1. In **Regole di protezione dei rami**, scegli **Modifica** per modificare le regole di protezione dei rami.

1. Scegli **Limita i push che creano rami corrispondenti** e cerca l’app Amazon Q Developer per GitHub.

1. Scegli **Salva modifiche** per consentire ad Amazon Q Developer di creare delle richieste pull per problemi con le etichette Amazon Q Developer.

Per ulteriori informazioni sulla modifica delle regole di protezione dei rami in GitHub, consulta [Creating a branch protection rule](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule#creating-a-branch-protection-rule).

## Etichette Amazon Q Developer mancanti nei problemi di GitHub
<a name="github-troubleshooting-labels"></a>

**Problema**: non vedo l'etichetta dell'**agente di sviluppo Amazon Q** nei GitHub problemi.

**Soluzione**: se l'etichetta non viene creata automaticamente quando hai installato l'GitHubapp Amazon Q Developer for o è stata eliminata involontariamente, puoi crearla manualmente. GitHub L'etichetta deve essere denominata **agente di sviluppo Amazon Q** per poter essere riconosciuta ed elaborata come etichetta Amazon Q Developer. Per ulteriori informazioni, consulta [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) nella *documentazione di GitHub*.

## Amazon Q Developer non crea codice per i problemi di GitHub
<a name="github-troubleshooting-generate-code"></a>

**Problema**: ho creato un problema GitHub e ho invocato Amazon Q Developer per eseguire un’attività, ma ho ricevuto la seguente serie di messaggi relativi a difficoltà tecniche:

1. ⏳ I'm working on generating code for this issue. I'll update this issue with a comment and open a pull request when I'm done.

1. ⚠️ I'm having technical difficulties. I couldn't solve the issue. I'm going to try again. This might take some time.

1. ⚠️ I'm having technical difficulties. I couldn't solve the issue. I'm going to try again. This might take some time.

1. 🔴 I'm having technical difficulties. I couldn't solve the issue.

   Consider reassigning this issue to a user. This will help you stay within the quotas for generative AI feature usage.

**Soluzione**: se Amazon Q Developer non è in grado di elaborare il problema e generare il relativo codice, crea un nuovo problema e applica l'etichetta dell'**agente di sviluppo Amazon Q** al nuovo problema. Per ulteriori informazioni sulla creazione di un problema e sull'applicazione dell'etichetta di agente Amazon Q Developer, consulta[Sviluppo di funzionalità e iterazione con Amazon Q Developer in GitHub](github-feature-development.md).