Personalizando suas sessões de nuvem

Sobre a personalização de sessões de nuvem

Você pode usar um repositório de dotfiles para fornecer Copilot in the cloud instruções preferenciais, habilidades reutilizáveis e agentes especializados em todos os repositórios. Você também pode usar instruções personalizadas pessoais que se aplicam a todas as conversas que tiver no GitHub.com e no GitHub Mobile. Essas personalizações pessoais se aplicam às suas sessões, em vez de configurar um repositório para todos que trabalham nele.

A personalização do Dotfiles funciona apenas em sandboxes na nuvem. Ele não se aplica às sessões executadas em GitHub Actions.

Copilot usa a mesma configuração de dotfiles que GitHub Codespaces. Você pode configurá-lo nas configurações pessoais Copilot > da Cloud ou nas suas configuraçõesCodespaces. Você não precisa criar um codespace para usar dotfiles com Copilot.

Instruções personalizadas pessoais se aplicam a cada conversa que você tem com Copilot in the cloud, portanto Copilot sempre responde em seu idioma, tom e estilo preferidos.

Exemplos de instruções personalizadas que você pode adicionar:

• Always respond in Spanish.
• Use a helpful, collegial tone. Keep explanations brief, but provide enough context to understand the code.
• Always provide examples in TypeScript.

Vários tipos de instruções personalizadas podem se aplicar a uma solicitação enviada ao Copilot. As instruções pessoais assumem a prioridade mais alta. As instruções do repositório vêm em seguida e, em seguida, as instruções da organização são priorizadas por último. No entanto, todas as instruções relevantes são fornecidas para Copilot.

Sempre que possível, tente evitar fornecer conjuntos conflitantes de instruções. Se você estiver preocupado com a qualidade da resposta, poderá desabilitar temporariamente as instruções do repositório. Confira Adicionando instruções personalizadas do repositório para GitHub Copilot.

Preparando seu repositório de dotfiles

O repositório dotfiles deve conter um .copilot diretório na raiz. Se esse diretório não estiver presente, Copilot não instalará os dotfiles do repositório.

Adicione as personalizações pessoais que você deseja usar neste diretório. Por exemplo:

.copilot/
  copilot-instructions.md
  skills/
    release-notes/
      SKILL.md
  agents/
    reviewer.agent.md

Esses arquivos usam os mesmos formatos e locais de diretório inicial para personalizações pessoais para GitHub Copilot CLI. Use os seguintes guias para escrever seus conteúdos:

Personalização	Localização no repositório de dotfiles	Guidance
Instruções pessoais	.copilot/copilot-instructions.md	Escreva diretrizes que se apliquem a todos os repositórios, como suas convenções de codificação preferenciais ou estilo de resposta. Consulte Adicionando instruções personalizadas para GitHub Copilot CLI.
Habilidades pessoais	.copilot/skills/SKILL-NAME/SKILL.md	Defina fluxos de trabalho repetíveis com instruções, scripts e recursos. Consulte Adicionando habilidades de agente para GitHub Copilot CLI.
Agentes pessoais personalizados	.copilot/agents/AGENT-NAME.agent.md	Defina agentes especialistas com suas próprias instruções e ferramentas. Consulte Criando e usando agentes personalizados para GitHub Copilot CLI.

Substitua SKILL-NAME e AGENT-NAME por nomes descritivos para sua habilidade e agente. Os guias vinculados também descrevem comandos específicos da CLI, que não são necessários para configurar o repositório dotfiles.

Não faça commit de segredos ou credenciais no repositório dotfiles.

Habilitando dotfiles para suas sessões de nuvem

1. Crie um repositório de dotfiles que você possui no GitHub, ou use um existente.

2. Adicione um .copilot diretório na raiz do repositório, com seus arquivos de personalização pessoais, conforme descrito acima.

3. Confirme e envie suas alterações por push para o repositório.

4. Em suas configurações pessoais GitHub, em Copilot, clique em Nuvem. Habilite os dotfiles e selecione o repositório.

   Como alternativa, defina os dotfiles em suas Codespaces configurações. Ambas as páginas de configurações compartilham a mesma seleção, portanto, alterá-la também altera o repositório de dotfiles usado para seus codespaces.

5. Inicie uma sessão em uma sandbox na nuvem ou retome uma sessão existente de sandbox na nuvem. Onde você pode escolher um ambiente, selecione Cloud, não Actions. Para obter mais informações, consulte Sobre sandboxes na nuvem para GitHub Copilot.

Quando a sandbox na nuvem é criada ou reiniciada, Copilot copia o conteúdo do seu repositório de dotfiles para o diretório home da sandbox, disponibilizando suas personalizações pessoais em ~/.copilot.

Como os dotfiles são aplicados

Se o repositório dotfiles contiver um diretório raiz .copilot , Copilot copiará todo o conteúdo do repositório, não apenas .copilot.

Ao contrário de GitHub Codespaces, Copilot não executa scripts de instalação de dotfiles, como install.sh ou bootstrap.sh. Inclua seus arquivos de personalização diretamente no repositório em vez de depender de um script para criá-los.

As alterações no repositório dotfiles entrarão em vigor na próxima vez que uma sandbox na nuvem for criada ou retomada. Eles não são aplicados a uma sandbox enquanto ela está em execução.

Adicionando instruções personalizadas pessoais

Para adicionar instruções personalizadas pessoais para Copilot in the cloud em GitHub:

1. Abra uma Copilot sessão.

2. No menu inferior esquerdo, clique em .

3. Adicione instruções em linguagem natural à caixa de texto.

   Use qualquer formato. Por exemplo, um único bloco de texto, cada instrução em uma nova linha ou instruções separadas por linhas em branco.

4. Clique em Salvar.

Suas instruções agora estão ativas e permanecem ativas até você alterá-las ou removê-las.

Para obter uma coleção de exemplos de instruções personalizadas pessoais, consulte Instruções personalizadas.