Configuration d’Amazon Q Developer pour vos utilisateurs - Amazon SageMaker AI
Personnalisations Amazon Q dans Amazon SageMaker AI

Configuration d’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 :

  • Recevoir des conseils étape par étape sur l’utilisation des fonctionnalités de SageMaker AI indépendamment ou en combinaison avec d’autres services AWS.

  • Obtenir un exemple de code pour prendre en main vos tâches ML, telles que la préparation des données, l’entraînement, l’inférence et MLOps.

  • Recevoir une assistance de dépannage afin de déboguer et de résoudre les erreurs rencontrées lors de l’exécution du code.

Note

Amazon Q Developer dans Studio n’utilise pas le contenu utilisateur pour améliorer le service, que vous utilisiez l’offre gratuite ou l’abonnement professionnel. À des fins de partage de télémétrie au niveau IDE, Amazon Q peut suivre l’utilisation de vos utilisateurs, par exemple le nombre de questions posées et si les recommandations ont été acceptées ou rejetées. Ces données de télémétrie n’incluent pas de données d’identification personnelle telles que l’adresse IP des utilisateurs. Pour plus d’informations sur la protection des données et les instructions de désinscription, consultez Désactivation du partage de données dans l’IDE.

Vous pouvez configurer Amazon Q Developer avec un abonnement de niveau Pro ou gratuit. 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 d’Amazon Q Developer.

Pour en savoir plus sur l’abonnement à Amazon Q Developer Pro, consultez Abonnement à Amazon Q Developer Pro.

Pour configurer l’offre gratuite d’Amazon Q Developer, procédez comme suit :

Pour configurer l’offre gratuite d’Amazon Q Developer

  1. Ajoutez la politique suivante au rôle IAM que vous avez utilisé pour créer votre espace JupyterLab ou d’éditeur de code :

    JSON
    {
	"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 espace JupyterLab ou d’éditeur de code.

  4. Accédez au Lanceur et choisissez Terminal.

  5. Dans JupyterLab, procédez comme suit :

    1. Spécifiez restart-jupyter-server.

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

Prérequis

Pour configurer Amazon Q Pro, vous devez avoir :

  • Un domaine Amazon SageMaker AI configuré pour votre entreprise 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 entreprise, vous devez le mettre à jour pour utiliser Amazon Q Developer. Vous pouvez utiliser la AWS Management Console ou l’AWS Command Line Interface pour mettre à jour un domaine.

Vous devez utiliser l’ARN de votre profil Amazon Q Developer. Vous trouverez l’ARN du profil Q sur la page des paramètres Q Developer.

Vous pouvez utiliser la commande AWS Command Line Interface 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 la AWS Management Console.

  1. Accédez à la console Amazon SageMaker AI.

  2. Choisissez les domaines.

  3. Sélectionnez Configurations des applications.

  4. Pour Applications Amazon Q Developer pour SageMaker AI, choisissez Modifier.

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

  6. Fournissez l’ARN du profil Q.

  7. Sélectionnez Soumettre.

Vous devez utiliser l’ARN de votre profil Amazon Q Developer. Vous trouverez l’ARN du profil Q sur la page Détails du compte Amazon Q de la console Amazon Q Developer.

L’option Configuration pour les organisations est une configuration avancée pour le domaine Amazon SageMaker AI qui vous permet d’utiliser IAM Identity Center. Pour en savoir plus sur la manière de configurer le domaine et sur la configuration d’IAM Identity Center, consultez Utilisation d’une configuration personnalisée pour Amazon SageMaker AI.

Lorsque vous configurez Amazon Q Developer dans un nouveau domaine, vous pouvez utiliser la AWS Management Console ou la commande suivante de l’AWS Command Line Interface 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 commande AWS CLI 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}"

Nous vous recommandons d’utiliser la dernière version de l’AWS Command Line Interface. Pour en savoir plus sur la mise à jour de l’AWS CLI, consultez Installation ou mise à jour de la version la plus récente de l’AWS Command Line Interface.

Si vous avez besoin d’établir une connexion entre Amazon Q Developer et votre VPC, consultez Création d’un point de terminaison de VPC d’interface pour Amazon Q.

Note

Amazon Q Developer a les limitations suivantes :

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

  • Amazon Q Developer détecte si une suggestion de code est trop similaire au code accessible publiquement. Le système de suivi des références peut signaler les suggestions à l’aide d’URL de référentiel et de licences, ou les filtrer. Cela vous permet de passer en revue le code référencé et son utilisation avant de l’adopter. Toutes les références sont consigné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 des 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 la Région AWS USA Est (Virginie du Nord). Pour plus d’informations sur la manière dont Amazon Q traite les données et les Régions AWS qu’il prend en charge, consultez Régions prises en charge pour Amazon Q Developer.

  • Amazon Q fonctionne uniquement dans Amazon SageMaker Studio. Il n’est pas pris en charge dans Amazon SageMaker Studio Classic.

  • Sur JupyterLab, Amazon Q fonctionne avec les images de distribution SageMaker AI de version 2.0 et ultérieures. Sur l’éditeur de code, Amazon Q fonctionne avec les images de distribution SageMaker AI de version 2.2.1 et supérieures.

  • Amazon Q Developer dans JupyterLab fonctionne avec l’extension Jupyter AI. Vous ne pouvez pas utiliser d’autres modèles 3P dans l’extension lorsque vous utilisez Amazon Q.

Personnalisations Amazon Q dans Amazon SageMaker AI

Si vous utilisez Amazon Q Developer Pro, vous avez la possibilité de créer des personnalisations. Grâce aux personnalisations, Amazon Q Developer fournit des suggestions basées sur la base de code de votre entreprise. Si vous créez des personnalisations dans Amazon Q Developer, vous pourrez les utiliser dans JupyterLab et dans l’éditeur de code dans Amazon SageMaker Studio. Pour plus d’informations sur la configuration des personnalisations, consultez Personnalisation des suggestions dans le Guide de l’utilisateur Amazon Q Developer.