Configura Amazon Q Developer per i tuoi utenti - Amazon SageMaker

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'utilizzo SageMaker delle funzionalità 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 eMLOps.

  • Ricevi assistenza nella risoluzione dei problemi per eseguire il debug e risolvere gli errori riscontrati durante l'esecuzione del codice in. JupyterLab

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 quanto riguarda IDE la condivisione telemetrica, 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 la sezione Disattivazione della condivisione dei dati nel. 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 Amazon Q Developer Free Tier entro JupyterLab, utilizza la seguente procedura:

Per configurare il piano gratuito di Amazon Q Developer

  1. Aggiungi la seguente politica al IAM ruolo che hai utilizzato per creare il tuo JupyterLab spazio:

    {
	"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 JupyterLab spazio.

  4. Vai al Launcher e scegli Terminale.

  5. Specifica restart-jupyter-server.

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

Prerequisiti

Per configurare Amazon Q Pro entro JupyterLab, devi avere:

  • Un SageMaker dominio Amazon 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 il ARN tuo profilo Amazon Q Developer. Puoi trovare il profilo ARN 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 SageMaker console Amazon.

  2. Scegli i domini.

  3. Seleziona Configurazioni dell'app.

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

  5. Seleziona Abilita Amazon Q Developer su questo dominio.

  6. Fornisci il profilo ARN Q.

  7. Scegli Invia.

Devi utilizzare il ARN tuo profilo Amazon Q Developer. Puoi trovare il profilo Q nella pagina ARN dei dettagli dell'account Amazon Q della console Amazon Q Developer.

La configurazione per le organizzazioni è una configurazione avanzata per il SageMaker dominio Amazon 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.

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}"

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.

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 tuoVPC, consulta Creazione di un VPC endpoint di interfaccia per Amazon Q.

Nota

Amazon Q Developer presenta le seguenti limitazioni:

  • Non supporta gli spazi condivisi.

  • Amazon Q Developer in JupyterLab 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.

  • Amazon Q funziona con SageMaker Distribution Images versione 2.0 e successive.

  • Amazon Q funziona con l'estensione AI di Jupyter. Non puoi utilizzare altri modelli 3P all'interno dell'estensione mentre usi Amazon Q.