Skip to main content
Local Hands (accès à la machine locale) permet à une session Devin dans le cloud d’exécuter des commandes et de manipuler des fichiers sur votre propre ordinateur. Utilisez cette fonctionnalité lorsque la tâche nécessite une ressource qui n’existe que sur votre machine : une copie locale du dépôt contenant des modifications non validées, un appareil de votre réseau, un outil qui passe par votre VPN ou les logs d’un build local. Votre ordinateur ne remplace pas la VM de la session. Devin conserve sa VM et dispose en plus d’un second ensemble d’outils qui s’exécutent sur votre machine. Les deux machines ont chacune leurs propres fichiers, répertoires de travail et environnements ; Devin ne transfère des données de l’une à l’autre qu’au moyen d’appels d’outils que vous approuvez, comme une copie de fichier.
Local Hands est en cours de déploiement progressif. Si le paramètre Local Hands n’apparaît pas, la fonctionnalité n’est pas encore disponible pour votre organisation.
Local Hands est le nom de la fonctionnalité ; la carte d’accès et les notifications éphémères la désignent sous le nom local machine access. Dans l’en-tête de la session, une machine connectée apparaît sous le nom Local Hands. Ne confondez pas Local Hands avec Devin Connect, qui permet à Devin d’accéder à des réseaux privés.

​
Fonctionnement

1

Devin demande l'accès

Lorsqu’une tâche nécessite votre machine, Devin publie une carte Local machine access requested dans la session. Cette carte indique le motif de la demande et son heure d’expiration. Dans Devin Desktop, elle affiche un bouton Approve ; dans le navigateur, elle affiche une commande devin connect accompagnée d’un code d’association. Vous pouvez aussi en faire la demande directement, par exemple « exécute les tests sur ma machine locale ».
2

Vous connectez votre machine

Approuvez la requête sur la machine que Devin doit utiliser : cliquez sur Approve dans Devin Desktop, ou exécutez devin connect dans un terminal. Consultez Connecter votre machine.
3

Devin utilise les outils locaux

Les outils locaux de Devin deviennent disponibles et l’en-tête affiche le badge Local Hands. Vous devez approuver chaque appel d’outil, sauf si vous activez le contournement.
4

La connexion prend fin

La connexion prend fin lorsque vous révoquez l’accès, arrêtez devin connect ou fermez la fenêtre Devin Desktop ayant approuvé la requête, ou encore lorsque la session se termine. Les outils locaux disparaissent en même temps.

​
Prérequis

  • Une session Devin dans le cloud dont vous êtes propriétaire. Devin envoie le code d’association au compte du propriétaire de la session : une autre personne qui consulte la session ne peut donc pas connecter sa machine. Les sessions sans utilisateur pour approuver l’accès, comme les sessions planifiées, les automatisations et les sessions API exécutées par un utilisateur de service, ne peuvent pas demander de machine.
  • La Devin CLI ou Devin Desktop installé sur la machine à connecter et connecté au compte Devin propriétaire de la session. Pour la CLI, exécutez devin auth login.
  • Le paramètre Local Hands activé pour votre organisation. Consultez Disponibilité.

​
Connecter votre machine

La méthode la plus simple consiste à utiliser Devin Desktop : ouvrez-y la session et cliquez sur Approve. Si vous travaillez depuis un navigateur, exécutez la commande devin connect affichée sur la carte dans un terminal de la machine que vous souhaitez connecter. Une requête est single-use et expire 10 minutes après sa création par Devin. Toute nouvelle requête remplace la précédente, et l’ancien code d’association n’est alors plus valide.
Ouvrez la session dans Devin Desktop. La carte affiche Approve et Decline. Cliquez sur Approve pour connecter la machine sur laquelle s’exécute Devin Desktop. Aucun code d’association ni terminal n’est nécessaire. Si vous préférez la CLI, cliquez sur Use the terminal instead pour afficher la commande.
Si la requête a expiré, cliquez sur Connect this machine sur la carte dans Devin Desktop, ou sur Request a new code dans le navigateur.

​
Confidentialité de la session

Lorsque vous connectez une machine à une session dont vous êtes propriétaire, Devin rend la session privée : vous seul pouvez lui envoyer des messages. Cela empêche les autres membres de votre organisation de piloter une session capable d’exécuter des commandes sur votre ordinateur. Pour conserver le paramètre de confidentialité actuel de la session, utilisez --public :

