Gestion des agents personnalisés - Amazon Q Developer
Emplacements des fichiers d'agents personnalisésMeilleures pratiques pour organiser les agents des douanesPartage d'agents personnalisés avec les équipes

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.

Gestion des agents personnalisés

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

Emplacements des fichiers d'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 mondiaux

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

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

Agents personnalisés au niveau du projet

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

Disponible uniquement dans le répertoire du projet spécifique et ses sous-répertoires.

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

Priorité personnalisée des agents et résolution des conflits

Lorsque la CLI Amazon Q Developer recherche un agent personnalisé, elle suit un ordre de priorité spécifique :

  1. Agents personnalisés locaux d'abord - Vérifie la présence d'agents personnalisés dans le répertoire de travail actuel

  2. Les agents personnalisés internationaux viennent ensuite : revenez 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 annuaires local et global contiennent des agents personnalisés portant le même nom, l'agent personnalisé local a priorité. La CLI 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 :

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

  • Testez les modifications des agents personnalisés localement avant de les rendre globales

  • Maintenir différentes configurations d'agents personnalisés pour différents projets

Meilleures pratiques pour organiser les agents des douanes

Quand utiliser des agents personnalisés globaux

Utilisez des agents personnalisés globaux pour :

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

  • Productivité personnelle - Des agents personnalisés adaptés à votre style de travail individuel

  • Tâches de développement courantes : révision du 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 de douane locaux

Utilisez des agents personnalisés locaux pour :

  • Configurations spécifiques au projet - Agents personnalisés ayant besoin d'accéder à des fichiers de projet spécifiques

  • Collaboration en équipe : agents personnalisés partagés via le contrôle de version

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

  • Tests et expérimentation - Modifications temporaires de l'agent personnalisé sans affecter les paramètres globaux

Conventions de dénomination des agents personnalisées

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

  • Noms basés sur des objectifs -,, 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 de version. Cette approche permet aux équipes de :

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

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

  • Maintien de la cohérence : utilisez les mêmes autorisations et paramètres d'outil au sein de l'équipe

  • Collaborez sur les améliorations : utilisez des pull requests pour revoir et améliorer les configurations d'agents personnalisées

Bonnes pratiques en matière de contrôle de version

Lorsque vous partagez des agents personnalisés via le contrôle de version :

  • Inclure des annuaires d'agents personnalisés - Ajoutez .aws/amazonq/agents/ à votre référentiel

  • Documentez les objectifs 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 d'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