En este artículo se explican los conceptos sobre el acceso remoto a las CLI de Copilot sesiones. Para obtener instrucciones sobre cómo habilitar el acceso remoto, consulte Controlar una CLI de GitHub Copilot sesión desde otro dispositivo.
Introducción
Cuando se inicia una CLI de GitHub Copilot sesión en el equipo local, normalmente solo se puede acceder a la sesión desde el terminal donde se inició. Sin embargo, puede habilitar el acceso remoto a la sesión desde GitHub.com y GitHub Mobile, lo que le permite ver el progreso de una tarea en la que Copilot está trabajando y responder a solicitudes de más información o solicitudes de permisos.
Esto es útil en escenarios como:
-
**Salir de la estación de trabajo**: inició una sesión en su portátil y luego fue llamado o terminó el trabajo, pero desea continuar interactuando con Copilot sin tener que volver a la máquina. -
**Supervisión de una tarea de larga duración**: ha iniciado una tarea compleja que tardará tiempo en completarse, pero no ha concedido Copilot permiso completo para llevar a cabo todas las acciones. Debe evaluar y responder periódicamente a las solicitudes de permisos para permitir que una tarea continúe.Para garantizar la estabilidad de la característica de acceso remoto, hay un límite de 60 MB en el tamaño de la salida de sesión que se pasa a la interfaz remota. Como resultado, las sesiones de duración muy prolongada que generan grandes cantidades de salida pueden experimentar un rendimiento reducido en la interfaz remota. La sesión del terminal local no se ve afectada.
-
**Acceso rápido desde un dispositivo móvil**: ahora está trabajando en otra cosa, pero está usando GitHub Mobile para proporcionar una vista rápida del progreso en una tarea que inició en CLI de Copilot.
Nota:
- El acceso remoto a las sesiones de CLI de Copilot está en versión preliminar pública y está sujeto a cambios.
- Actualmente, el acceso móvil solo está disponible en la versión beta más reciente de GitHub Mobile. Puede unirse al programa de prueba para GitHub Mobile a través de Apple TestFlight para iOS y Google Play para Android.
Prerrequisitos
El acceso remoto requiere:
-
**Habilitación de directivas**: para los usuarios que tienen un Copilot puesto de una organización, el acceso remoto se rige por las directivas establecidas en el nivel de organización y de empresa. La directiva "Control remoto" está desactivada de forma predeterminada, pero puede habilitarla un propietario de la empresa o de la organización. Consulte [Administración del acceso remoto](#administering-remote-access). -
**Un GitHub repositorio**: el directorio de trabajo donde inició la CLI debe contener un repositorio de Git hospedado en GitHub.com. Si intenta habilitar el acceso remoto fuera de un GitHub repositorio, la CLI muestra el mensaje: "Sesión remota deshabilitada: no en un GitHub repositorio" -
**La máquina debe estar en línea**: la sesión de la CLI debe ejecutarse activamente en un terminal en una máquina con una conexión a Internet. Si la máquina entra en suspensión o pierde su conexión, el acceso remoto no estará disponible hasta que la máquina vuelva a estar en línea. Consulte [Reconexión](#reconnection) más adelante en este artículo. -
**Una sesión interactiva**: el acceso remoto solo está disponible para las sesiones interactivas. No está disponible cuando se usa la CLI mediante programación con la `--prompt` opción de línea de comandos, por ejemplo, cuando se usa la CLI en un script.
Acceso a una sesión de forma remota
Al habilitar el acceso remoto para una CLI de Copilot sesión, puede ir a GitHub.com o GitHub Mobile buscar la sesión en la lista de sesiones recientes del agente. La interfaz remota se actualiza en tiempo real, lo que le permite supervisar la salida en curso de la sesión y responder a solicitudes de avisos y solicitudes de permisos a medida que entran.
Tanto el terminal local como la interfaz remota están activos al mismo tiempo. Puede escribir comandos en cualquiera de las interfaces. CLI de Copilot utiliza la primera respuesta que recibe a cualquier solicitud o petición de permiso.
La sesión continúa ejecutándose en el equipo local. La interfaz remota proporciona una manera de interactuar con la sesión, pero la propia CLI (y todas las herramientas, comandos de shell y operaciones de archivo que se ejecutan) permanecen en la máquina donde inició la sesión.
Qué puede hacer de forma remota
Cuando se conecta a una sesión de forma remota desde GitHub.com o GitHub Mobile, puede hacer lo siguiente:
-
**Responder a solicitudes de permisos**: aprobar o denegar solicitudes de permiso de herramientas, rutas de acceso a archivos y URLs. -
**Responder a preguntas**: responda cuando Copilot le pida que proporcione más información o tome una decisión. -
**Aprobar o rechazar planes**: responda a las solicitudes de aprobación del plan cuando Copilot está en modo de plan. -
**Enviar nuevas indicaciones**: escriba preguntas o instrucciones, tal como lo haría en el terminal. -
**Cambiar modos**: cambiar el modo de sesión, por ejemplo, entre el modo interactivo y el modo de plan. -
**Finalizar la operación actual: cancele** el trabajo actual del agente.
Nota:
Los comandos de barra diagonal, como /allow-all, no están disponibles actualmente en la interfaz remota.
Reconexión
Si la conexión entre el equipo local y GitHub se pierde temporalmente (por ejemplo, debido a una interrupción de la red), puede seguir usando la sesión de forma remota en cuanto se restaure la conexión.
Puede usar el /keep-alive comando slash para evitar que el equipo entre en suspensión. Consulte Impedir que la máquina vaya a dormir.
Si cerró una sesión que tenía habilitado el acceso remoto, al reanudar la sesión( ya sea mediante copilot --continue o copilot --resume=ID), debe volver a habilitar el acceso remoto. Para obtener más información, vea Controlar una CLI de GitHub Copilot sesión desde otro dispositivo.
Visibilidad de las sesiones de acceso remoto
El acceso remoto solo está disponible para usted, la persona que ha iniciado sesión en GitHub con la misma cuenta que inició la sesión de la CLI. Nadie más puede ver o interactuar con la sesión de forma remota.
Puntos que se deben tener en cuenta
Al habilitar el acceso remoto:
- Los eventos de sesión se envían desde la máquina local a GitHub. Esto incluye mensajes de conversación, eventos de ejecución de herramientas y solicitudes de permisos.
- Los comandos remotos son sondeados por CLI de Copilot desde GitHub e insertados en tu sesión local.
- La propia CLI continúa ejecutándose localmente. Todos los comandos de shell, las operaciones de archivo y las ejecuciones de herramientas se producen en el equipo: el acceso remoto no concede acceso directo a la máquina local más allá de lo que el agente de la CLI puede hacer dentro de la sesión.
El vínculo de sesión remota (que se muestra en la CLI al habilitar el acceso remoto) apunta a una dirección URL específica de sesión en GitHub.com. Solo los usuarios autenticados con la cuenta correcta pueden acceder a esta dirección URL.
Administración del acceso remoto
La capacidad de los usuarios para habilitar el acceso remoto a sus CLI de Copilot sesiones se puede controlar mediante directivas en la configuración de la empresa u organización. Los usuarios que obtienen Copilot de una organización no podrán usar el acceso remoto si se ha deshabilitado en el nivel de organización o de empresa.
La directiva "Control remoto" está desactivada de forma predeterminada, por lo que debe habilitarla un propietario de la empresa o de la organización para que los usuarios puedan empezar a supervisar y dirigir sus sesiones de la CLI de forma remota.
Para obtener más información sobre cómo establecer directivas para su empresa u organización, consulte Administración de directivas y características para GitHub Copilot en su organización y Administración de la CLI de Copilot para su empresa.