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.
# Amazon Q Developer
Amazon Q Developer est un assistant conversationnel basé sur l’IA générative qui vous aide à écrire un meilleur code. Amazon Q Developer est disponible dans les versions suivantes IDEs dans Amazon SageMaker Studio :
+ JupyterLab
+ Éditeur de code, basé sur Code-OSS, Visual Studio Code – Open Source
Utilisez les sections suivantes pour configurer Amazon Q Developer et l’utiliser dans votre environnement.
**Topics**
+ [
# Configuration d’Amazon Q Developer pour vos utilisateurs
](studio-updated-amazon-q-admin-guide-set-up.md)
+ [
# Utilisation d’Amazon Q pour accélérer vos flux de travail de machine learning
](studio-updated-user-guide-use-amazon-q.md)
+ [
# Personnalisez Amazon Q Developer dans les applications Amazon SageMaker Studio
](q-customizations.md)
# 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 :
+ 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.
+ 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](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/opt-out-IDE.html).
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](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-tiers.html).
Pour en savoir plus sur l’abonnement à Amazon Q Developer Pro, consultez [Abonnement à Amazon Q Developer Pro](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-admin-setup-subscribe-general.html).
## Configuration des instructions pour l’offre gratuite d’Amazon Q Developer :
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 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": "*"
}
]
}
```
------
1. Accédez à Amazon SageMaker Studio.
1. Ouvrez votre espace JupyterLab ou celui de l'éditeur de code.
1. Accédez au **Lanceur** et choisissez **Terminal**.
1. Dans JupyterLab, procédez comme suit :
1. Spécifiez `restart-jupyter-server`.
1. Redémarrez votre navigateur et revenez à Amazon SageMaker Studio.
## Configuration des instructions pour l’offre Amazon Q Developer Pro :
**Conditions préalables**
Pour configurer Amazon Q Pro, vous devez avoir :
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 entreprise, 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 Amazon Q Developer. Vous trouverez l’ARN du profil Q sur la page des [paramètres Q Developer](https://console.aws.amazon.com/amazonq/developer/settings).
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 la AWS Management Console.
1. Accédez à la console [Amazon SageMaker AI](https://console.aws.amazon.com/sagemaker).
1. Choisissez les domaines.
1. Sélectionnez **Configurations des applications**.
1. Pour **Amazon Q Developer pour les applications d' SageMaker IA**, choisissez **Modifier**.
1. Sélectionnez **Activer Amazon Q Developer sur ce domaine**.
1. Fournissez l’ARN du profil Q.
1. 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](https://console.aws.amazon.com/amazonq/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 en savoir plus sur la manière de configurer le domaine et sur la configuration d’IAM Identity Center, consultez [Utiliser une configuration personnalisée pour Amazon SageMaker AI](onboard-custom.md).
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 de l’ 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](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
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](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/vpc-interface-endpoints.html#vpc-endpoint-create).
**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'un référentiel URLs 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 de références de code - Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/code-reference.html) et [AI Coding Assistant - Amazon Q Developer FAQs](https://aws.amazon.com/q/developer/faqs/?refid=255ccf7b-4a76-4dcb-9b07-68709e2b636b#:~:text=Can%20I%20prevent%20Amazon%20Q%20Developer%20from%20recommending%20code%20with%20code%20references%3F).
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](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/regions.html).
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 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.
## 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 [Personnalisation des suggestions](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html) dans le *Guide de l’utilisateur Amazon Q Developer*.
# Utilisation d’Amazon Q pour accélérer vos flux de travail de machine learning
Amazon Q Developer est votre compagnon basé sur l’IA pour le développement du machine learning. Avec Amazon Q Developer, vous pouvez :
+ 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.
Pour utiliser Amazon Q Developer, choisissez le **Q** dans le menu de navigation de gauche de votre environnement JupyterLab ou de celui de Code Editor.
Si vous ne voyez pas l’icône **Q**, votre administrateur doit la configurer pour vous. Pour plus d’informations sur la configuration d’Amazon Q Developer, consultez [Configuration d’Amazon Q Developer pour vos utilisateurs](studio-updated-amazon-q-admin-guide-set-up.md).
Amazon Q fournit automatiquement des suggestions pour vous aider à écrire votre code. Vous pouvez également demander des suggestions via l’interface de chat.
# Personnalisez Amazon Q Developer dans les applications Amazon SageMaker Studio
Vous pouvez personnaliser Amazon Q Developer dans les applications JupyterLab et Code Editor d'Amazon SageMaker Studio. Lorsque vous personnalisez Q Developer, il fournit des suggestions et des réponses basées sur des exemples tirés de votre base de code. Si vous utilisez Amazon Q Developer Pro, vous pouvez charger toutes les personnalisations que vous avez créées avec ce service.
## Personnaliser dans JupyterLab
Dans JupyterLab, vous pouvez charger toutes les personnalisations que vous avez créées avec Amazon Q Developer Pro. Ou, dans votre JupyterLab espace, vous pouvez personnaliser Q Developer localement avec des fichiers que vous téléchargez dans l'espace.
### Pour utiliser les personnalisations que vous avez créées dans Amazon Q Developer Pro
Lorsque vous chargez une personnalisation, Q Developer fournit des suggestions basées sur la base de code que vous avez utilisée pour créer la personnalisation. De plus, lorsque vous utilisez le chat dans le panneau **Amazon Q**, vous interagissez avec votre personnalisation.
Pour plus d’informations sur la configuration des personnalisations, consultez [Personnalisation des suggestions](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html) dans le *Guide de l’utilisateur Amazon Q Developer*.
**Pour charger votre personnalisation**
Ouvrez votre JupyterLab espace et effectuez les étapes suivantes.
1. Dans la barre d'état en bas de JupyterLab, sélectionnez **Amazon Q.** Un menu s'ouvre.
1. Dans ce menu, choisissez **Autres fonctionnalités**. L’onglet **Fonctionnalités Amazon Q** s’ouvre dans la zone de travail principale.
1. Dans l’onglet **Fonctionnalités Amazon Q**, sous **Sélectionner une personnalisation**, choisissez votre personnalisation Q Developer.
1. Interagissez avec votre personnalisation de l’une des manières suivantes :
+ Créez un bloc-notes et écrivez-y du code. Au fur et à mesure, Q Developer fournit automatiquement des suggestions en ligne personnalisées en fonction de votre personnalisation.
+ Discutez avec Q Developer dans le panneau **Amazon Q** en suivant ces étapes :
1. Dans la barre latérale gauche JupyterLab, choisissez l'icône **Jupyter AI Chat**. Le panneau **Amazon Q** s’ouvre.
1. Utilisez la boîte de discussion **Poser une question à Amazon Q** pour interagir avec votre personnalisation.
### Pour personnaliser Amazon Q Developer avec des fichiers dans votre JupyterLab espace
Dans JupyterLab, vous pouvez personnaliser Q Developer avec des fichiers que vous téléchargez sur votre espace. Ensuite, dans le chat du panneau **Amazon Q**, vous pouvez utiliser une commande pour interroger Q Developer à propos de ces fichiers.
Lorsque vous personnalisez Q Developer avec des fichiers dans votre espace, la personnalisation existe uniquement dans votre espace. Vous ne pouvez pas charger la personnalisation ailleurs, par exemple dans d’autres espaces ou dans la console Amazon Q Developer.
Vous pouvez personnaliser Q Developer avec des fichiers JupyterLab si vous utilisez Amazon Q Developer Pro ou Amazon Q Developer au niveau gratuit.
**Pour personnaliser avec vos fichiers**
Ouvrez votre JupyterLab espace et effectuez les étapes suivantes.
1. Vérifiez si votre espace est configuré avec le modèle de vectorisation requis. Vous ne pouvez personnaliser Q Developer JupyterLab que si vous utilisez le modèle d'intégration par défaut, à savoir **CodeSage : codesage-small**. Pour vérifier, procédez comme suit :
1. Dans la barre latérale gauche JupyterLab, choisissez l'icône **Jupyter AI Chat**. Le panneau **Amazon Q** s’ouvre.
1. Choisissez l’icône de paramètres dans le coin supérieur droit du panneau.
1. **Pour le **modèle d'intégration**, si nécessaire, choisissez **CodeSage : : codesage-small**, puis cliquez sur Enregistrer les modifications.**
1. Dans le coin supérieur droit du panneau, choisissez l’icône Précédent.
1. Pour charger les fichiers avec lesquels vous souhaitez personnaliser Q Developer, dans le panneau **Explorateur de fichiers**, choisissez l’icône **Charger des fichiers**.
1. Après avoir chargé vos fichiers, dans la boîte de discussion **Poser une question à Amazon Q**, saisissez `/learn file path/`. Remplacez *le chemin du fichier/* par le chemin d'accès à vos fichiers dans votre JupyterLab espace. Lorsque Amazon Q a terminé de traiter vos fichiers, il le confirme par un message de discussion dans le panneau Amazon Q.
1. Pour poser une question à Q Developer sur vos fichiers, saisissez `/ask` dans la boîte de discussion et suivez la commande correspondant à votre question. Amazon Q génère une réponse basée sur vos fichiers et répond dans le chat.
Pour plus d’informations sur les commandes `/learn` et `/ask`, telles que leurs options et les arguments pris en charge, consultez [Learning about local data](https://jupyter-ai.readthedocs.io/en/latest/users/index.html#learning-about-local-data) dans la documentation utilisateur de Jupyter AI. Cette page explique comment utiliser les commandes avec le chatbot Jupyternaut AI. JupyterLabdans Amazon SageMaker Studio, prend en charge la même syntaxe de commande.
## Personnalisation dans l’éditeur de code
Si vous avez créé une personnalisation dans Amazon Q Developer Pro, vous pouvez la charger dans l’éditeur de code. Ensuite, lorsque Q Developer propose des suggestions pour votre code, il les base sur la base de code que vous avez utilisée pour créer la personnalisation. De plus, lorsque vous utilisez le chat dans le panneau **Amazon Q : Chat**, vous interagissez avec votre personnalisation.
**Pour utiliser les personnalisations que vous avez créées dans Amazon Q Developer Pro**
Ouvrez votre espace d’éditeur de code et effectuez les étapes suivantes.
1. Dans le menu de l’éditeur de code, choisissez **Afficher**, puis **Palette de commandes**.
1. Dans la palette de commandes, commencez à saisir **>Amazon Q: Select Customization** et choisissez cette option dans la liste filtrée des commandes lorsqu’elle apparaît. La palette de commandes affiche vos personnalisations de Q Developer.
1. Choisissez votre personnalisation.
1. Interagissez avec votre personnalisation de l’une des manières suivantes :
+ Créez un fichier Python ou un bloc-notes Jupyter et écrivez-y du code. Au fur et à mesure, Q Developer fournit automatiquement des suggestions en ligne personnalisées en fonction de votre personnalisation.
+ Discutez avec Q Developer dans le panneau **Amazon Q** en suivant ces étapes :
1. Dans la barre latérale gauche de l’éditeur de code, choisissez l’icône **Amazon Q**. Le panneau **Amazon Q : Chat** s’ouvre.
1. Utilisez la boîte de discussion pour interagir avec votre personnalisation.
Pour plus d’informations sur les fonctionnalités de Q Developer, consultez [Utilisation d’Amazon Q Developer dans l’IDE](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-in-IDE.html) dans le *Guide de l’utilisateur Amazon Q Developer*.