Utilisation de la commande editor dans la CLI - Amazon Q Developer

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.

Utilisation de la commande editor dans la CLI

L'interface de ligne de commande Amazon Q Developer fournit une /editor commande qui ouvre votre éditeur de texte préféré pour composer des instructions complexes. Cela est particulièrement utile pour les invites multilignes, les exemples de code ou lorsque vous devez structurer soigneusement vos questions.

Utilisation de base

Pour ouvrir votre éditeur par défaut avec une invite vide, procédez comme suit :

Amazon Q> /editor

Pour ouvrir votre éditeur avec le texte initial :

Amazon Q> /editor Write a Python function that calculates Fibonacci numbers

Lorsque vous utilisez la /editor commande, Amazon Q crée un fichier temporaire avec une .md extension, ouvre l'éditeur que vous avez spécifié avec ce fichier, puis lit le contenu et l'envoie à votre demande lorsque vous enregistrez et fermez l'éditeur.

Configuration de votre éditeur préféré

Amazon Q utilise la variable d'$EDITORenvironnement de votre système pour déterminer l'éditeur à ouvrir. S'il n'est pas défini, sa valeur par défaut est. vi

Paramètre temporaire (session en cours uniquement)

Pour configurer votre éditeur uniquement pour la session de terminal en cours :

$ export EDITOR=nano

Réglage permanent

Pour que vos préférences d'éditeur soient persistantes d'une session à l'autre, ajoutez la commande export à votre fichier de configuration shell :

# For bash (add to ~/.bashrc)
export EDITOR=nano

# For zsh (add to ~/.zshrc)
export EDITOR=nano

# For fish shell (add to ~/.config/fish/config.fish)
set -x EDITOR nano

Après avoir modifié votre fichier de configuration, redémarrez votre terminal ou sourcez le fichier :

$ source ~/.bashrc  # or ~/.zshrc

Options d'éditeur courantes

