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à.
# Configurazione di Amazon Q Developer per i tuoi utenti
Amazon Q Developer è un assistente conversazionale di IA generativa. Puoi configurare Amazon Q Developer all’interno di un dominio nuovo o esistente. Utilizza le informazioni seguenti per configurare Amazon Q Developer.
Con Amazon Q Developer, i tuoi utenti possono:
+ Ricevi step-by-step indicazioni sull'uso delle funzionalità di SageMaker intelligenza artificiale in modo indipendente o in combinazione con altri AWS servizi.
+ Ottieni codice di esempio per iniziare le tue attività di machine learning come la preparazione dei dati, la formazione, l'inferenza e MLOps.
+ Ricevere assistenza sulla risoluzione dei problemi per eseguire il debug e correggere gli errori riscontrati durante l’esecuzione del codice.
**Nota**
Amazon Q Developer in Studio non utilizza i contenuti degli utenti per migliorare il servizio, indipendentemente dal livello di abbonamento in uso, gratuito o Pro. Per la condivisione della telemetria a livello di IDE, Amazon Q potrebbe tenere traccia dell’utilizzo da parte degli utenti, ad esempio il numero di domande poste e se le raccomandazioni sono state accettate o rifiutate. Questi dati di telemetria non includono informazioni di identificazione personale come l’indirizzo IP degli utenti. Per ulteriori informazioni sulla protezione dei dati e per istruzioni sulla non adesione, consulta [Non adesione alla condivisione dei dati nell’IDE](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/opt-out-IDE.html).
Puoi configurare Amazon Q Developer con un piano di abbonamento gratuito o Pro. Il piano Pro è un servizio di abbonamento a pagamento con limiti di utilizzo più elevati e altre funzionalità. Per ulteriori informazioni sulle differenze tra i livelli, consulta [Understanding tiers of service for Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-tiers.html).
Per informazioni sull’abbonamento ad Amazon Q Developer Pro, consulta [Subscribing to Amazon Q Developer Pro](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-admin-setup-subscribe-general.html).
## Istruzioni di configurazione per il piano gratuito di Amazon Q Developer:
Per configurare il piano gratuito di Amazon Q Developer, procedi come indicato di seguito:
**Per configurare il piano gratuito di Amazon Q Developer**
1. Aggiungi la seguente policy al ruolo IAM che hai usato per creare il tuo spazio JupyterLab o Code Editor:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"q:SendMessage"
],
"Resource": [
"*"
]
},
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": [
"codewhisperer:GenerateRecommendations"
],
"Resource": "*"
}
]
}
```
------
1. Accedi ad Amazon SageMaker Studio.
1. Apri il tuo spazio JupyterLab o Code Editor.
1. Vai all’**utilità di avvio** e scegli **Terminale**.
1. Nel JupyterLab, procedi come segue:
1. Specifica `restart-jupyter-server`.
1. Riavvia il browser e torna ad Amazon SageMaker Studio.
## Istruzioni di configurazione per il piano Amazon Q Developer Pro:
**Prerequisiti**
Per configurare Amazon Q Pro, è necessario:
Un dominio Amazon SageMaker AI configurato per la tua organizzazione con IAM Identity Center configurato come mezzo di accesso.
Un abbonamento Amazon Q Developer Pro.
Se stai aggiornando un dominio che hai già configurato per la tua organizzazione, devi aggiornarlo per utilizzare Amazon Q Developer. Puoi utilizzare il Console di gestione AWS o il AWS Command Line Interface per aggiornare un dominio.
Devi utilizzare l’ARN del tuo profilo Amazon Q Developer. Puoi trovare l’ARN del profilo Q nella pagina delle [impostazioni di Q Developer](https://console.aws.amazon.com/amazonq/developer/settings).
Puoi usare il seguente AWS Command Line Interface comando per aggiornare il tuo dominio:
```
aws --region {{Regione AWS}} sagemaker update-domain --domain-id {{domain-id}} --domain-settings-for-update "AmazonQSettings={Status=ENABLED,QProfileArn={{Q-Profile-ARN}}}"
```
Puoi utilizzare anche la procedura seguente per aggiornare il dominio all’interno della Console di gestione AWS.
1. Accedi alla console [Amazon SageMaker AI](https://console.aws.amazon.com/sagemaker).
1. Scegli Domini.
1. Seleziona **Configurazioni dell’app**.
1. Per **Amazon Q Developer for SageMaker AI Applications**, scegli **Modifica**.
1. Seleziona **Abilita Amazon Q Developer su questo dominio**.
1. Fornisci l’ARN del profilo Q.
1. Seleziona **Invia**.
Devi utilizzare l’ARN del tuo profilo Amazon Q Developer. Puoi trovare l’ARN del profilo Q nella pagina dei **dettagli dell’account Amazon Q** della console di Amazon[ Q Developer](https://console.aws.amazon.com/amazonq/developer).
La **configurazione per le organizzazioni** è una configurazione avanzata per il dominio Amazon SageMaker AI che consente di utilizzare IAM Identity Center. Per informazioni su come configurare il dominio e il Centro identità IAM, consulta [Usa una configurazione personalizzata per Amazon SageMaker AI](onboard-custom.md).
Quando configuri Amazon Q Developer in un nuovo dominio, puoi utilizzare il comando Console di gestione AWS o il seguente AWS Command Line Interface comando dal tuo computer locale:
```
aws --region {{Regione AWS}} sagemaker create-domain --domain-id {{domain-id}} --domain-name {{"example-domain-name"}} --vpc-id {{example-vpc-id}} --subnet-ids {{example-subnet-ids}} --auth-mode SSO --default-user-settings "ExecutionRole=arn:aws:iam::{{111122223333}}:role/{{IAM-role}}",--domain-settings "AmazonQSettings={status=ENABLED,qProfileArn={{Q-profile-ARN}}" --query {{example-domain-ARN}}--output text
```
Puoi utilizzare il seguente AWS CLI comando per disabilitare Amazon Q Developer:
```
aws --region {{Regione AWS}} sagemaker update-domain --domain-id {{domain-id}} --domain-settings-for-update "AmazonQSettings={Status=DISABLED,QProfileArn={{Q-Profile-ARN}}}"
```
Ti consigliamo di utilizzare sempre la versione più recente di AWS Command Line Interface. Per informazioni sull'aggiornamento di AWS CLI, consulta [Installare o aggiornare alla versione più recente di AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
Se devi stabilire una connessione tra Amazon Q Developer e il tuo VPC, consulta [Creazione di un endpoint VPC di interfaccia per Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/vpc-interface-endpoints.html#vpc-endpoint-create).
**Nota**
Amazon Q Developer presenta i seguenti limiti:
Non supporta gli spazi condivisi.
Amazon Q Developer rileva se un suggerimento di codice potrebbe essere troppo simile al codice disponibile pubblicamente. Il reference tracker può contrassegnare i suggerimenti con repository URLs e licenze o filtrarli. Questa operazione consente di esaminare il codice di riferimento e il suo utilizzo prima di adottarlo. Tutti i riferimenti vengono registrati per consentirti di esaminarli in un secondo momento per garantire che il flusso di codice e la scrittura del codice non subiscano interruzioni.
Per ulteriori informazioni sui riferimenti al codice, consulta [Uso dei riferimenti al codice - Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/code-reference.html) e [AI Coding Assistant - Amazon Q Developer FAQs](https://aws.amazon.com/q/developer/faqs/?refid=255ccf7b-4a76-4dcb-9b07-68709e2b636b#:~:text=Can%20I%20prevent%20Amazon%20Q%20Developer%20from%20recommending%20code%20with%20code%20references%3F).
Amazon Q elabora tutti i dati di interazione degli utenti nella Regione AWS Stati Uniti orientali (Virginia settentrionale). Per ulteriori informazioni su come Amazon Q elabora i dati e sulle Regioni AWS che supporta, consulta [Regioni supportate per Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/regions.html).
Amazon Q funziona solo con Amazon SageMaker Studio. Non è supportato in Amazon SageMaker Studio Classic.
Sì JupyterLab, Amazon Q funziona con SageMaker AI Distribution Images versione 2.0 e successive. Su Code Editor, Amazon Q funziona con SageMaker AI Distribution Images versione 2.2.1 e successive.
Amazon Q Developer in JupyterLab funziona all'interno dell'estensione AI di Jupyter. Non puoi utilizzare altri modelli 3P all’interno dell’estensione mentre esegui Amazon Q.
## Personalizzazioni di Amazon Q in Amazon SageMaker AI
Se utilizzi Amazon Q Developer Pro, puoi creare delle *personalizzazioni*. Con le personalizzazioni, Amazon Q Developer fornisce suggerimenti basati sulla codebase della tua azienda. Se crei personalizzazioni in Amazon Q Developer, queste diventano disponibili per l'uso in JupyterLab e Code Editor in Amazon SageMaker Studio. Per ulteriori informazioni sulla configurazione delle personalizzazioni, consulta [Personalizzazione dei suggerimenti](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html) nella *Guida per l’utente di Amazon Q Developer*.