Exécuter un agent sur Hands
Passez votre premier agent Claude ou Codex sur Veyra Hands, du compte de modèle à la première exécution terminée.
Hands est le moteur qu'utilise Veyra Intelligence pour exécuter les agents : un agent de la console y tourne sans rien installer. Ce guide passe un agent Claude ou Codex sur Hands et vérifie qu'il fonctionne.
Remarque
La console est en anglais. Les noms de boutons et de menus en gras sur cette page sont les libellés exacts que vous y verrez.
Avant de commencer
- Une organisation dans Veyra Intelligence où vous pouvez recruter des agents.
- Un compte pour le harness que vous utiliserez :
- Claude : un abonnement Claude ou une clé d'API Anthropic.
- Codex : un compte ChatGPT ou une clé d'API OpenAI.
- Un environnement pris en charge par Hands : Linux sur x64 ou Arm avec glibc 2.39 ou plus récent, ou macOS. Voir où il tourne.
D'où vient Hands
Hands est intégré à Veyra Intelligence. Chaque version d'Intelligence inclut la version de Hands correspondante, et Intelligence lance Hands dans l'environnement de l'agent au début d'une exécution. Il n'y a rien à télécharger ni à installer : Hands n'est pas proposé séparément.
Exécuter un agent Claude
- Ouvrez Agents et sélectionnez New agent. Donnez-lui un nom et un rôle en une phrase.
- Sous Runtime, choisissez Claude.
- Associez le compte avec lequel il se connecte : connectez-vous avec votre abonnement Claude ou ajoutez une clé d'API Anthropic. Les clés sont stockées comme secrets chiffrés.
- Choisissez un modèle. Hands le transmet à Claude sans le modifier.
- Laissez Runner sur Automatic. Intelligence utilise Hands chaque fois que l'environnement de l'agent le prend en charge pour Claude ; choisissez Veyra Hands pour l'imposer.
- Fixez un budget mensuel et sélectionnez Hire.
Exécuter un agent Codex
- Ouvrez Agents et sélectionnez New agent. Donnez-lui un nom et un rôle en une phrase.
- Sous Runtime, choisissez Codex.
- Associez le compte avec lequel il se connecte : connectez-vous à ChatGPT dans la fenêtre de navigateur qu'ouvre Intelligence, ou ajoutez une clé d'API OpenAI.
- Choisissez un modèle. Hands le transmet à Codex sans le modifier.
- Laissez Runner sur Automatic, ou choisissez Veyra Hands pour l'imposer.
- Fixez un budget mensuel et sélectionnez Hire.
Vérifier que tout fonctionne
- Dans l'onglet Runtime de l'agent, sélectionnez Test. Intelligence lance le harness via Hands dans l'environnement de l'agent et vérifie qu'il peut se connecter et joindre le modèle. Un test ne lance aucune tâche.
- Confiez à l'agent une petite tâche, par exemple « Crée un fichier hello.txt qui contient hello, puis termine la tâche. » L'assignation réveille l'agent.
- Ouvrez la tâche. Messages, appels d'outils et modifications de fichiers arrivent dans le fil pendant que Hands exécute le tour. Publiez un commentaire pendant qu'il travaille : l'agent le lit à son étape suivante.
- Quand l'agent termine, la tâche avance et l'exécution garde son résumé, sa transcription et son coût.
En cas de problème
| Ce que vous voyez | Que faire |
|---|---|
| L'agent reste sur l'exécuteur précédent | L'environnement ne prend pas en charge Hands pour ce harness. Comparez sa plateforme à où il tourne. |
| L'exécution s'arrête sur une erreur de modèle | Le fournisseur a refusé le modèle. Choisissez un autre modèle accessible au compte ; Hands ne change pas de modèle à votre place. |
| La connexion échoue | Associez à nouveau le compte dans l'onglet Runtime de l'agent, puis relancez Test. |
Étapes suivantes
- Utilisez Hands avec Intelligence : passez-y des agents existants, pilotez les exécutions et lisez ce qu'ils ont fait.
- Environnements d'exécution et comptes de modèles dans les guides d'Intelligence.