Voici quelques options d'édition courantes que vous pouvez utiliser :

  • viou vim - éditeur de texte Vi/Vim

  • nano- Nano éditeur de texte (adapté aux débutants)

  • emacs- Éditeur de texte Emacs

  • code -w- Visual Studio Code (nécessite l'installation de la CLI VS Code)

  • subl -w- Sublime Text (nécessite l'installation de la CLI Sublime)

Note

L'-windicateur pour les éditeurs d'interface graphique est important car il oblige le terminal à attendre la fermeture du fichier.

Comment ça marche

La /editor commande suit ce flux de travail :

  1. Lorsque vous utilisez la /editor commande, Amazon Q crée un fichier temporaire avec une .md extension

  2. L'éditeur que vous avez spécifié s'ouvre avec ce fichier

  3. Vous écrivez votre demande dans l'éditeur et vous enregistrez le fichier

  4. Lorsque vous fermez l'éditeur

  5. Amazon Q lit le contenu et l'envoie à votre demande

  6. Le fichier temporaire est automatiquement nettoyé

Utilisation du code dans l'éditeur

Lorsque vous écrivez du code dans l'éditeur, l'intégralité du contenu est envoyée à Amazon Q lorsque vous fermez l'éditeur. Le code n'est pas exécuté localement, il est traité comme une saisie de texte pour l'IA.

Exemple : rédaction et envoi de code

  1. Tapez /editor pour ouvrir votre éditeur

  2. Écrivez un script Python dans l'éditeur :

    def fibonacci(n): if n <= 1: return n else: return fibonacci(n-1) + fibonacci(n-2) # This function seems inefficient # How can I improve it?
  3. Enregistrez et fermez l'éditeur

  4. Amazon Q recevra ce texte complet à votre demande et vous proposera des suggestions pour améliorer le code

Cette approche est utile pour :

  • Obtenir des révisions de code

  • Demander des optimisations

  • Expliquer les structures de code complexes

  • Fournir un contexte pour l'aide au débogage

Combinaison avec d'autres commandes

La /editor commande devient encore plus puissante lorsqu'elle est associée à d'autres commandes de la CLI Amazon Q. Voici quelques combinaisons pratiques pour améliorer votre flux de travail.

Using /editor with /compact

La /compact commande rend les réponses d'Amazon Q plus concises. Cette combinaison est excellente pour des révisions de code efficaces :

Amazon Q> /editor
# Write in the editor:
Please review this Python function that calculates prime numbers:

def is_prime(n):
    if n <= 1:
        return False
    if n <= 3:
        return True
    if n % 2 == 0 or n % 3 == 0:
        return False
    i = 5
    while i * i <= n:
        if n % i == 0 or n % (i + 2) == 0:
            return False
        i += 6
    return True

# Save and close

Amazon Q> /compact
# This makes Amazon Q provide a concise code review

Using /editor with /context

La /context commande ajoute des fichiers au contexte de conversation. Cette combinaison est utile pour discuter du code qui fait référence à d'autres fichiers :

Amazon Q> /context path/to/config.json
Amazon Q> /editor
# Write in the editor:
Given the config.json file I just shared, please help me write a Python function that:
1. Loads the configuration
2. Validates all required fields are present
3. Returns a validated config object

# Save and close

Using /editor with /clear

La /clear commande lance une nouvelle conversation. Cette combinaison est utile lorsque vous changez de sujet :

Amazon Q> /clear
Amazon Q> /editor
# Write in the editor:
I want to start a new discussion about AWS Lambda cold starts.
What are the best practices for minimizing cold start times for Python Lambda functions?

# Save and close

Utilisation de /editor pour les conversations en plusieurs étapes

La /editor commande crée un nouveau fichier temporaire à chaque utilisation. Vous pouvez l'utiliser plusieurs fois au cours d'une conversation pour vous appuyer sur les réponses précédentes :

# First use of editor for initial complex question
Amazon Q> /editor
# Write in editor:
I need to design a database schema for a library management system.
Requirements:
- Track books, authors, publishers
- Handle member checkouts and returns
- Support reservations and waiting lists
- Generate overdue notices

# After getting Amazon Q's response with initial schema design

# Second use of editor for follow-up with specific implementation details
Amazon Q> /editor
# Write in editor:
Based on your proposed schema, I have some follow-up questions:
1. How would you modify the Member table to support different membership tiers?
2. What indexes would you recommend for optimizing checkout queries?
3. Can you show me SQL to create the Books and Authors tables with proper relationships?

L'avantage de cette approche est que vous pouvez élaborer avec soin des questions de suivi complexes qui font référence à la conversation précédente, sans avoir à tout taper dans la ligne de commande. Chaque session d'éditeur vous donne l'espace et le contrôle de mise en forme nécessaires pour rédiger des questions détaillées basées sur les réponses précédentes d'Amazon Q.

Using /editor with /profile

Passez à un autre profil de contexte avant d'utiliser l'éditeur pour des questions spécialisées :

Amazon Q> /profile set aws-developer
Amazon Q> /editor
# Write detailed AWS-specific questions that benefit from the AWS developer profile context

Using /editor with /help

Si vous n'êtes pas sûr des options de commande, vous pouvez utiliser /help avant /editor :

Amazon Q> /help editor
# Review the help information
Amazon Q> /editor
# Use the editor with better understanding of available options

Bonnes pratiques pour les combinaisons de commandes

  1. À utiliser /context avant /editor lorsque vous devez référencer des fichiers spécifiques

  2. À utiliser /editor avant /compact lorsque vous souhaitez obtenir des réponses concises à des questions complexes

  3. /editorÀ utiliser /clear avant de commencer un tout nouveau sujet

  4. Utilisez plusieurs /editor sessions pour des conversations complexes en plusieurs parties au cours desquelles vous devez élaborer avec soin des questions de suivi

  5. Tenez compte de votre profil actuel avant /editor de l'utiliser pour vous assurer que vous êtes dans le bon contexte

Conseils pour une utilisation efficace

  • Utilisez l'éditeur pour les instructions complexes qui bénéficient d'une structuration soignée

  • Incluez des exemples de code avec une indentation appropriée

  • Organisez les questions en plusieurs parties avec des sections claires

  • Utiliser le formatage Markdown pour une meilleure structure

  • Si vous enregistrez un fichier vide, aucune demande ne sera envoyée

Résolution des problèmes

  • L'éditeur ne s'ouvre pas : vérifiez que votre variable d'environnement $EDITOR est correctement définie

  • Erreur « Aucun fichier ou répertoire de ce type » : assurez-vous que la commande de l'éditeur est installée et qu'elle figure dans votre PATH

  • Suspension du terminal : pour les éditeurs d'interface graphique, assurez-vous d'utiliser l'indicateur d'attente (par exemple,-w)

  • Contenu non soumis : vérifiez que vous avez bien enregistré le fichier avant de fermer l'éditeur