L’accès à distance vous permet de vous connecter à une session en cours d’exécution CLI Copilot à partir de n’importe quel navigateur ou depuis GitHub Mobile. Vous pouvez afficher la sortie de session, répondre aux demandes d’autorisation et continuer à travailler dans la session sans être sur l’ordinateur sur lequel la session est en cours d’exécution.
Cet article explique comment activer et utiliser l’accès à distance. Pour plus d’informations conceptuelles, consultez À propos de l’accès à distance aux CLI de GitHub Copilot sessions.
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’ordinateur sur lequel la session CLI est en cours d’exécution doit être en ligne, la session s’exécutant activement dans un terminal.
Conseil
Utilisez la commande slash
/keep-alivepour empêcher votre ordinateur d’être en veille pendant que vous êtes absent. Voir Empêcher votre machine de dormir. -
Le répertoire de travail doit contenir un référentiel Git hébergé sur GitHub.com. Si vous n’êtes pas dans un GitHub référentiel, l’interface CLI affiche : « Session distante désactivée : pas dans un GitHub référentiel ».
Activation de l’accès à distance pour une session
Vous pouvez activer l’accès à distance de trois façons :
- Pendant une session interactive, utilisez une commande slash.
- Avec une option en ligne de commande lorsque vous démarrez CLI Copilot.
- En configurant l’interface CLI pour activer l’accès à distance par défaut pour toutes les sessions interactives.
Utilisation de la commande /remote barre oblique
Si vous êtes déjà dans une session interactive et que vous souhaitez activer l’accès à distance, entrez :
/remote
/remote
L'interface CLI se connecte à GitHub.com et affiche les détails pour accéder à la session à distance : consultez Accéder à une session depuis GitHub.com et Accéder à une session depuis GitHub Mobile plus loin dans cet article.
Utilisation de l’option --remote de ligne de commande
Si vous pensez que vous souhaiterez peut-être accéder à distance à une session, vous pouvez démarrer l’interface CLI avec l’option --remote de ligne de commande. Cela évite de devoir se rappeler d’utiliser la /remote commande de barre oblique pendant la session.
copilot --remote
copilot --remote
Les détails relatifs à l’accès à distance à la session s’affichent lorsque la session interactive démarre et peuvent être affichées à tout moment à l’aide de la /remote commande de barre oblique.
Configuration de l’accès à distance pour toujours être activé
Si vous souhaitez toujours que vos sessions CLI interactives soient accessibles à distance, ajoutez ce qui suit à votre Copilot fichier de configuration (généralement situé à l’adresse suivante ~/.copilot/config.json) :
{
"remoteSessions": true
}
{
"remoteSessions": true
}
Pour remplacer ce paramètre pour une session particulière, utilisez l’option --no-remote lorsque vous démarrez la session :
copilot --no-remote
copilot --no-remote
Remarque
Les options --remote de ligne de commande et --no-remote sont toujours prioritaires sur le remoteSessions paramètre dans le fichier de configuration.
Accès à une session à partir de GitHub.com
Lorsque l’accès à distance est activé, l’interface CLI affiche un lien au format suivant :
https://github.com/OWNER/REPO/tasks/TASK_ID
Utilisez ce lien pour accéder à la session dans un navigateur web. Vous devez être connecté à GitHub avec le même compte que celui qui a démarré la session CLI.
Vous pouvez également accéder à la session à partir de votre liste de sessions d’assistant récentes sur GitHub.com:
- Dans le coin supérieur gauche de GitHub, cliquez sur .
- Cliquez sur Copilot.
- Sous « Sessions d’agent récentes », cliquez sur votre CLI Copilot session pour l’ouvrir.
Important
Les sessions sont spécifiques à l’utilisateur : vous pouvez uniquement accéder à vos propres CLI Copilot sessions. D’autres GitHub utilisateurs ne peuvent pas accéder à vos sessions.
Accès à une session à partir de GitHub Mobile
Une session CLI Copilot est disponible dans GitHub Mobile dès que vous activez l’accès à distance. Pour rechercher votre session dans GitHub Mobile:
-
Appuyez sur le Copilot bouton dans le coin inférieur droit de l’écran.
La session est répertoriée sous « Sessions de l’agent ».
-
Appuyez sur la session pour l’ouvrir.
Utiliser un code QR pour ouvrir rapidement une session sur votre téléphone
-
Dans une session interactive, entrez la commande slash
/remotepour réafficher les détails de la session à distance. -
<kbd>Appuyez sur Ctrl</kbd>+<kbd>E</kbd> pour activer/désactiver l’affichage d’un code QR.Remarque
Ce raccourci clavier développe/réduit tous les détails de la conversation de session, pas seulement le code QR. Cela fonctionne uniquement si le champ d’entrée est actuellement vide.
-
Scannez le code QR avec votre téléphone pour accéder directement à la session en GitHub Mobile.
Empêcher votre machine de dormir
Vous pouvez utiliser la /keep-alive commande slash pour empêcher votre machine de se mettre en veille. Cela vous permet de conserver la connexion à distance et de continuer à interagir avec la session depuis GitHub.com ou GitHub Mobile.
Dans une session interactive, entrez /keep-alive OPTION, où OPTION se trouve l’une des options suivantes :
-
`on`: empêche la machine d’être en veille pendant que la session CLI est active. -
`off`: permet à la machine de dormir normalement. -
`busy`: empêche la machine de se mettre en veille uniquement pendant que Copilot travaille sur une tâche. Une fois que l’agent a terminé une tâche, la machine peut dormir normalement. La machine ne sera pas mise en veille si Copilot attend que vous répondiez à une demande d'entrée. -
`NUMBERm`, `NUMBERh`ou `NUMBERd` (par exemple, `30m`, `8h`, `1d`) : empêche la machine de dormir pendant un nombre spécifique de minutes, d’heures ou de jours. Si un nombre nu est fourni sans suffixe, il est traité comme des minutes.
Sans passer un OPTION, la commande /keep-alive affiche le statut actuel de maintien en vie.
Reprise d’une session avec accès à distance
Lorsque vous arrêtez une session sur laquelle l’accès à distance est activé, l’interface CLI affiche une commande de reprise qui inclut --remote:
copilot --resume=SESSION_ID --remote
Utilisez cette commande pour redémarrer la session avec l’accès à distance activé.
De même, l’ajout --remote à une copilot --continue commande reprend la session la plus récente avec l’accès à distance activé.
Si vous avez "remoteSessions": true dans votre Copilot fichier de configuration, les sessions reprise ont un accès à distance activé automatiquement et vous n’avez pas besoin d’utiliser l’option --remote .
Prévention de l’accès à distance
L’accès à distance est désactivé par défaut, mais peut être activé dans votre Copilot fichier de configuration. Vous pouvez vous assurer qu’une session n’est pas accessible à distance en :
-
**Pour une seule session** : démarrez l’interface CLI `--no-remote` pour empêcher l’accès à distance pour cette session, quel que soit le paramètre de votre fichier de configuration. -
**De façon permanente** : supprimez le paramètre de votre fichier de configuration `"remoteSessions": true` (ou définissez-le sur `false`).