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.
Gérer les invites
L'Amazon Q Developer CLI fournit des fonctionnalités complètes de gestion des invites à la fois pour les invites locales et les invites MCP (Model Context Protocol). Ce système vous permet de créer, de modifier, d'organiser et d'utiliser des instructions réutilisables dans l'ensemble de votre flux de travail de développement.
À propos des types d'invite
Le système d'invite prend en charge trois types d'invite :
Invites locales : instructions spécifiques au projet stockées dans votre espace de travail
Invites globales : instructions à l'échelle de l'utilisateur disponibles pour tous les projets
Invites MCP : instructions fournies par des serveurs MCP dotés de fonctionnalités améliorées
Commandes
Toute la gestion des promptes est accessible via la /prompts commande avec différentes sous-commandes.
Répertorier les invites
/prompts list
Affiche toutes les instructions disponibles dans une mise en page à trois colonnes indiquant les noms, les descriptions et les sources. Affiche le nombre de demandes et indique celles qui proviennent du stockage local, du stockage global ou des serveurs MCP.
Création d'invites
/prompts create --namename[--contentcontent]
Crée une nouvelle invite locale dans l'espace de travail actuel.
Paramètres
name-
Nom de l'invite (50 caractères maximum)
--content(facultatif)content-
Spécification directe du contenu
Comportement :
S'il
--contentest fourni, crée une invite avec le contenu spécifiéSi aucun contenu n'est fourni, ouvre votre éditeur par défaut pour la création de contenu
Les invites sont enregistrées
.amazonq/prompts/dans l'espace de travail actuel
Modifier les invites
/prompts edit name
Ouvre une invite de modification existante dans votre éditeur par défaut.
Invites prises en charge :
Invites relatives à l'espace de travail local
Invites utilisateur globales
Invites MCP (lorsque le serveur les prend en charge)
Afficher les détails de l'invite
/prompts details name
Affiche des informations complètes sur une invite, notamment :
Détails des métadonnées et des arguments
Complétez le contenu de l'invite avant le traitement par l'IA
Exigences relatives aux paramètres et exemples
Informations sur la source (local, global ou serveur MCP)
Utilisation des instructions
Une fois que vous avez créé des invites, invoquez-les dans le chat en utilisant le préfixe @ :
@prompt-name
Exemples
@code-review # Uses your local code-review prompt
@team-standup # Uses your team-standup prompt
Transmission d'arguments aux invites MCP
Les invites du serveur MCP peuvent accepter des arguments pour personnaliser leur comportement. Les invites basées sur des fichiers (locales et globales) ne prennent pas en charge les arguments.
Syntaxe des arguments d'invite MCP
@server-name/prompt-name<required-arg> [optional-arg]
/prompts details À utiliser pour découvrir les arguments acceptés par une invite MCP.prompt-name
# Example: Using MCP prompt with arguments @dev-tools/analyze "performance issue" "detailed" @security-tools/scan "web-app" "high-severity"
Emplacements de stockage
Invites locales (spécifiques à l'espace de travail)
Lieu :
project/.amazonq/prompts/Champ d'application : Disponible uniquement dans le cadre du projet en cours
Priorité : la plus élevée (remplace les instructions globales et MCP portant le même nom)
Invites globales (à l'échelle de l'utilisateur)
Lieu :
~/.aws/amazonq/prompts/Champ d'application : disponible pour tous les projets
Priorité : moyenne (remplace les instructions MCP portant le même nom)
Prospects MCP
Source : Fourni par des serveurs MCP configurés
Champ d'application : dépend de la configuration du serveur
Priorité : la plus faible (remplacée par les instructions locales et globales)
Système de priorité
Lorsque plusieurs invites portent le même nom, le système utilise cet ordre de priorité :
Invites locales (priorité la plus élevée)
Invitations globales
Invites MCP (priorité la plus basse)
Cela vous permet de remplacer les instructions MCP ou globales par des versions spécifiques au projet en cas de besoin.
Fonctionnalités améliorées
Aperçu du contenu
Le système affiche le contenu complet de l'invite avant de l'envoyer au modèle d'IA, éliminant ainsi toute confusion quant aux informations réellement traitées.
Gestion des erreurs améliorée
Les erreurs du serveur MCP sont converties en messages conviviaux
Des exemples d'utilisation utiles sont générés à partir de métadonnées rapides
Conseils clairs en cas de paramètres non valides ou d'exigences manquantes
Formatage visuel
Style de terminal uniforme pour toutes les opérations rapides
Affichage du contenu approprié pour tous les types de messages rapides
Disposition en trois colonnes pour une meilleure lisibilité des listes
Intégration MCP
Le système prompt s'intègre parfaitement aux serveurs MCP :
Découverte automatique : les invites MCP sont automatiquement découvertes à partir des serveurs configurés
Expérience utilisateur améliorée : expérience utilisateur améliorée pour la gestion des invites MCP
Erreur de traduction : les erreurs JSON brutes sont converties en messages exploitables
Aperçu du contenu : aperçu complet du contenu pour les instructions MCP avant l'exécution
Exemples
Ces exemples illustrent la création d'invites basées sur des fichiers et l'utilisation des invites MCP.
Création et utilisation d'invites de base basées sur des fichiers
# Create a simple prompt without arguments /prompts create --name code-review --content "Please review this code for best practices, security issues, and potential improvements:" # Use the prompt (no arguments supported for file-based prompts) @code-review
Utilisation de l'invite MCP avec arguments
# Using MCP prompts with arguments @dev-tools/analyze "performance bottleneck" "cpu usage" @security-tools/scan "web-app" "high-severity" @aws-tools/deploy "my-service" "production" "us-west-2"
