Configurando GitHub Copilot em seu ambiente

Sobre GitHub Copilot os IDEs do JetBrains

Se você usar um IDE do JetBrains, GitHub Copilot poderá ajudá-lo com várias tarefas, incluindo gerar sugestões de código, explicar como o código no editor funciona e sugerir correções de código. Após a instalação, você pode habilitar ou desabilitar GitHub Copilote definir configurações avançadas no IDE ou no GitHub. Este artigo descreve como configurar GitHub Copilot no IDE do IntelliJ, mas as interfaces de usuário de outros IDEs do JetBrains podem ser diferentes.

Pré-requisitos

Para configurar em um IDE do JetBrains, instale GitHub Copilot o GitHub Copilot plug-in. Para obter mais informações, consulte Instalando a extensão GitHub Copilot em seu ambiente.

Habilitar ou desabilitar GitHub Copilot

Você pode habilitar ou desabilitar GitHub Copilot de dentro do IDE do JetBrains. O GitHub Copilot ícone de status no painel inferior da janela JetBrains indica se GitHub Copilot está habilitado ou desabilitado. Quando habilitado, o ícone fica realçado. Quando desabilitado, o ícone fica esmaecido.

1. Para habilitar ou desabilitar GitHub Copilot, clique no ícone de status no painel inferior à direita da janela JetBrains.

   

2. Se você estiver desabilitando GitHub Copilot, será perguntado se deseja desabilitá-lo globalmente ou para o idioma do arquivo que está editando no momento. Para desabilitar globalmente, clique em Desabilitar Conclusões. Como alternativa, clique no botão específico do idioma para desabilitar GitHub Copilot o idioma especificado.

   

Como reassociar atalhos de teclado

Você pode usar os atalhos de teclado padrão para sugestões embutidas no IDE do JetBrains ao usar GitHub Copilot. Para obter uma lista de atalhos de teclado padrão, consulte Atalhos de teclado para o GitHub Copilot no IDE.

Como alternativa, você pode reassociar os atalhos aos seus atalhos de teclado preferidos de cada comando específico. Para obter mais informações de como reassociar atalhos de teclado no IDE da JetBrains, confira a documentação da JetBrains. Por exemplo, você pode ver a documentação do IntelliJ IDEA.

Configurando configurações avançadas para GitHub Copilot

Você pode gerenciar configurações avançadas no GitHub Copilot IDE do JetBrains, como como o IDE exibe sugestões embutidas e para quais idiomas você deseja habilitar ou desabilitar GitHub Copilot.

1. No seu IDE JetBrains, clique no menu Arquivo (Windows) ou no nome do aplicativo na barra de menus (macOS) e clique em Configurações.

2. Na barra lateral esquerda, clique em Ferramentas, clique em GitHub Copilote examine as configurações Gerais e de Conclusões .

3. Edite as configurações de acordo com suas preferências pessoais.

   • Para ajustar o comportamento e a aparência das sugestões de código e se você quiser verificar automaticamente se há atualizações, marque ou desmarque as caixas de seleção correspondentes.
   • Se você selecionar que deseja receber atualizações automáticas, escolha se quer receber atualizações estáveis, mas menos frequentes, ou atualizações noturnas, que podem ser menos estáveis. Clique na lista suspensa Atualizar canal e selecione Estável para atualizações estáveis ou Noturnas para atualizações noturnas.

Definindo as configurações de idioma para GitHub Copilot

Você pode especificar quais idiomas deseja ativar ou desativar GitHub Copilot no IDE ou editando seu github-copilot.xml arquivo. Se você fizer alterações nas configurações de linguagem no IDE, poderá selecionar e desmarcar individualmente as linguagens que deseja ativar ou desativar.

Se você fizer alterações nas configurações de idioma em seu github-copilot.xml arquivo, poderá especificar idiomas individuais ou usar um curinga para ativar ou desativar GitHub Copilot para todos os idiomas. Você também pode especificar exceções, que substituirão a configuração curinga para as linguagens especificadas. Por exemplo, você pode desativar GitHub Copilot para todos os idiomas, exceto para Python e YAML. Por padrão, quando você instala a GitHub Copilot extensão, GitHub Copilot é ativado para todos os idiomas.

Definindo configurações de linguagens no IDE

1. No seu IDE JetBrains, clique no menu Arquivo (Windows) ou no nome do aplicativo na barra de menus (macOS) e clique em Configurações.

2. Na barra lateral esquerda, clique em Ferramentas, clique em GitHub Copilot, em seguida, clique em Conclusões.

