Utilisation du bac à sable local

Activez le bac à sable local afin d’exécuter Copilot pour CLI les commandes et les outils qu’il appelle pour votre compte à l’intérieur d’un bac à sable du système d’exploitation.

Dans cet article

Remarque

Les bacs à sable locaux pour GitHub Copilot souhaitent être modifiés préversion publique .

Important

Le bac à sable local sur Windows nécessite une build Windows Insiders.

À propos du bac à sable local

Le bac à sable (sandbox) est actuellement une fonctionnalité expérimentale. Pour l’utiliser, commencez Copilot pour CLI par l’option ‑‑experimental de ligne de commande ou entrez /experimental on pendant une session.

Lorsque vous activez le bac à sable local, Copilot pour CLI exécute la plupart des commandes et des outils qu’il appelle pour votre compte à l’intérieur d’un bac à sable du système d’exploitation. Après avoir activé le bac à sable local, il est utilisé pour toutes vos Copilot pour CLI sessions jusqu’à ce que vous le désactiviez ou désactivez-le pour une session spécifique.

Par défaut, les commandes et outils en bac à sable peuvent écrire dans votre répertoire de travail actuel et les dossiers temporaires. Votre répertoire de profil utilisateur (accueil), ainsi que les emplacements système et outil sont en lecture seule. D’autres emplacements de disque sont bloqués. Dans un référentiel Git, l’accès au-dessus du répertoire de travail actuel varie selon le système d’exploitation. L’accès à votre réseau local et privé est autorisé, car il s’agit d’un accès Internet sortant.

Par défaut, les opérations Git et GitHub CLI (gh) authentifiées continuent de fonctionner à l’intérieur du bac à sable, car Copilot pour CLI rend vos GitHub informations d’identification disponibles pour les commandes en bac à sable( sandbox). Cela permet d’effectuer des actions telles que git push et gh pr create de réussir. Vous pouvez désactiver ce paramètre dans vos paramètres de bac à sable.

Pour obtenir une vue d’ensemble conceptuelle du bac à sable dans Copilot pour CLI, consultez À propos des bacs à sable cloud et locaux pour GitHub Copilot.

Activation du bac à sable local

Pour activer le bac à sable local, entrez la commande suivante dans une session interactive Copilot pour CLI :

Shell
/sandbox enable

Le bac à sable commence à être utilisé immédiatement pour la session active.

Après avoir activé le bac à sable local, il continue d’être utilisé pour les sessions interactives actuelles et futures, ainsi que pour les sessions programmatiques.

Remarque

Si vous avez d’autres sessions ouvertes lorsque vous entrez /sandbox enable, le bac à sable n’est pas utilisé immédiatement dans ces sessions. Pour utiliser le bac à sable dans une session déjà ouverte, effectuez l’une des opérations suivantes dans cette session :

  • Fermez la session et redémarrez-la, par exemple en exécutant copilot --continue.
  • Appuyez sur /sandbox enable.

Désactivation du bac à sable local

Pour arrêter d’utiliser le bac à sable local, entrez la commande suivante dans une session interactive Copilot pour CLI :

Shell
/sandbox disable

Le bac à sable n’est plus utilisé dans la session active ou dans les sessions nouvelles et redémarrées.

Votre choix d’utiliser le bac à sable local est enregistré en tant que sandbox.enabled paramètre dans votre fichier de paramètres personnels pour l’interface CLI (~/.copilot/settings.json par défaut).

Utilisation du bac à sable pour une seule session

Vous pouvez utiliser l’option de ligne de commande pour utiliser le --sandbox bac à sable pour une seule session, sans activer le bac à sable pour vos autres sessions. Si le bac à sable est déjà activé, vous pouvez le désactiver pour une seule session à l’aide de l’option --no-sandbox .

Vous pouvez combiner ces options avec l’option de ligne de commande pour contrôler le -p bac à sable (sandbox) pour une utilisation programmatique de l’interface CLI. Par exemple:

Shell
copilot --sandbox -p "PROMPT"

Exécution d’une seule commande en dehors du bac à sable

Lorsqu’une commande a besoin d’un accès plus large que le bac à sable, Copilot peut demander d’exécuter cette seule commande en dehors du bac à sable. Vous êtes affiché une invite de confirmation décrivant la commande et s’exécute en dehors du bac à sable uniquement si vous l’approuvez ; sinon, il reste en bac à sable. Le reste de votre session reste en bac à sable dans les deux sens.

Ce comportement est activé par défaut et peut être désactivé dans vos paramètres de bac à sable.

Vérification de l’utilisation du bac à sable

Pour vérifier si le bac à sable est utilisé pour la session active, examinez la ligne d’état. Si le bac à sable est utilisé, la ligne d’état contient sandbox enabled.

L’affichage des informations de bac à sable dans la ligne d’état est activé par défaut. S’il est désactivé, vous pouvez le réactiver :

  1. Appuyez sur /statusline.
  2. Déplacez la sélection vers le bas de la liste des options vers le bac à sable.
  3. Appuyez sur Entrée pour activer/désactiver le paramètre afin qu’il affiche une coche.

Lectures complémentaires