Configurez Amazon Q Developer pour vos utilisateurs - Amazon SageMaker AI
Personnalisations d'Amazon Q dans Amazon SageMaker AI

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 des fonctionnalités de l' SageMaker IA 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 et MLOps.

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

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 partage de télémétrie au niveau de l'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 d'informations personnellement identifiables telles que l'adresse IP des utilisateurs. Pour plus d'informations sur la protection des données et les instructions de désinscription, voir Désactiver le partage des données dans l'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 le niveau gratuit d'Amazon Q Developer, suivez la procédure suivante :

Pour configurer le niveau gratuit d'Amazon Q Developer

  1. Ajoutez la politique suivante au rôle IAM que vous avez utilisé pour créer votre espace JupyterLab ou celui de l'é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 celui de l'é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 disposer des éléments suivants :

  • Un domaine Amazon SageMaker AI 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'ARN de votre profil de développeur Amazon Q. Vous trouverez l'ARN du profil Q 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 console Amazon SageMaker AI.

  2. Choisissez des domaines.

  3. Sélectionnez Configurations de l'application.

  4. Pour Amazon Q Developer pour les applications d' SageMaker IA, choisissez Modifier.

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

  6. Fournissez l'ARN du profil Q.

  7. Sélectionnez Envoyer.

Vous devez utiliser l'ARN de votre profil de développeur Amazon Q. Vous trouverez l'ARN du profil Q sur la page 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 domaine Amazon SageMaker AI qui vous permet d'utiliser IAM Identity Center. Pour plus d'informations sur la configuration du domaine et sur la configuration d'IAM Identity Center, consultezUtiliser une configuration personnalisée pour Amazon SageMaker AI.

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

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 votre VPC, consultez Création d'un point de terminaison VPC 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 détecte si une suggestion de code est 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.

  • JupyterLabActivé, Amazon Q fonctionne avec SageMaker AI Distribution Images version 2.0 et ultérieure. Sur Code Editor, Amazon Q fonctionne avec SageMaker AI Distribution Images version 2.2.1 et supérieure.

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

Personnalisations d'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 Amazon SageMaker Studio JupyterLab et dans l'éditeur de code. Pour plus d'informations sur la configuration des personnalisations, consultez la section Suggestions de personnalisation du manuel Amazon Q Developer User Guide.