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

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:

  • Ricevere una guida dettagliata sull’utilizzo delle funzionalità SageMaker AI indipendentemente o in combinazione con altri servizi AWS.

  • Ottenere codice di esempio per iniziare le attività di ML, come la preparazione dei dati, l’addestramento, 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 policy seguente al ruolo IAM utilizzato per creare il tuo spazio JupyterLab o Editor di codice:

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

  2. Passa ad Amazon SageMaker Studio.

  3. Apri lo spazio JupyterLab o Editor di codice.

  4. Vai all’utilità di avvio e scegli Terminale.

  5. In JupyterLab, procedi come descritto di seguito:

    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 il Centro identità IAM configurato come metodo 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 la Console di gestione AWS o la 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 utilizzare il comando AWS Command Line Interface seguente per aggiornare il 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. Vai alla console di Amazon SageMaker AI.

  2. Scegli Domini.

  3. Seleziona Configurazioni dell’app.

  4. In Amazon Q Developer per applicazioni SageMaker AI, scegli Modifica.

  5. Seleziona Abilita Amazon Q Developer su questo dominio.

  6. Fornisci 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 di Amazon Q Developer.

L’opzione Configura per un’organizzazione è una configurazione avanzata per il dominio Amazon SageMaker AI che consente di utilizzare il Centro identità IAM. Per informazioni su come configurare il dominio e il Centro identità IAM, consulta Utilizzo della configurazione personalizzata per Amazon SageMaker AI.

Quando configuri Amazon Q Developer in un nuovo dominio, puoi utilizzare la Console di gestione AWS o il comando AWS Command Line Interface seguente dal 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 comando AWS CLI seguente 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 della AWS CLI, consulta Installazione o aggiornamento alla versione più recente della 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 tracker di riferimento può contrassegnare i suggerimenti con URL e licenze del repository 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 Utilizzo dei riferimenti del codice - Amazon Q Developer e Assistente per il codice IA - Domande frequenti di Amazon Q Developer.

  • 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 all’interno di Amazon SageMaker Studio. Non è supportato in Amazon SageMaker Studio Classic.

  • Su JupyterLab, Amazon Q funziona con SageMaker AI Distribution Images versione 2.0 e successive. Sull’Editor di codice, Amazon Q funziona con SageMaker AI Distribution Images versione 2.2.1 e successive.

  • Amazon Q Developer in JupyterLab funziona all’interno dell’estensione Jupyter AI. 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 possono essere utilizzate in JupyterLab e nell’Editor di codice in Amazon SageMaker Studio. Per ulteriori informazioni sulla configurazione delle personalizzazioni, consulta Personalizzazione dei suggerimenti nella Guida per l’utente di Amazon Q Developer.