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 Amazon Q Developer è un assistente conversazionale di IA generativa che ti aiuta a scrivere codice migliore. Amazon Q Developer è disponibile nei seguenti formati IDEs all'interno di Amazon SageMaker Studio: + JupyterLab + Editor di codice, basato su Code-OSS, Visual Studio Code - Open Source Utilizza le sezioni seguenti per configurare Amazon Q Developer e utilizzarlo all’interno del tuo ambiente. **Topics** + [Configurazione di Amazon Q Developer per i tuoi utenti](studio-updated-amazon-q-admin-guide-set-up.md) + [Utilizzo di Amazon Q per accelerare i flussi di lavoro di machine learning](studio-updated-user-guide-use-amazon-q.md) + [Personalizza Amazon Q Developer nelle applicazioni Amazon SageMaker Studio](q-customizations.md) # 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. Passa 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*. # Utilizzo di Amazon Q per accelerare i flussi di lavoro di machine learning Amazon Q Developer è il tuo partner basato sull’IA per lo sviluppo del machine learning. Con Amazon Q Developer, puoi: + Ricevi step-by-step indicazioni sull'uso delle funzionalità di SageMaker intelligenza artificiale indipendentemente 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. Per utilizzare Amazon Q Developer, scegli la **Q** dalla barra di navigazione a sinistra del tuo ambiente JupyterLab o del Code Editor. Se non vedi l’icona **Q**, il tuo amministratore deve configurarla per te. Per ulteriori informazioni sulla configurazione di Amazon Q Developer, consulta [Configurazione di Amazon Q Developer per i tuoi utenti](studio-updated-amazon-q-admin-guide-set-up.md). Amazon Q fornisce automaticamente suggerimenti per aiutarti a scrivere il codice. Puoi anche chiedere suggerimenti tramite l’interfaccia della chat. # Personalizza Amazon Q Developer nelle applicazioni Amazon SageMaker Studio Puoi personalizzare le applicazioni Amazon Q Developer in the JupyterLab e Code Editor in Amazon SageMaker Studio. Quando lo personalizzi, Q Developer fornisce suggerimenti e risposte basati su esempi tratti dalla tua codebase. Se utilizzi Amazon Q Developer Pro, puoi caricare tutte le personalizzazioni che hai creato con quel servizio. ## Personalizza in JupyterLab In JupyterLab, puoi caricare tutte le personalizzazioni che hai creato con Amazon Q Developer Pro. Oppure, nel tuo JupyterLab spazio, puoi personalizzare Q Developer localmente con i file che carichi nello spazio. ### Per utilizzare le personalizzazioni create in Amazon Q Developer Pro Quando carichi una personalizzazione, Q Developer fornisce suggerimenti basati sulla codebase che hai utilizzato per creare la personalizzazione. Inoltre, quando utilizzi la chat nel pannello **Amazon Q**, interagisci con la tua personalizzazione. 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*. **Per caricare la personalizzazione** Apri il tuo JupyterLab spazio e completa i seguenti passaggi. 1. Nella barra di stato in basso JupyterLab, scegli **Amazon Q.** Si apre un menu. 1. Nel menu, scegli **Altre funzionalità**. La scheda **Funzionalità di Amazon Q** si apre nell’area di lavoro principale. 1. Nella scheda **Funzionalità di Amazon Q**, in **Seleziona personalizzazione**, scegli la tua personalizzazione Q Developer. 1. Interagisci con la personalizzazione in uno dei seguenti modi: + Crea un notebook e scrivi codice al suo interno. Mentre scrivi, Q Developer ti fornisce automaticamente dei suggerimenti inline su misura in base alla tua personalizzazione. + Chatta con Q Developer nel pannello **Amazon Q** seguendo questi passaggi: 1. Nella barra laterale sinistra di JupyterLab, scegli l'icona **Jupyter** AI Chat. Si apre il pannello **Amazon Q.** 1. Utilizza la finestra di chat **Chiedi ad Amazon Q** per interagire con la personalizzazione. ### Per personalizzare Amazon Q Developer con i file presenti nel tuo JupyterLab spazio Nel JupyterLab, puoi personalizzare Q Developer con i file che carichi nel tuo spazio. Quindi, nella chat nel pannello **Amazon Q**, puoi utilizzare un comando per chiedere a Q Developer informazioni su quei file. Quando personalizzi Q Developer con i file presenti nel tuo spazio, la personalizzazione esiste solo nel tuo spazio. Non puoi caricare la personalizzazione altrove, ad esempio in altri spazi o nella console di Amazon Q Developer. Puoi personalizzare Q Developer inserendo file JupyterLab se utilizzi Amazon Q Developer Pro o Amazon Q Developer al piano gratuito. **Per personalizzare in base ai tuoi file** Apri il tuo JupyterLab spazio e completa i seguenti passaggi. 1. Verifica se il tuo spazio è configurato con il modello di embedding richiesto. Puoi personalizzare Q Developer JupyterLab solo se utilizzi il modello di incorporamento predefinito, che è **CodeSage :: codesage-small**. Per controllare, procedi come descritto di seguito: 1. **Nella barra laterale sinistra, scegli l'icona Jupyter AI JupyterLab Chat.** Si apre il pannello **Amazon Q.** 1. Scegli l’icona delle impostazioni nell’angolo in alto a destra del pannello. 1. **Per il **modello di incorporamento**, se necessario, scegli **CodeSage : codesage-small** e scegli Salva modifiche.** 1. Scegli l’icona Indietro nell’angolo in alto a destra del pannello. 1. Per caricare i file con cui personalizzare Q Developer, nel pannello **Browser di file** scegli l’icona **Carica file**. 1. Dopo aver caricato i file, nella finestra di chat **Chiedi ad Amazon Q**, digita `/learn file path/`. Sostituisci *file path/* con il percorso dei tuoi file nel tuo spazio. JupyterLab Quando Amazon Q termina l’elaborazione dei file, lo conferma con un messaggio di chat nel pannello Amazon Q. 1. Per porre a Q Developer una domanda sui tuoi file, digita `/ask` nella finestra di chat e inserisci la domanda dopo il comando. Amazon Q genera una risposta in base ai tuoi file e la visualizza nella chat. Per ulteriori informazioni sui comandi `/learn` e `/ask`, come le relative opzioni e gli argomenti supportati, consulta [Informazioni sui dati locali](https://jupyter-ai.readthedocs.io/en/latest/users/index.html#learning-about-local-data) nella documentazione per gli utenti di Jupyter AI. Questa pagina spiega come utilizzare i comandi con il chatbot AI di Jupyternaut. JupyterLabin Amazon SageMaker Studio supporta la stessa sintassi dei comandi. ## Personalizzazione nell’Editor di codice Se hai creato una personalizzazione in Amazon Q Developer Pro, puoi caricarla nell’Editor di codice. Quindi, quando fornisce i suggerimenti per il codice, Q Developer utilizza la codebase con cui hai creato la personalizzazione. Inoltre, quando utilizzi la chat nel pannello **Amazon Q: chat**, interagisci con la tua personalizzazione. **Per utilizzare le personalizzazioni create in Amazon Q Developer Pro** Apri lo spazio dell’Editor di codice e procedi come segue. 1. Nel menu dell’Editor di codice, scegli **Visualizza** e **Quadro di comando**. 1. Nel quadro di comando, inizia a digitare **>Amazon Q: Select Customization** e scegli l’opzione nell’elenco filtrato dei comandi quando viene visualizzata. Il quadro di comando mostra le personalizzazioni di Q Developer. 1. Scegli la personalizzazione. 1. Interagisci con la personalizzazione in uno dei seguenti modi: + Crea un file Python o un notebook Jupyter e scrivici del codice. Mentre scrivi, Q Developer ti fornisce automaticamente dei suggerimenti inline su misura in base alla tua personalizzazione. + Chatta con Q Developer nel pannello **Amazon Q** seguendo questi passaggi: 1. Nella barra laterale sinistra dell’Editor di codice, scegli l’icona **Amazon Q**. Si apre il pannello **Amazon Q: chat**. 1. Utilizza la finestra di chat per interagire con la tua personalizzazione. Per ulteriori informazioni sulle funzionalità di Q Developer, consulta [Utilizzo di Amazon Q Developer nell’IDE](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-in-IDE.html) in *Guida per l’utente di Amazon Q Developer*.