# Usar entrada de voz com Copilot CLI

Fale suas solicitações em GitHub Copilot CLI vez de digitá-las, usando o recurso de fala em texto da CLI.

A entrada de voz permite que você dite comandos para Copilot CLI falando ao microfone em vez de digitar no teclado. A transcrição é executada inteiramente em seu computador local. O áudio não é enviado pela rede. O texto reconhecido é inserido na posição do cursor na área de entrada do prompt, onde você pode editá-lo antes de enviar.

## Prerequisite

Você precisa de um microfone funcionando conectado ao computador. Por padrão, a entrada de voz usa o microfone padrão do sistema.

## Limitation

Atualmente, a entrada de voz só tem suporte para ditado em inglês e espanhol. O inglês é o idioma padrão para reconhecimento de fala.

## Habilitando a entrada de voz

Para ditar prompts, você precisa baixar o mecanismo do serviço de voz que alimenta o reconhecimento de fala e um modelo de voz.

1. Em uma sessão Copilot CLI interativa, insira o `/voice` comando barra "/".

2. Quando solicitado, selecione **Continuar** para baixar o runtime de voz.

   O download é executado em segundo plano. Você pode continuar usando Copilot CLI enquanto ele é finalizado.

3. Quando for solicitado que você escolha um modelo de voz, pressione <kbd>Enter</kbd> com "Baixar modelo padrão" selecionado para baixar o modelo de conversão de fala em texto em inglês.

   Como alternativa, se você quiser ditar em espanhol:

   1. Use as teclas de direção no teclado para selecionar "Procurar modelos" e pressione <kbd>Enter</kbd>.
   2. No seletor de modelos de voz, use as teclas de direção para selecionar o modelo de conversão de fala em texto espanhol e pressione <kbd>Enter</kbd> para baixá-lo.
   3. Pressione <kbd>Esc</kbd> para sair do seletor.

## Usando entrada de voz

Há duas maneiras de ditar comandos.

### Para comandos curtos

1. Mantenha pressionada a barra de espaços no teclado.

   Após um breve momento, a gravação começa.

2. Fale seu prompt.

3. Libere a barra de espaços.

Copilot CLI transcreve sua fala e insere o resultado na posição do cursor na área de entrada do prompt.

### Para comandos mais longos

Em vez de segurar a barra de espaço, você pode ativar e desativar a gravação de voz. Isso é mais prático para prompts mais longos.

1. Pressione <kbd>Ctrl</kbd>+<kbd>X</kbd> seguido de <kbd>V</kbd> para iniciar a gravação.
2. Fale seu prompt.
3. Pressione qualquer tecla para interromper a gravação e inserir a transcrição.

### Limpeza de prompts inseridos por voz

Se quiser, para limpar um prompt que você inseriu por voz, você pode usar o comando de barra `/refine`. Este comando:

* Remove palavras de preenchimento, inícios falsos ou repetições.
* Aplica todas as autocorreções feitas por você.
* Corrige erros gramaticais.
* Agrupa pontos relacionados para maior clareza.

Para limpar o prompt atual:

1. Antes de enviar o prompt, pressione <kbd>Ctrl</kbd>+<kbd>X</kbd> rapidamente seguido por <kbd>/</kbd>.
2. Digite `/refine`e pressione <kbd>Enter</kbd>.

## Trocar de microfone

Se você tiver mais de um microfone disponível em seu sistema, poderá alternar dispositivos de entrada.

1. Insira o comando barra `/voice devices`.

   Uma lista de dispositivos de entrada disponíveis é mostrada.

2. Use as teclas de direção no teclado para selecionar o microfone que você deseja usar e pressione <kbd>Enter</kbd>.

## Alternar modelos de voz

Você pode ditar prompts em inglês ou espanhol, mas o modelo de voz apropriado deve ser baixado e ativado para o idioma que você deseja usar.

Para alterar para um modelo de voz diferente:

1. Insira o comando barra `/voice models`.

   O seletor de modelos de voz é exibido. Uma marca de seleção indica o modelo ativo no momento.

2. No seletor de modelos de voz, use as teclas de seta do teclado para selecionar o recurso de fala para texto em inglês ou espanhol e pressione <kbd>Enter</kbd>.

   Se o modelo ainda não estiver baixado, ele será baixado no computador.

3. Se você baixou um modelo, pressione <kbd>Enter</kbd> novamente para torná-lo o modelo ativo.

Sua escolha de modelo — e se a entrada de voz está habilitada ou desabilitada — é armazenada em seu Copilot arquivo de configurações (normalmente `~/.copilot/settings.json`) para que suas preferências persistam entre as sessões da CLI.

## Leitura adicional

* [Usando GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/use-copilot-cli/overview)