Cet article explique les concepts relatifs à l’accès à distance aux CLI Copilot sessions. Pour obtenir des instructions sur l’activation de l’accès à distance, consultez Direction d’une session à partir d’un CLI de GitHub Copilot autre appareil.
Présentation
Lorsque vous démarrez une CLI de GitHub Copilot session sur votre ordinateur local, la session est normalement accessible uniquement à partir du terminal où vous l’avez démarrée. Toutefois, vous pouvez activer l’accès à distance depuis GitHub.com et GitHub Mobile, ce qui vous permet d’afficher la progression d’une tâche sur laquelle Copilot travaille et de répondre aux demandes d’informations supplémentaires ou de permissions.
Cela est utile dans les scénarios tels que :
-
**Quitter votre station de travail** : vous avez démarré une session sur votre ordinateur portable et été ensuite appelé, ou vous avez terminé le travail pour la journée, mais vous souhaitez continuer à interagir avec Copilot sans avoir à revenir à la machine. -
**Surveillance d’une tâche de longue durée** : vous avez démarré une tâche complexe qui prendra du temps à se terminer, mais sans donner Copilot l’autorisation complète d’effectuer chaque action. Vous devez évaluer et répondre régulièrement aux demandes d’autorisation pour permettre à une tâche de continuer.Pour garantir la stabilité de la fonctionnalité d’accès à distance, il existe une limite de 60 Mo sur la taille de la sortie de session passée à l’interface distante. Par conséquent, des sessions très longues qui génèrent de grandes quantités de sortie peuvent rencontrer des performances réduites dans l’interface distante. La session de terminal local n’est pas affectée.
-
**Accès rapide à partir d’un appareil mobile** : vous travaillez sur autre chose maintenant, mais vous utilisez GitHub Mobile pour fournir une vue d’ensemble de la progression sur une tâche que vous avez démarrée CLI Copilot.
Remarque
- L’accès à distance aux CLI Copilot sessions est en préversion publique et est susceptible de changer.
- L’accès mobile est actuellement disponible uniquement dans la dernière version bêta de GitHub Mobile. Vous pouvez rejoindre le programme de test via GitHub MobileApple TestFlight pour iOS et Google Play pour Android.
Prerequisites
L’accès à distance nécessite :
-
**Activation de la politique** : pour les utilisateurs disposant d’un Copilot accès depuis une organisation, l’accès à distance est régi par les politiques définies au niveau de l’organisation et de l’entreprise. La stratégie « Contrôle à distance » est désactivée par défaut, mais peut être activée par un propriétaire d’entreprise ou d’organisation. Consultez [Administration de l’accès à distance](#administering-remote-access). -
**Un GitHub référentiel** : le répertoire de travail sur lequel vous avez démarré l’interface CLI doit contenir un référentiel Git hébergé sur GitHub.com. Si vous tentez d’activer l’accès à distance en dehors d’un GitHub référentiel, l’interface CLI affiche le message : « Session distante désactivée : non dans un GitHub référentiel » -
**L’ordinateur doit être en ligne** : la session CLI doit s’exécuter activement dans un terminal sur un ordinateur disposant d’une connexion Internet. Si la machine passe en veille ou perd sa connexion, l’accès à distance n’est pas disponible tant que la machine n’est pas en ligne. Consultez [Reconnexion](#reconnection) plus loin dans cet article. -
**Session interactive** : l’accès à distance est disponible uniquement pour les sessions interactives. Il n’est pas disponible lorsque vous utilisez l’interface CLI par programmation avec l’option `--prompt` de ligne de commande, par exemple lorsque vous utilisez l’interface CLI dans un script.
Accès à distance à une session
Lorsque vous activez l’accès à distance pour une CLI Copilot session, vous pouvez aller à GitHub.com ou GitHub Mobile et trouver la session dans la liste de vos sessions d’agent récentes. L’interface distante est mise à jour en temps réel, ce qui vous permet de surveiller la sortie en cours de la session et de répondre aux invites et demandes d’autorisation à mesure qu’elles viennent.
Le terminal local et l’interface distante sont actifs en même temps. Vous pouvez entrer des commandes dans l’une ou l’autre interface. CLI Copilot utilise la première réponse qu’elle reçoit à toute invite ou demande d’autorisation.
Votre session continue à s’exécuter sur votre ordinateur local. L’interface distante permet d’interagir avec la session, mais l’interface CLI elle-même, ainsi que tous les outils, commandes de l’interpréteur de commandes et opérations de fichier qu’il exécute, restent sur l’ordinateur où vous avez démarré la session.
Ce que vous pouvez faire à distance
Quand vous êtes connecté à une session à distance depuis GitHub.com ou GitHub Mobile, vous pouvez :
-
**Répondre aux demandes d’autorisation** : approuver ou refuser l’outil, le chemin d’accès au fichier et les demandes d’autorisation d’URL. -
**Répondre aux questions : répondez** lorsque Copilot vous vous invitez à fournir plus d’informations ou à prendre une décision. -
**Approuver ou rejeter des plans** : répondez aux invites d’approbation de plan lorsqu’elles Copilot sont en mode plan. -
**Envoyez de nouvelles invites : entrez des** questions ou des instructions, comme vous le feriez dans le terminal. -
**Modes de basculement** : modifiez le mode de session, par exemple, entre le mode interactif et le mode plan. -
**Terminez l’opération actuelle** : annulez le travail actuel de l’agent.
Remarque
Les commandes de barre oblique, comme /allow-all, ne sont actuellement pas disponibles depuis l’interface distante.
Reconnexion
Si la connexion entre votre ordinateur local et GitHub est temporairement perdue, par exemple en raison d’une interruption du réseau, vous pouvez continuer à utiliser la session à distance dès que la connexion est restaurée.
Vous pouvez utiliser la /keep-alive commande slash pour empêcher votre ordinateur d’être en veille. Voir Empêcher votre machine de dormir.
Si vous avez fermé une session dont l’accès à distance était activé, lorsque vous reprenez la session( à l’aide copilot --continue ou copilot --resume=ID) vous devez réactiver l’accès à distance. Pour plus d’informations, consultez « Direction d’une session à partir d’un CLI de GitHub Copilot autre appareil ».
Visibilité des sessions d’accès à distance
L’accès à distance n’est disponible que pour vous seul, la personne qui est connectée à GitHub avec le même compte que celui qui a démarré la session CLI. Personne d’autre ne peut afficher ou interagir avec votre session à distance.
Points à noter
Lorsque vous activez l’accès à distance :
- Les événements de session sont envoyés à partir de votre ordinateur local vers GitHub. Cela inclut les messages de conversation, les événements d’exécution d’outils et les demandes d’autorisation.
- Les commandes distantes sont interrogées par CLI Copilot à partir de GitHub et injectées dans votre session locale.
- L’interface CLI elle-même continue à s’exécuter localement. Toutes les commandes d’interpréteur de commandes, opérations de fichier et exécutions d’outils se produisent sur votre ordinateur. L’accès à distance n’accorde aucun accès direct à votre ordinateur local au-delà de ce que l’agent CLI peut faire au sein de la session.
Le lien de session à distance (affiché dans l’interface CLI lorsque vous activez l’accès à distance) pointe vers une URL spécifique à la session sur GitHub.com. Seuls les utilisateurs authentifiés disposant du compte approprié peuvent accéder à cette URL.
Administration de l’accès à distance
La possibilité pour les utilisateurs d’activer l’accès à distance à leurs CLI Copilot sessions peut être contrôlée par des stratégies dans les paramètres de l’entreprise ou de l’organisation. Les utilisateurs qui obtiennent Copilot d’une organisation ne pourront pas utiliser la fonctionnalité d’accès à distance si elle a été désactivée au niveau de l’organisation ou de l’entreprise.
La stratégie « Contrôle à distance » est désactivée par défaut. Elle doit donc être activée par un propriétaire d’entreprise ou d’organisation avant que les utilisateurs puissent commencer à surveiller et à diriger leurs sessions CLI à distance.
Pour plus d’informations sur la définition de stratégies pour votre entreprise ou votre organisation, consultez Gestion des stratégies et des fonctionnalités pour GitHub Copilot dans votre organisation et Administration de l’interface CLI Copilot pour votre entreprise.