Définition d'un agent personnalisé - Amazon Q Developer
Création de votre premier agent personnaliséCommandes d'agent personnaliséesMigration depuis les anciens profilsUtilisation de l'agent par défaut plutôt que des agents personnalisés

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.

Définition d'un agent personnalisé

Cette section explique comment créer et utiliser des agents personnalisés dans votre flux de travail Amazon Q Developer CLI.

Création de votre premier agent personnalisé

Voici une step-by-step procédure pas à pas pour créer votre premier agent personnalisé :

  1. Démarrez une session de chat Amazon Q Developer CLI :

    $ q chat

  2. Répertoriez les agents existants pour voir ce qui est disponible :

    /agent list

  3. Créez un nouvel agent (remplacez-le my-agent par votre nom préféré) :

    /agent create --name my-agent

    Cela crée un nouveau fichier de configuration d'agent et l'ouvre dans votre éditeur par défaut (défini via la variable d'EDITORenvironnement).

  4. Personnalisez la configuration de l'agent personnalisé selon vos besoins. Pour un début simple, vous pouvez :

    • Ajoutez une description expliquant l'objectif de l'agent personnalisé

    • Spécifiez les outils qui devraient être disponibles

    • Pré-approuvez les outils que vous utilisez fréquemment

  5. Enregistrez le fichier de configuration et quittez 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é au cours d'une session de chat existante. Les modifications d'agent personnalisé nécessitent le démarrage d'une nouvelle session.

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

Pour obtenir des informations détaillées sur les options de configuration des agents personnalisés, consultez la section Référence de configuration.

Commandes d'agent personnalisées

La CLI Amazon Q Developer fournit plusieurs commandes pour gérer les agents personnalisés. Ces commandes sont disponibles pendant une session de chat et commencent par/agent.

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

Remarque : Certaines opérations de gestion d'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 depuis les anciens profils

Lorsque vous passez à une version d'Amazon Q Developer CLI qui prend en charge les agents et que vous vous connectez, vous pouvez être invité à migrer vos anciens profils vers des agents si :

  • Vous disposez d'anciennes configurations de profil

  • Vous utilisez le 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 de profil existantes au nouveau format d'agent

  • Préserve les autorisations d'outils et les paramètres contextuels existants

  • Crée des 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 la migration, vous pouvez continuer à utiliser l'agent par défaut ou créer de nouveaux agents manuellement. Pour contrôler le comportement de migration, utilisez l'--no-interactiveindicateur pour ignorer complètement les invites de migration.

Utilisation de l'agent par défaut plutôt que des agents personnalisés

La CLI Amazon Q Developer inclut un agent par défaut intégré qui permet d'accéder à tous les outils avec un minimum d'autorisations préapprouvées. Cet agent par défaut :

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

  • Pré-approuve uniquement l'fs_readoutil de sécurité

  • Inclut automatiquement les fichiers de projet courants tels que README.md et AmazonQ.md

  • Utilise la configuration MCP existante si elle est disponible

Les agents personnalisés vous permettent de :

  • Limitez l'accès aux outils uniquement à ce dont vous avez besoin

  • Approuver au préalable des outils supplémentaires pour réduire les interruptions

  • Incluez une documentation de projet et des fichiers contextuels spécifiques

  • Configurer le comportement de l'outil en fonction de votre cas d'utilisation spécifique