Sobre o acesso remoto às CLI do GitHub Copilot sessões

Este artigo explica os conceitos em torno do acesso remoto às CLI do Copilot sessões. Para obter instruções sobre como habilitar o acesso remoto, consulte Controlando uma CLI do GitHub Copilot sessão de outro dispositivo.

Introdução

Quando você inicia uma CLI do GitHub Copilot sessão no computador local, a sessão normalmente só pode ser acessada no terminal em que você a iniciou. No entanto, você pode habilitar o acesso remoto à sessão a partir de GitHub.com e GitHub Mobile, permitindo que você exiba o progresso de uma tarefa que Copilot está sendo executada, e que você responda a solicitações de mais informações ou de permissões.

Isso é útil em cenários como:

•         **Saindo da estação de trabalho**: você iniciou uma sessão no laptop e foi chamado para sair ou terminou o trabalho do dia, mas deseja continuar interagindo Copilot sem precisar retornar à máquina.
  

•         **Monitorando uma tarefa de longa execução**: você iniciou uma tarefa complexa que levará tempo para ser concluída, mas não deu Copilot permissão total para executar todas as ações. Você precisa avaliar e responder periodicamente às solicitações de permissão para permitir que uma tarefa continue.
  

  Para garantir a estabilidade do recurso de acesso remoto, há um limite de 60 MB no tamanho da saída da sessão que é passado para a interface remota. Como resultado, sessões de execução muito longas que geram grandes quantidades de saída podem ter um desempenho reduzido na interface remota. A sessão do terminal local não é afetada.

•         **Acesso rápido de um dispositivo móvel**: Você está trabalhando em outra coisa agora, mas está usando GitHub Mobile para fornecer uma visão rápida do progresso de uma tarefa que você começou em CLI do Copilot.
  

Pré-requisitos

O acesso remoto requer:

•         **Habilitação de política**: para usuários que têm um Copilot assento de uma organização, o acesso remoto é regido por políticas definidas no nível da organização e da empresa. A política de "Controle Remoto" está desativada por padrão, mas pode ser habilitada por um proprietário da empresa ou da organização. Consulte [Administrar o acesso remoto](#administering-remote-access).
  

•         **Um GitHub repositório: o diretório** de trabalho no qual você iniciou a CLI deve conter um repositório Git hospedado GitHub.com. Se você tentar habilitar o acesso remoto fora de um GitHub repositório, a CLI exibirá a mensagem: "Sessão remota desabilitada: não em um GitHub repositório"
  

•         **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 sua conexão, o acesso remoto não estará disponível até que o computador esteja online novamente. Consulte [Reconexão](#reconnection) 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 `--prompt` de linha de comando, por exemplo, quando você usa a CLI em um script.
  

Acessando uma sessão remotamente

Ao habilitar o acesso 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.
  

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.

Se você fechou uma sessão que tinha acesso remoto habilitado, ao retomar a sessão , usando copilot --continue ou copilot --resume=ID, você deverá reabilitar o acesso remoto. Para obter mais informações, consulte Controlando uma CLI do GitHub Copilot sessão de outro dispositivo.

Visibilidade das sessões de acesso remoto

O acesso remoto só está disponível para você — a pessoa que está conectado GitHub com a mesma conta que iniciou a sessão da CLI. Ninguém mais pode exibir ou interagir com sua sessão remotamente.

Pontos a serem observados

Quando você habilita o acesso remoto:

• Os eventos de sessão são enviados do computador local para GitHub. Isso inclui mensagens de conversa, eventos de execução de ferramentas e solicitações de permissão.
• Os comandos remotos são sondados por CLI do Copilot a partir de GitHub e injetados em sua sessão local.
• A própria 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 acesso remoto não concede acesso direto ao computador local 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 acesso 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 o acesso remoto

A capacidade dos usuários de habilitar o acesso remoto às suas CLI do Copilot sessões pode ser controlada por políticas nas configurações da empresa ou da organização. Os usuários que obtêm Copilot de uma organização não poderão usar o acesso remoto se ele tiver sido desabilitado no nível da organização ou da empresa.

A política de "Controle Remoto" está desativada por padrão, portanto, ela deve ser habilitada por uma empresa ou proprietário da organização antes que os usuários possam começar a monitorar e orientar suas sessões da CLI remotamente.

Para obter mais informações sobre como definir políticas para sua empresa ou organização, consulte Gerenciando políticas e recursos para GitHub Copilot em sua organização e Administrando Copilot CLI para sua empresa.