Configurez Amazon Q Developer pour vos utilisateurs - Amazon SageMaker

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configurez Amazon Q Developer pour vos utilisateurs

Amazon Q Developer est un assistant conversationnel basé sur l'IA générative. Vous pouvez configurer Amazon Q Developer au sein d'un nouveau domaine ou d'un domaine existant. Utilisez les informations suivantes pour configurer Amazon Q Developer.

Avec Amazon Q Developer, vos utilisateurs peuvent :

  • Recevez des step-by-step conseils sur l'utilisation SageMaker des fonctionnalités indépendamment ou en combinaison avec d'autres AWS services.

  • Obtenez un exemple de code pour démarrer vos tâches de machine learning telles que la préparation des données, la formation, l'inférence etMLOps.

  • Bénéficiez d'une assistance pour le dépannage afin de déboguer et de résoudre les erreurs rencontrées lors de l'exécution du code dans JupyterLab.

Note

Amazon Q Developer in Studio n'utilise pas de contenu utilisateur pour améliorer le service, que vous utilisiez l'abonnement gratuit ou professionnel. Pour le IDE partage de télémétrie au niveau du système, Amazon Q peut suivre l'utilisation de vos utilisateurs, notamment le nombre de questions posées et l'acceptation ou le rejet des recommandations. Ces données de télémétrie n'incluent pas d'informations personnellement identifiables telles que l'adresse IP des utilisateurs. Pour plus d'informations sur la protection des données et les instructions pour vous désinscrire, voir Désactiver le partage des données dans le IDE.

Vous pouvez configurer Amazon Q Developer avec un abonnement de niveau Pro ou Free. Le niveau Pro est un service d'abonnement payant avec des limites d'utilisation plus élevées et d'autres fonctionnalités. Pour plus d'informations sur les différences entre les niveaux, consultez Comprendre les niveaux de service pour Amazon Q Developer.

Pour plus d'informations sur l'abonnement à Amazon Q Developer Pro, consultez la section Abonnement à Amazon Q Developer Pro.

Pour configurer Amazon Q Developer Free Tier dans le cadre du programme JupyterLab, suivez la procédure suivante :

Pour configurer le niveau gratuit d'Amazon Q Developer

  1. Ajoutez la politique suivante au IAM rôle que vous avez utilisé pour créer votre JupyterLab espace :

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

  2. Accédez à Amazon SageMaker Studio.

  3. Ouvrez votre JupyterLab espace.

  4. Accédez au lanceur et choisissez Terminal.

  5. Spécifiez restart-jupyter-server.

  6. Redémarrez votre navigateur et revenez à Amazon SageMaker Studio.

Prérequis

Pour configurer Amazon Q Pro dans Amazon Q Pro JupyterLab, vous devez disposer des éléments suivants :

  • Un SageMaker domaine Amazon configuré pour votre organisation avec IAM Identity Center configuré comme moyen d'accès.

  • Un abonnement Amazon Q Developer Pro.

Si vous mettez à jour un domaine que vous avez déjà configuré pour votre organisation, vous devez le mettre à jour pour utiliser Amazon Q Developer. Vous pouvez utiliser le AWS Management Console ou le AWS Command Line Interface pour mettre à jour un domaine.

Vous devez utiliser l'ARNidentifiant de votre profil de développeur Amazon Q. Vous pouvez trouver le profil Q ARN sur la page des paramètres Q Developer.

Vous pouvez utiliser la AWS Command Line Interface commande suivante pour mettre à jour votre domaine :


aws --region Région AWS sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=ENABLED,QProfileArn=Q-Profile-ARN}"

Vous pouvez également utiliser la procédure suivante pour mettre à jour le domaine dans le AWS Management Console.

  1. Accédez à la SageMaker console Amazon.

  2. Choisissez des domaines.

  3. Sélectionnez Configurations d'applications.

  4. Pour Amazon Q Developer for SageMaker Applications, choisissez Modifier.

  5. Sélectionnez Activer Amazon Q Developer sur ce domaine.

  6. Fournissez le profil ARN Q.

  7. Sélectionnez Envoyer.

Vous devez utiliser l'ARNidentifiant de votre profil de développeur Amazon Q. Vous trouverez le profil Q sur la page ARN des détails du compte Amazon Q de la console Amazon Q Developer.

La configuration pour les organisations est une configuration avancée pour le SageMaker domaine Amazon qui vous permet IAM d'utiliser Identity Center. Pour plus d'informations sur la configuration du domaine et sur la configuration IAM d'Identity Center, consultezUtiliser une configuration personnalisée pour Amazon SageMaker.

Lorsque vous configurez Amazon Q Developer dans un nouveau domaine, vous pouvez utiliser la commande AWS Management Console ou la AWS Command Line Interface commande suivante depuis votre ordinateur local :


                    
aws --region Région 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

Vous pouvez utiliser la AWS CLI commande suivante pour désactiver Amazon Q Developer :


aws --region Région AWS sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=DISABLED,QProfileArn=Q-Profile-ARN}"

Vous pouvez configurer Amazon Q Developer au sein d'un nouveau domaine ou d'un domaine existant. Utilisez les informations suivantes pour configurer Amazon Q Developer.

Nous vous recommandons d'utiliser la dernière version du AWS Command Line Interface. Pour plus d'informations sur la mise à jour du AWS CLI, voir Installer ou mettre à jour vers la dernière version du AWS Command Line Interface.

Si vous devez établir une connexion entre Amazon Q Developer et votreVPC, consultez Création d'un point de VPC terminaison d'interface pour Amazon Q.

Note

Amazon Q Developer présente les limites suivantes :

  • Il ne prend pas en charge les espaces partagés.

  • Amazon Q Developer JupyterLab détecte si une suggestion de code est peut-être trop similaire au code accessible au public. Le système de suivi des références peut signaler les suggestions à l'aide d'un référentiel URLs et de licences, ou les filtrer. Cela vous permet de revoir le code référencé et son utilisation avant de l'adopter. Toutes les références sont enregistrées pour que vous puissiez les consulter ultérieurement afin de vous assurer que votre flux de code n'est pas perturbé et que vous pouvez continuer à coder sans interruption.

    Pour plus d'informations sur les références de code, consultez Utilisation de références de code - Amazon Q Developer et AI Coding Assistant - Amazon Q Developer FAQs.

  • Amazon Q traite toutes les données d'interaction utilisateur dans l'est des États-Unis (Virginie du Nord) Région AWS. Pour plus d'informations sur la manière dont Amazon Q traite les données et les Régions AWS prend en charge, consultez la section Régions prises en charge par Amazon Q Developer.

  • Amazon Q ne fonctionne que dans Amazon SageMaker Studio. Il n'est pas pris en charge dans Amazon SageMaker Studio Classic.

  • Amazon Q fonctionne avec les versions 2.0 et supérieures de SageMaker Distribution Images.

  • Amazon Q fonctionne dans le cadre de l'extension Jupyter AI. Vous ne pouvez pas utiliser d'autres modèles 3P dans l'extension lorsque vous utilisez Amazon Q.