Gestion des agents personnalisés - Amazon Q Developer
Emplacements des fichiers des agents personnalisésBonnes pratiques relatives à l’organisation des agents personnalisésPartage d’agents personnalisés avec les équipes

Gestion des agents personnalisés

Cette section explique comment organiser, gérer et utiliser efficacement des agents personnalisés dans votre flux de travail de développement.

Emplacements des fichiers des agents personnalisés

Les fichiers de configuration des agents personnalisés sont stockés sous forme de fichiers JSON dans des répertoires spécifiques :

Agents personnalisés globaux

~/.aws/amazonq/cli-agents/{agent-name}.json

Disponibles dans tous les projets et répertoires de votre système.

Agents personnalisés spécifiques au projet

.amazonq/cli-agents/{agent-name}.json

Disponibles uniquement dans le répertoire et les sous-répertoires du projet concerné.

Important : le {agent-name} contenu dans le nom de fichier est fourni à titre indicatif uniquement. Le nom réel de l’agent est déterminé par le champ name du fichier de configuration JSON lui-même, qui est obligatoire.

Ordre de priorité des agents personnalisés et résolution des conflits

Lorsque l’interface de ligne de commande d’Amazon Q Developer recherche un agent personnalisé, elle suit un ordre de priorité spécifique :

  1. Agents personnalisés locaux en premier : vérifie la présence d’agents personnalisés dans le répertoire de travail en cours

  2. Agents personnalisés globaux en deuxième : passe aux agents personnalisés de votre répertoire personnel

  3. Par défaut intégré : utilise l’agent par défaut si aucun agent personnalisé n’est trouvé

Si les répertoires locaux et globaux comprennent des agents personnalisés portant le même nom, l’agent personnalisé local a la priorité. L’interface de ligne de commande d’Amazon Q Developer affiche un message d’avertissement lorsque cela se produit :

WARNING: Agent conflict for my-agent. Using workspace version.

Ce système de priorité vous permet de :

  • remplacer les agents personnalisés globaux par des versions spécifiques au projet ;

  • tester les modifications des agents personnalisés localement avant de les appliquer globalement ;

  • gérer différentes configurations d’agents personnalisés pour différents projets.

Bonnes pratiques relatives à l’organisation des agents personnalisés

Quand utiliser des agents personnalisés globaux

Utilisez des agents personnalisés globaux dans les cas suivants :

  • Flux de travail à usage général : agents personnalisés utilisés dans le cadre de plusieurs projets

  • Productivité personnelle : agents personnalisés adaptés à votre style de travail

  • Tâches de développement courantes : révision de code, débogage, génération de documentation

  • Flux de travail spécifiques aux outils : gestion AWS, opérations Git, flux de travail Docker

Quand utiliser des agents personnalisés locaux

Utilisez des agents personnalisés locaux dans les cas suivants :

  • Configurations spécifiques au projet : agents personnalisés ayant besoin d’accéder à des fichiers spécifiques du projet

  • Collaboration en équipe : agents personnalisés partagés dans le cadre du contrôle des versions

  • Environnements de développement : agents personnalisés ayant des exigences uniques pour des projets spécifiques

  • Tests et expérimentation : modifications temporaires des agents personnalisés sans affecter les paramètres globaux

Convention de dénomination des agents personnalisés

Tenez compte des conventions de dénomination suivantes pour une meilleure organisation des agents personnalisés :

  • Noms basés sur la finalité : aws-specialist.json, code-reviewer.json, documentation-writer.json

  • Noms spécifiques à la technologie : python-dev.json, react-frontend.json, terraform-ops.json

  • Noms spécifiques au projet : project-alpha.json, mobile-app.json, api-backend.json

  • Noms spécifiques à l’environnement : development.json, staging.json, production.json

Partage d’agents personnalisés avec les équipes

Les agents personnalisés locaux peuvent être partagés avec les membres de l’équipe via des systèmes de contrôle des versions. Cette approche permet aux équipes de :

  • Normaliser les environnements de développement : assurez-vous que tous les membres de l’équipe ont accès aux mêmes outils et configurations

  • Partager le contexte spécifique au projet : incluez la documentation, les normes de codage et les scripts personnalisés du projet

  • Maintenir la cohérence : utilisez les mêmes autorisations et paramètres d’outils au sein de l’équipe

  • Collaborer sur les améliorations : utilisez des demandes de tirage pour revoir et améliorer les configurations des agents personnalisées

Bonnes pratiques pour le contrôle des versions

Lorsque vous partagez des agents personnalisés dans le cadre du contrôle des versions :

  • Incluez les répertoires des agents personnalisés : ajoutez .aws/amazonq/agents/ à votre référentiel

  • Documentez la finalité des agents personnalisés : utilisez des descriptions claires dans les fichiers de configuration des agents personnalisés

  • Vérifiez les modifications apportées aux agents personnalisés : traitez les modifications de configuration des agents personnalisés comme des modifications de code

  • Testez les configurations des agents personnalisés : vérifiez que les agents personnalisés partagés fonctionnent correctement pour tous les membres de l’équipe

  • Évitez les informations sensibles : n’incluez pas de clés d’API, de mots de passe ou d’informations personnelles dans les agents personnalisés partagés