Passer au contenu principal
Computer Use en arrière-plan permet à Alter de piloter des apps sur votre Mac sans prendre le contrôle de votre écran. Vous continuez à taper, lire et changer de fenêtre pendant que l’agent travaille dans une fenêtre en arrière-plan. Un aperçu flottant en direct et une carte de session Edge Bar montrent la progression — et vous pouvez arrêter l’exécution à tout moment. C’est l’expérience par défaut de l’agent Computer Use (computer_use_task), introduite dans 2.0.0-beta100.

Quand utiliser le mode arrière-plan

Utilisez Computer Use en arrière-plan lorsque :
  • Vous voulez qu’Alter scrape une page, remplisse un formulaire ou navigue dans une app pendant que vous continuez votre travail
  • La tâche peut prendre plusieurs minutes et vous ne voulez pas QuickHub attaché à la fenêtre cible
  • Vous devez exécuter l’automatisation UI sur une fenêtre qui n’est pas votre app au premier plan
Le Computer Use de type premier plan (QuickHub attaché à la cible, overlay sur l’app) existe encore pour les anciens flux. Pour presque tout nouveau travail, décrivez la tâche complète dans un objectif Computer Use et laissez l’agent en arrière-plan s’en charger.

Interface principale

Commencez par l’aperçu Computer Use — passez un goal à computer_use_task et l’agent boucle avec son ensemble d’outils.

Comment fonctionne une exécution en arrière-plan

Lorsque vous (ou l’agent parent) invoquez Computer Use, Alter :
  1. Démarre une session Edge Bar immédiatement — avant que le subagent résolve sa fenêtre cible
  2. Applique la présentation edgebarOnly — QuickHub ne s’attache pas à l’app cible, et l’overlay n’est pas dessiné sur cette fenêtre
  3. Exécute un subagent dédié qui boucle avec les outils UI (read_screen_ax, perform, scroll, etc.) pendant jusqu’à 600 secondes (10 minutes)
  4. Route les entrées vers la fenêtre cible en arrière-plan via BackgroundInputDriver
  5. Suit la fenêtre cible active et la reflète dans la carte de session et l’aperçu en direct
Vous gardez le contrôle de votre Mac. Les raccourcis globaux comme ⌘C, ⌘V, ⌘Tab ne sont pas utilisés par l’agent.

Carte de session Edge Bar

Pendant une exécution active, une session Computer Use apparaît dans l’Edge Bar (nécessite le mode QuickHub). Chaque carte affiche :
  • Objectif — le texte de la tâche demandée
  • Statut — ce que fait l’agent
  • App cible — nom, icône et titre de fenêtre une fois liée
  • Arrêter — annule le subagent immédiatement
Quand une session se termine, échoue ou est arrêtée, la carte passe à un état terminal et disparaît après un court délai.

Fenêtre d’aperçu en direct

L’aperçu flottant est une fenêtre picture-in-picture montrant une capture en direct de la fenêtre contrôlée par l’agent (~15 fps).

Afficher l’aperçu automatiquement

Par défaut, l’aperçu s’ouvre au démarrage d’une tâche Computer Use. Désactivez dans Paramètres → Computer use → Afficher l’aperçu automatiquement.

Watch preview

Quand l’aperçu est masqué, ouvrez-le depuis le Tool Inspector sur la tâche en cours : sélectionnez l’exécution Computer Use, cliquez Watch preview.

Taille de l’aperçu

Choisissez Petit, Grand ou Personnalisé sous Paramètres → Computer use → Taille de l’aperçu. Jusqu’à six sessions concurrentes peuvent apparaître dans le sélecteur d’aperçu.

Routage des entrées en arrière-plan

BackgroundInputDriver envoie clics, clavier et défilement au processus cible sans activer l’app au premier plan :
RouteQuand utilisée
SkyLightPréférée quand le serveur de fenêtres peut livrer les événements
Per-PIDEnvoie les événements directement au processus cible
HID fallbackDernier recours
Les apps Chromium (Chrome, Edge, Brave, Arc, Electron) et Safari utilisent le défilement clavier en arrière-plan car les événements de scroll natifs sont peu fiables.

Ciblage de fenêtre pendant les exécutions en arrière-plan

Les outils UI résolvent windowID dans cet ordre :
  1. windowID explicite dans l’appel d’outil
  2. Cible suivie — fenêtre ouverte via open_app, open_urls ou outil antérieur
  3. Repli de session — pendant edgebarOnly, la fenêtre liée à l’aperçu en direct
  4. Fenêtre au premier plan — seulement hors session arrière-plan
Les pages web ouvertes avec open_urls pendant Computer Use vont au navigateur agent si configuré sous Paramètres → Computer use → Navigateur agent. Avec Nettoyer à la fin activé, Alter ferme les onglets ouverts par l’agent quand la dernière session se termine.

Arrêter, annuler et timeout

ActionEffet
Arrêter (aperçu ou carte)Annule le subagent ; l’agent parent reçoit un message pour résumer
Timeout 600 sLe subagent s’arrête
Ignorer (session terminée)Retire la carte de Edge Bar
Alter ne relance pas automatiquement Computer Use après un arrêt.

Paramètres

Configurez sous Paramètres → Computer use :
  • Navigateur agent
  • Nettoyer à la fin
  • Afficher l’aperçu automatiquement
  • Taille de l’aperçu
  • Apps bloquées
Référence complète : Paramètres → Computer use.

Dépannage

L’aperçu n’apparaît jamais

  • Vérifiez Afficher l’aperçu automatiquement, ou cliquez Watch preview dans le Tool Inspector
  • Edge Bar doit être disponible (mode QuickHub activé)

L’agent agit sur la mauvaise fenêtre

  • Incluez un windowID spécifique dans votre objectif
  • Demandez à l’agent d’appeler list_windows une fois

Erreurs d’app bloquée

Les gestionnaires de mots de passe sont bloqués par défaut. Ajustez : Paramètres → Computer use → Apps bloquées.

Échecs de permission

Computer Use en arrière-plan nécessite Accessibilité et Enregistrement d’écran. Accordez les deux sous Paramètres → Permissions ou Paramètres → Doctor.

Docs associées