Définition d’un agent personnalisé - Amazon Q Developer
Création de votre premier agent personnaliséCommandes des agents personnalisésMigration d’anciens profilsUtilisation de l’agent par défaut ou d’agents personnalisés

Définition d’un agent personnalisé

Cette section explique comment créer et utiliser des agents personnalisés dans votre flux de travail dans l’interface de ligne de commande d’Amazon Q Developer.

Création de votre premier agent personnalisé

Voici un guide étape par étape pour créer votre premier agent personnalisé :

  1. Démarrez une session de chat dans l’interface de ligne de commande d’Amazon Q Developer :

    $ q chat

  2. Répertoriez les agents existants pour voir ceux qui sont disponibles :

    /agent list

  3. Créez un agent (remplacez my-agent par le nom de votre choix) :

    /agent create --name my-agent

    Le fichier de configuration de l’agent est créé et s’ouvre dans votre éditeur par défaut (défini via la variable d’environnement EDITOR).

  4. Personnalisez la configuration de l’agent personnalisé selon vos besoins. Pour commencer simplement, vous pouvez :

    • ajouter une description expliquant la finalité de l’agent personnalisé ;

    • spécifier les outils qui devraient être disponibles ;

    • préapprouver les outils que vous utilisez fréquemment ;

  5. enregistrer le fichier de configuration et quitter votre éditeur pour revenir à la session de chat.

  6. Démarrez une nouvelle session de chat avec votre agent personnalisé :

    $ q chat --agent my-agent

    Remarque : vous ne pouvez pas changer d’agent personnalisé dans une session de chat existante. Les modifications apportées à l’agent personnalisé nécessitent le démarrage d’une nouvelle session de chat pour prendre effet.

  7. Testez votre agent personnalisé en lui demandant d’effectuer des tâches à l’aide des outils que vous avez configurés.

Pour plus d’informations sur les options de configuration des agents personnalisés, consultez Référence de configuration.

Commandes des agents personnalisés

L’interface de ligne de commande d’Amazon Q Developer fournit plusieurs commandes de gestion des agents personnalisés. Ces commandes sont disponibles pendant une session de chat et commencent par /agent.

Commandes des agents personnalisés
Commande Description Disponibilité
/agent list Affiche tous les agents personnalisés disponibles dans votre environnement Session de chat
/agent schema Affiche le schéma JSON permettant de créer les fichiers de configuration des agents personnalisés Session de chat
/agent create --name [name] Crée un fichier de configuration pour l’agent personnalisé et l’ouvre dans votre éditeur par défaut Session de chat

Remarque : certaines opérations de gestion des agents personnalisés nécessitent une modification manuelle des fichiers plutôt que des commandes interactives. Les modifications apportées aux agents personnalisés prennent effet lorsque vous démarrez une nouvelle session de chat.

Migration d’anciens profils

Si vous effectuez une mise à jour vers une version de l’interface de ligne de commande d’Amazon Q Developer qui prend en charge les agents, lorsque vous vous connectez, vous pouvez être invité à migrer vos anciens profils vers vos agents si :

  • vos anciens profils possèdent une configuration ;

  • vous êtes en mode interactif (la migration est ignorée avec --no-interactive) ;

  • vous n’avez pas encore terminé le processus de migration.

Le processus de migration :

  • convertit les configurations des profils existants au format du nouvel agent ;

  • préserve les autorisations et les paramètres contextuels existants des outils ;

  • crée les fichiers de configuration de l’agent dans votre répertoire personnel ;

  • maintient la rétrocompatibilité avec vos flux de travail existants.

La migration est facultative et peut être refusée. Si vous choisissez de ne pas effectuer de migration, vous pouvez continuer à utiliser l’agent par défaut ou à créer des agents manuellement. Pour contrôler le comportement de la migration, utilisez l’indicateur --no-interactive pour ignorer complètement les invites de migration.

Utilisation de l’agent par défaut ou d’agents personnalisés

L’interface de ligne de commande d’Amazon Q Developer inclut un agent par défaut intégré qui permet d’accéder à tous les outils avec les autorisations minimales préapprouvées. Cet agent par défaut :

  • inclut tous les outils disponibles (intégrés et MCP) ;

  • préapprouve uniquement l’outil fs_read pour la sécurité ;

  • inclut automatiquement les fichiers courants du projet, comme README.md et AmazonQ.md ;

  • utilise la configuration MCP existante si elle est disponible.

Les agents personnalisés vous permettent de :

  • limiter l’accès aux outils dont vous avez besoin uniquement ;

  • préapprouver des outils supplémentaires afin de réduire les interruptions ;

  • inclure la documentation et les fichiers contextuels du projet ;

  • configurer le comportement des outils pour votre cas d’utilisation spécifique.