​
Ce que Devin peut faire sur votre machine

Devin peut exécuter des commandes shell, lire des fichiers et y effectuer des recherches, créer et modifier des fichiers, et copier des fichiers entre votre machine et la VM de la session. Devin ne peut en aucun cas contrôler l’écran, le clavier ni la souris de votre machine. Computer Use s’applique uniquement à la VM de la session.

​
Approbations

Par défaut, chaque appel d’outil local est mis en pause et vous demande confirmation. La session affiche l’outil et ses arguments, avec trois options :
  • Allow once : exécuter cet appel.
  • Allow for this session : exécuter cet appel, ainsi que les appels suivants du même outil, sans demande de confirmation jusqu’à la déconnexion de la machine.
  • Deny : rejeter cet appel. Devin est informé du refus et peut essayer une autre approche.
Vos règles d’autorisation Devin CLI s’appliquent également aux appels d’outils locaux. Une règle allow exécute un appel correspondant sans demande de confirmation, une règle deny le bloque et une règle ask impose une demande de confirmation à chaque fois. Cela inclut les règles définies par votre organisation dans les Paramètres d’équipe.

​
Contourner les autorisations locales

Pour ne plus avoir de demande de confirmation à chaque appel, cliquez sur Bypass local permissions sur la carte d’accès ou dans le menu Local Hands. Les appels d’outils locaux s’exécutent alors sans prompt jusqu’à la déconnexion de la machine. Les demandes en attente sont approuvées immédiatement. Pour que chaque connexion démarre en mode contournement, définissez local_tools_bypass_permissions dans votre configuration Devin CLI. Lorsque vous activez ou désactivez le contournement depuis la session, la CLI met à jour ce paramètre.
Lorsque le contournement est activé, Devin peut exécuter des commandes et modifier des fichiers sur votre ordinateur sans vous demander votre accord. Ne l’utilisez que pour des sessions et des tâches auxquelles vous faites confiance.

​
Appels qui demandent toujours une approbation

Des règles intégrées imposent une demande d’approbation systématique pour certains appels, même lorsque le mode Contournement est activé. Ni Allow for this session ni vos propres règles allow ne permettent de les approuver. Elles concernent les fichiers d’identifiants et les clés privées, l’escalade de privilèges, les commandes destructrices, les interpréteurs de shell, les coffres de secrets, ainsi que les écritures dans les profils de shell et la configuration Git. La carte d’approbation indique pourquoi un appel nécessite une approbation explicite. Vos règles ask et celles de votre organisation fonctionnent de la même manière.

​
Se déconnecter ou révoquer l’accès

  • Révoquer l’accès : cliquez sur Revoke access sur la carte d’accès ou dans le menu Local Hands. Devin perd immédiatement l’accès aux outils locaux.
  • Arrêter la CLI : appuyez sur Ctrl+C dans le terminal où s’exécute devin connect.
  • Fermer Devin Desktop : la connexion prend fin lorsque vous fermez la fenêtre Devin Desktop qui a approuvé la requête, ou lorsque vous quittez Devin Desktop.
  • Mettre fin à la session : la connexion est fermée à la fin de la session.
devin connect se reconnecte automatiquement après une brève coupure réseau. Si la machine reste hors ligne ou si vous arrêtez la commande, le badge indique que la machine est déconnectée. Pour vous reconnecter, demandez à Devin de solliciter à nouveau l’accès, puis utilisez le nouveau code.

​
Disponibilité

Les administrateurs de l’organisation contrôlent cette fonctionnalité via l’option Local Hands dans Settings > Devin. Cette option est activée par défaut pour les organisations qui ne font pas partie d’une Enterprise, et désactivée par défaut pour celles qui appartiennent à une Enterprise. Local Hands n’est pas disponible dans les cas suivants :
  • La session utilise un profil de sécurité.
  • Les déploiements natifs sont désactivés pour votre organisation.
  • Aucun utilisateur n’est associé à la session pour approuver l’accès (sessions planifiées, automatisations et sessions API exécutées avec un service-user).

​
Dépannage

Devin Cloud dans la CLI

Lancez et pilotez des sessions Devin dans le cloud depuis votre terminal

Autorisations de la CLI

Rédigez des règles allow, ask et deny pour les appels d’outils

Passer le relais aux Devins dans le cloud

Transférez une tâche locale vers une session Devin dans le cloud

Computer Use

Comment Devin utilise le bureau de sa propre VM