Criando um ambiente personalizado para agentes

Como alternativa ao uso de GitHub Actions ou de sandboxes na nuvem gerenciadas por GitHub, você pode fornecer um ambiente personalizado para sessões de GitHub Copilot. Um ambiente personalizado é uma máquina Linux ou um codespace que executa o host Copilot, copilotd.

Crie o host e registre-o na sua GitHub conta. Em seguida, você pode selecioná-lo como um ambiente em um cliente que dá suporte a ambientes personalizados. O registro disponibiliza um host existente para os clientes.

Você precisa de uma Copilot licença e acesso a ambientes personalizados. Você é responsável pela máquina, seu workspace e ferramentas e mantém o host em execução e atualizado. Fechar uma conexão de cliente não interrompe o host ou o computador.

Usando um computador Linux

Use Copilot CLI para executar e registrar o host em um computador Linux.

1. Preparar o host

Você precisa de um computador Linux e npm ou Homebrew para instalar a versão de pré-lançamento de Copilot CLI. Para obter requisitos de instalação e outros métodos de instalação, consulte Instalando a CLI do GitHub Copilot.

No computador que você deseja usar, prepare o workspace e instale as ferramentas e dependências de que as sessões do agente precisam.
Instale a versão de pré-lançamento de Copilot CLI com npm:
```
npm install -g @github/copilot@prerelease
```
Como alternativa, instale-o com o Homebrew:
```
brew install copilot-cli@prerelease
```

2. Registrar o host

O host se registra como um ambiente de propriedade da conta com a qual você se autentica.

Entre em GitHub.com e siga os prompts de autenticação:
```
copilot login
```
Inicie Copilot CLI para que as configurações da conta e as flags de recurso sejam carregadas e, em seguida, saia da sessão interativa:
```
copilot
```
Inicie o host do ambiente. Substitua HOST-NAME por um nome que você reconheça no seletor de ambiente.
```
copilot --environment-host "HOST-NAME"
```
O comando inicia o host e registra o computador sob o nome escolhido. Mantenha o host em execução para que os clientes possam se conectar a ele.

3. Escolha o ambiente

Conecte-se a partir de um cliente que dá suporte à seleção de ambientes registrados.

Entre no cliente com a mesma GitHub conta usada para registrar o host.
Abra Ambientes e selecione o host pelo nome que você registrou.

O cliente se conecta ao host em execução, onde as sessões do agente são executadas.

Usando GitHub Codespaces

Use um recurso de contêiner de desenvolvimento para iniciar e registrar o host automaticamente quando o codespace for iniciado. Você precisa de acesso a GitHub Codespaces. Para usar os comandos abaixo, você também precisa de uma instalação autenticada de GitHub CLI.

1. Configurar o codespace

A configuração do contêiner de desenvolvimento determina como o host é instalado.

No seu repositório, crie ou edite .devcontainer/devcontainer.json para adicionar o recurso de hospedagem. Por exemplo:

{
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "features": {
    "ghcr.io/github/copilot-host/copilotd:0": {}
  }
}

Opcionalmente, configure o recurso para seu ambiente. Use :prerelease em vez de :0 para o canal de pré-lançamento. Para clonar repositórios adicionais, adicione uma repositories opção dentro do objeto de configuração do recurso:
```
"ghcr.io/github/copilot-host/copilotd:0": {
  "repositories": "OWNER/REPOSITORY-1,OWNER/REPOSITORY-2"
}
```
Substitua OWNER/REPOSITORY-1 e OWNER/REPOSITORY-2 pelos proprietários e nomes dos repositórios a serem clonados.

2. Iniciar e registrar o host

O recurso inicia copilotd e registra o codespace automaticamente quando o contêiner é iniciado.

Para criar um novo codespace, faça commit e envie por push a configuração do contêiner de desenvolvimento. Em seguida, crie um codespace nesse branch. Substitua OWNER/REPOSITORY pelo proprietário e pelo nome do repositório e BRANCH pelo branch que contém sua configuração.
```
gh codespace create -r OWNER/REPOSITORY -b BRANCH
```
No caso de um codespace existente, reconstrua o contêiner. Substitua CODESPACE-NAME pelo nome do seu codespace.
```
gh codespace rebuild -c CODESPACE-NAME
```
Aguarde até que o contêiner seja iniciado e o host se registre.

3. Escolha o ambiente do Codespace

Use um cliente que dê suporte à seleção de ambientes registrados. O token usado para entrar no cliente deve incluir o codespace escopo.

Inicie sessão no cliente com a GitHub conta que possui o codespace.
Abra Ambientes e selecione o codespace.

Se o codespace for interrompido, ao se conectar, ele é ativado e inicia copilotd automaticamente.

Para inspecionar os logs de host, execute o seguinte comando no codespace:

tail -F /workspaces/.copilotd/logs/copilotd.log

Neste artigo