3. Em "Idiomas", selecione ou desmarque as caixas de seleção para os idiomas para os quais você deseja ativar ou desativar GitHub Copilot .

4. Clique em Aplicar e em OK.

5. Reinicie seu IDE da JetBrains para que as alterações entrem em vigor.

Editando seu arquivo github-copilot.xml

Para definir as configurações de idioma no arquivo github-copilot.xml, edite o languageAllowList. Cada linha que você adiciona ao languageAllowList deve conter uma chave de entrada e um valor. A chave de entrada é o nome da linguagem ou (*) para um curinga. O valor é true ou false. Se o valor for true, GitHub Copilot será ativado para o idioma especificado. Se o valor for false, GitHub Copilot será desativado para o idioma especificado.

O arquivo está localizado no seguinte diretório:

• Macos:~/Library/Application Support/JetBrains/<product><version>/options/github-copilot.xml
• Windows:%APPDATA%\JetBrains\<product><version>\options\github-copilot.xml
• Linux:~/.config/JetBrains/<product><version>/options/github-copilot.xml

Por exemplo, se você estiver usando o IntelliJ IDEA 2021.1 no macOS, o arquivo estará localizado em ~/Library/Application Support/JetBrains/IdeaIC2021.1/options/github-copilot.xml.

O arquivo github-copilot.xml pode não ser gerado até que você faça uma alteração na configuração de idioma padrão nas configurações do IDE. Se não conseguir localizar o arquivo, tente modificar as configurações de linguagem padrão no IDE. Para obter mais informações, confira Definir configurações de linguagem no IDE.

Como alternativa, você pode criar o arquivo manualmente e salvá-lo no local do seu sistema operacional listado acima. Para obter mais informações, confira Exemplo de configurações de linguagem.

1. Abra o arquivo github-copilot.xml em um editor de texto.

2. Entre as <map> marcas, adicione a linha ou as linhas para os idiomas para os quais você deseja ativar ou desativar GitHub Copilot . Por exemplo, para desativar GitHub Copilot para todos os idiomas:

   XML

   <entry key="*" value="false" />
   

3. Salve as alterações no arquivo github-copilot.xml.

4. Reinicie seu IDE da JetBrains para que as alterações entrem em vigor.

Exemplo de configurações de linguagem

A configuração padrão do github-copilot.xml arquivo, que habilita GitHub Copilot para todos os idiomas, é a seguinte:

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

Para desativar GitHub Copilot para todos os idiomas, o valor curinga (*) é alterado para false:

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
      </map>
    </languageAllowList>
  </component>
</application>

Para especificar idiomas individualmente, adicione uma entrada para cada idioma para o qual você deseja ativar ou desativar GitHub Copilot . As configurações específicas de linguagens substituirão o curinga. Por exemplo, para ativar GitHub Copilot para Python e YAML e desativar GitHub Copilot para todos os outros idiomas, adicione as seguintes entradas:

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
        <entry key="Python" value="true" />
        <entry key="YAML" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="github-copilot">
    <languageAllowList>
      <map>
        <entry key="*" value="false" />
        <entry key="Python" value="true" />
        <entry key="YAML" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

Você também pode adicionar uma configuração para tornar o languageAllowList somente leitura nas configurações do IDE. Isso impedirá que você altere as configurações de linguagens no IDE. Por exemplo:

<application>
  <component name="github-copilot">
    <option name="languageAllowListReadOnly" value="true" />
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

<application>
  <component name="github-copilot">
    <option name="languageAllowListReadOnly" value="true" />
    <languageAllowList>
      <map>
        <entry key="*" value="true" />
      </map>
    </languageAllowList>
  </component>
</application>

Configuração das definições de Copilot em GitHub.com

Se você estiver usando um Copilot Pro, Copilot Pro+ou Copilot Max plano, poderá optar por permitir ou bloquear sugestões embutidas que correspondam ao código disponível publicamente. Você também pode permitir ou bloquear a coleta e a retenção dos prompts que você insere e das sugestões de Copilot. Você configura isso em suas configurações pessoais em GitHub.com. Confira Gerenciando políticas de GitHub Copilot como um assinante individual.

Autenticando-se em uma conta no GHE.com

Se você está usando um plano do Copilot para um conta de usuário gerenciada no GHE.com, precisa atualizar algumas configurações antes de entrar. Consulte Usando GitHub Copilot com uma conta no GHE.com.

Leitura adicional

• GitHub Copilot Perguntas Freqüentes