Este artigo explica os conceitos relacionados ao controle remoto de sessões CLI do Copilot. Para obter instruções sobre como habilitar o controle remoto, consulte Controlando uma CLI do GitHub Copilot sessão de outro dispositivo.
Quando o controle remoto ajuda
Por padrão, CLI do GitHub Copilot as sessões só podem ser controladas do computador local. No entanto, você pode habilitar o controle remoto da sessão. O controle remoto é útil quando você deseja acompanhar o progresso ou responder a solicitações de permissão e avisos, sem precisar permanecer no computador em que a sessão está em execução. Por exemplo:
- Você se afasta da estação de trabalho: continue interagindo com Copilot seu telefone ou outro dispositivo, sem retornar ao computador em que a sessão está sendo executada.
- Uma tarefa de execução longa precisa de sua entrada: aprovar solicitações de permissão e responder perguntas conforme elas aparecem, para que a tarefa não seja bloqueada enquanto você estiver fora.
- Você deseja uma verificação de status rápida: dê uma olhada no progresso da sessão GitHub Mobile enquanto trabalha em outra coisa.
Prerequisites
O controle remoto requer:
- Habilitação da política: se o seu Copilot assento for proveniente de uma organização, um proprietário da empresa ou da organização deverá habilitar a política de "Controle Remoto" (desativado por padrão). Consulte Administrar o controle remoto mais adiante neste artigo.
- O computador deve estar online: a sessão da CLI deve estar ativamente em execução em um terminal em um computador com uma conexão com a Internet. Se o computador entrar em suspensão ou perder a conexão, o controle remoto fica indisponível até que o computador volte a ficar online. Consulte Reconexão mais adiante neste artigo.
- Uma sessão interativa: o acesso remoto só está disponível para sessões interativas. Ele não está disponível quando você usa a CLI programaticamente com a opção
--promptde linha de comando, por exemplo, quando você usa a CLI em um script.
Acessando uma sessão remotamente
Ao habilitar o controle remoto para uma CLI do Copilot sessão, você pode acessar GitHub.com ou GitHub Mobile e localizar a sessão na lista de suas sessões de agente recentes. A interface remota é atualizada em tempo real, permitindo que você monitore a saída contínua da sessão e responda a solicitações e pedidos de permissões à medida que chegam.
O terminal local e a interface remota estão ativos ao mesmo tempo. Você pode inserir comandos em qualquer interface. CLI do Copilot usa a primeira resposta recebida para qualquer solicitação ou permissão.
Sua sessão continua sendo executada no computador local. A interface remota fornece uma maneira de interagir com a sessão, mas a própria CLI — e todas as ferramentas, comandos do shell e operações de arquivo executados — permanecem no computador em que você iniciou a sessão.
O que você pode fazer remotamente
Quando conectado a uma sessão remotamente de GitHub.com ou GitHub Mobile, você pode:
- Responder a solicitações de permissão: aprovar ou negar ferramenta, caminho do arquivo e solicitações de permissão de URL.
- Responder a perguntas: responda quando Copilot lhe pedir para fornecer mais informações ou tomar uma decisão.
- Aprovar ou rejeitar planos: responda aos prompts de aprovação do plano quando Copilot estiver no modo de plano.
- Enviar novos prompts: insira perguntas ou instruções, da mesma forma que faria no terminal.
- Alternar modos: Mude o modo de sessão, por exemplo, entre o modo interativo e o modo de planejamento.
- Encerrar a operação atual: cancele o trabalho atual do agente.
Observação
Comandos de barra — como /allow-all— não estão disponíveis atualmente na interface remota.
Reconexão
Se a conexão entre o computador local e GitHub for temporariamente perdida, por exemplo, devido a uma interrupção de rede, você poderá continuar usando a sessão remotamente assim que a conexão for restaurada.
Você pode usar o /keep-alive comando barra para impedir que o computador durma. Veja Como impedir que seu computador durma.
Quando você usa copilot --continue ou copilot --resume para retomar uma sessão da CLI para a qual o controle remoto tinha sido habilitado, o controle remoto é reabilitado automaticamente.
Segurança e privacidade
O controle remoto só está disponível para você — a pessoa conectada a GitHub com a mesma conta que iniciou a sessão da CLI. Ninguém mais pode exibir ou interagir com suas sessões remotamente. A URL da sessão exibida na CLI é específica da sessão e só pode ser acessada para usuários autenticados com a conta correta.
Quando o controle remoto está habilitado:
- Os eventos de sessão (mensagens de conversa, eventos de execução de ferramentas e solicitações de permissão) são enviados do computador local para GitHub.
- Os comandos remotos são sondados por CLI do Copilot a partir de GitHub e injetados em sua sessão local.
- A CLI continua a ser executada localmente – todos os comandos do shell, operações de arquivo e execuções de ferramentas ocorrem em seu computador. O controle remoto não concede acesso direto ao computador além do que o agente da CLI pode fazer dentro da sessão.
O link de sessão remota (exibido na CLI quando você habilita o controle remoto) aponta para uma URL específica da sessão.GitHub.com Somente usuários autenticados com a conta correta podem acessar essa URL.
Administrando controle remoto
Os proprietários da empresa e da organização controlam se os usuários podem habilitar o controle remoto usando a política de "Controle Remoto". Essa política está desativada por padrão.
Para obter mais informações, consulte Gerenciando políticas e recursos para GitHub Copilot em sua organização e Administrando Copilot CLI para sua empresa.