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

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.

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.

Per informazioni sull’abbonamento ad Amazon Q Developer Pro, consulta Subscribing to Amazon Q Developer Pro.

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": "*"
		}
	]
}

  2. Accedi ad Amazon SageMaker Studio.

  3. Apri il tuo spazio JupyterLab o Code Editor.

  4. Vai all’utilità di avvio 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, è 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.

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.

  2. Scegli 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. Fornisci l’ARN del profilo Q.

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

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.

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 diAWS 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 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 e AI Coding Assistant - Amazon Q Developer FAQs.

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

  • 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 nella Guida per l’utente di Amazon Q Developer.