Usar o comando do editor na CLI - Amazon Q Developer

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usar o comando do editor na CLI

A CLI do Amazon Q Developer fornece um comando /editor que abre seu editor de texto preferido para compor prompts complexos. Isso é especialmente útil para solicitações de várias linhas, exemplos de código ou quando você precisa estruturar cuidadosamente suas perguntas.

Uso básico

Como abrir seu editor padrão com um prompt vazio:

Amazon Q> /editor

Como abrir seu editor com o texto inicial:

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

Quando você usa o comando /editor, o Amazon Q cria um arquivo temporário com uma extensão .md, abre o editor especificado com esse arquivo e, em seguida, lê o conteúdo e o envia como seu prompt quando você salva e fecha o editor.

Definir seu editor preferido

O Amazon Q usa a variável de ambiente $EDITOR do seu sistema para determinar qual editor abrir. Se isso não for definido, o padrão será vi.

Configuração temporária (apenas para a sessão atual)

Como configurar seu editor somente para a sessão atual do terminal:

$ export EDITOR=nano

Configuração permanente

Para tornar sua preferência de editor persistente em todas as sessões, adicione o comando export ao seu arquivo de configuração do 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

Depois de editar seu arquivo de configuração, reinicie o terminal ou carregue o arquivo:

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

Opções comuns do editor

Aqui estão algumas opções comuns do editor que você pode usar:

  • vi ou vim: editor de texto Vi/Vim

  • nano: editor de texto Nano (para iniciantes)

  • emacs: editor de texto Emacs

  • code -w: Visual Studio Code (requer a instalação da CLI do VS Code)

  • subl -w: Sublime Text (requer a instalação da CLI do Sublime)

nota

O sinalizador -w para editores de GUI é importante, pois faz com que o terminal espere até que o arquivo seja fechado.

Como funciona

O comando /editor segue este fluxo de trabalho:

  1. Quando você usa o comando /editor, o Amazon Q cria um arquivo temporário com uma extensão .md

  2. Seu editor especificado é aberto com este arquivo

  3. Você escreve seu prompt no editor e salva o arquivo

  4. Quando você fecha o editor

  5. O Amazon Q lê o conteúdo e o envia como seu prompt

  6. O arquivo temporário é limpo automaticamente

Trabalhar com código no editor

Quando você escreve código no editor, todo o conteúdo é enviado como seu prompt ao Amazon Q quando você fecha o editor. O código não é executado localmente. Ele é tratado como entrada de texto para a IA.

Exemplo: gravação e envio de código

  1. Digite /editor para abrir seu editor

  2. Escreva um script em Python no editor:

    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. Salve e feche o editor

  4. O Amazon Q receberá esse texto inteiro como seu prompt e responderá com sugestões para melhorar o código

Essa abordagem é útil para:

  • Obter revisões de código

  • Solicitar otimizações

  • Explicar estruturas de código complexas

  • Fornecer contexto para ajuda na depuração

Combinar com outros comandos

O comando /editor se torna ainda mais poderoso quando combinado com outros comandos da CLI do Amazon Q. Aqui estão algumas combinações práticas para aprimorar seu fluxo de trabalho.

Usar /editor com /compact

O comando /compact torna as respostas do Amazon Q mais concisas. Essa combinação é excelente para revisões de código eficientes:

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

Usar /editor com /context

O comando /context adiciona arquivos ao contexto da conversa. Essa combinação é útil para discutir códigos que fazem referência a outros arquivos:

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

Usar /editor com /clear

O comando /clear inicia uma nova conversa. Essa combinação ajuda ao trocar de tópicos:

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

Usar /editor para conversas em múltiplas etapas

O comando /editor cria um arquivo temporário cada vez que é usado. Você pode usá-lo múltiplas vezes em uma conversa para aproveitar as respostas anteriores:

# 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?

O benefício dessa abordagem é que você pode cuidadosamente criar perguntas de acompanhamento complexas que façam referência à conversa anterior, sem precisar digitar tudo na linha de comandos. Cada sessão do editor oferece espaço e controle de formatação para redigir perguntas detalhadas baseadas nas respostas anteriores do Amazon Q.

Usar /editor com /profile

Mude para um perfil de contexto diferente antes de usar o editor para perguntas especializadas:

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

Usar /editor com /help

Se não tiver certeza sobre as opções de comando, você pode usar /help antes de /editor:

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

Práticas recomendadas para combinações de comandos

  1. Use /context antes de /editor quando precisar referenciar arquivos específicos

  2. Use /editor antes de /compact quando quiser respostas concisas para perguntas complexas

  3. Use /clear antes de /editor ao iniciar um tópico completamente novo

  4. Use várias sessões /editor para conversas complexas e com várias partes, nas quais você precisa elaborar cuidadosamente as perguntas de acompanhamento

  5. Considere seu perfil atual antes de usar /editor para garantir que você esteja no contexto certo

Dicas para uso efetivo

  • Use o editor para prompts complexos que se beneficiam de uma estruturação cuidadosa

  • Inclua exemplos de código com indentação adequada

  • Organize perguntas de várias partes com seções claras

  • Use a formatação Markdown para uma melhor estrutura

  • Se você salvar um arquivo vazio, nenhum prompt será enviado

Solução de problemas

  • Editor não abre: verifique se a variável de ambiente $EDITOR está configurada corretamente

  • Erro “Não existe esse arquivo ou diretório”: verifique se o comando do editor está instalado e em seu PATH

  • Interrupção do terminal: para editores de GUI, use o sinalizador de espera (por exemplo, -w)

  • Conteúdo não enviado: verifique se você salvou o arquivo antes de fechar o editor