Configura Amazon Q Developer per i tuoi utenti - Amazon SageMaker AI
Personalizzazioni di Amazon Q in Amazon SageMaker AI

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

Configura Amazon Q Developer per i tuoi utenti

Amazon Q Developer è un assistente conversazionale generativo basato sull'intelligenza artificiale. Puoi configurare Amazon Q Developer all'interno di un nuovo dominio o di un dominio esistente. Utilizza le seguenti informazioni 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.

  • Ricevi assistenza nella risoluzione dei problemi per eseguire il debug e risolvere 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 fatto che tu utilizzi l'abbonamento Free-tier o Pro-tier. Per la condivisione della telemetria a livello IDE, Amazon Q potrebbe tenere traccia dell'utilizzo degli utenti, ad esempio il numero di domande poste e se i consigli sono stati accettati o rifiutati. Questi dati di telemetria non includono informazioni di identificazione personale come l'indirizzo IP degli utenti. Per ulteriori informazioni sulla protezione dei dati e sulle istruzioni per la disattivazione, consulta Disattivazione della condivisione dei dati nell'IDE.

Puoi configurare Amazon Q Developer con un abbonamento di livello Pro o Free. Il livello 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.

Per informazioni sull'abbonamento ad Amazon Q Developer Pro, consulta Abbonamento ad Amazon Q Developer Pro.

Per configurare il piano gratuito di Amazon Q Developer, utilizza la seguente procedura:

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:

    {
	"Version": "2012-10-17",
	"Statement": [
		{
			"Effect": "Allow",
			"Action": [
				"q:SendMessage"
			],
			"Resource": [
				"*"
			]
		},
		{
			"Sid": "AmazonQDeveloperPermissions",
			"Effect": "Allow",
			"Action": [
				"codewhisperer:GenerateRecommendations"
			],
			"Resource": "*"
		}
	]
}

  2. Accedi ad Amazon SageMaker Studio.

  3. Apri il tuo spazio JupyterLab o Code Editor.

  4. Vai al Launcher e scegli Terminale.

  5. Nel JupyterLab, procedi come segue:

    1. Specifica restart-jupyter-server.

    2. Riavvia il browser e torna ad Amazon SageMaker Studio.

Prerequisiti

Per configurare Amazon Q Pro, devi avere:

  • 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 usare il AWS Management Console 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 Q 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}"

È inoltre possibile utilizzare la procedura seguente per aggiornare il dominio all'interno di AWS Management Console.

  1. Accedi alla console Amazon SageMaker AI.

  2. Scegli i domini.

  3. Seleziona Configurazioni dell'app.

  4. Per Amazon Q Developer for SageMaker AI Applications, scegli Modifica.

  5. Seleziona Abilita Amazon Q Developer su questo dominio.

  6. Fornire l'ARN del profilo Q.

  7. Scegli 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 Amazon Q 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 informazioni sulla configurazione di IAM Identity Center, consultaUsa una configurazione personalizzata per Amazon SageMaker AI.

Quando configuri Amazon Q Developer in un nuovo dominio, puoi utilizzare il comando AWS Management Console 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 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.

Se devi stabilire una connessione tra Amazon Q Developer e il tuo VPC, consulta Creazione di un endpoint VPC di interfaccia per Amazon Q.

Nota

Amazon Q Developer presenta le seguenti limitazioni:

  • 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. Ciò consente di rivedere il codice di riferimento e il suo utilizzo prima di adottarlo. Tutti i riferimenti vengono registrati per consentirvi di esaminarli in un secondo momento per garantire che il flusso di codice non venga disturbato e che possiate continuare a scrivere codice senza interruzioni.

    Per ulteriori informazioni sui riferimenti al codice, consulta Uso dei riferimenti al codice - Amazon Q Developer e AI Coding Assistant - Amazon Q Developer FAQs.

  • Amazon Q elabora tutti i dati di interazione degli utenti negli Stati Uniti orientali (Virginia settentrionale) Regione AWS. Per ulteriori informazioni su come Amazon Q elabora i dati e su Regioni AWS ciò che supporta, consulta Regioni supportate per Amazon Q Developer.

  • 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 usi Amazon Q.

Personalizzazioni di Amazon Q in Amazon SageMaker AI

Se usi Amazon Q Developer Pro, hai la possibilità di creare personalizzazioni. Con le personalizzazioni, Amazon Q Developer fornisce suggerimenti basati sulla base di codice 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 Suggerimenti di personalizzazione nella Amazon Q Developer User Guide.