Lancer votre premier agent

Ce que vous allez créer

À la fin de ce tutoriel, vous aurez :

• Un agent que vous avez créé et configuré vous-même
• Un espace où vous et cet agent clavardez
• Une exécution terminée, avec du travail commité dans un arbre de travail isolé et une ligne dans le journal d’exécution de l’agent

Prérequis : Votre premier espace de travail est terminé, de sorte que cet espace de travail compte un dépôt enregistré et au moins un fournisseur de modèles connecté.

Étape 1 : Créer un agent

1. Allez dans Paramètres → Espace de travail → Agents
2. Cliquez sur Nouvel agent. Un agent appelé « Agent sans nom » est créé immédiatement et sélectionné dans la liste des agents — il n’y a ni boîte de dialogue de création ni rien à confirmer. Vous le configurez sur place.
3. Dans l’onglet Paramètres, remplissez :
   • Nom : quelque chose de court et mémorable, comme alice. C’est ce que vous tapez après @.
   • Titre : ce qu’il fait, par ex. « Développeur backend »
   • Adaptateur : Control Center (built-in). Choisissez-le délibérément — seul le harnais intégré peut être piloté en cours d’exécution et mis en pause à une limite de tour, et il n’exige aucune CLI installée sur l’hôte du serveur.
   • Modèle : choisissez dans la liste que sert le fournisseur connecté
   • Compétences : attachez celles qui conviennent, par ex. testing ou architecture
4. Appuyez sur Enregistrer les modifications

Un agent sans adaptateur s’exécute sur la boucle intégrée

Lorsque le champ Adaptateur n’est pas défini, le lancement se rabat sur Control Center (built-in) — la boucle d’agent à l’intérieur du serveur, de sorte que rien n’a besoin d’être installé sur l’hôte. Il a tout de même besoin d’un modèle : sans aucun de défini, il demande à Anthropic sa valeur par défaut, ce qui fonctionne si vous avez connecté un compte Anthropic et échoue sinon avec No credential for provider "anthropic". Définissez les deux explicitement de toute façon, sinon vous vous exécuterez sur un modèle que vous n’avez pas choisi.

Point de contrôle. La ligne de l’agent dans la liste affiche son nom et un anneau d’état vide.

Étape 2 : Démarrer un espace

1. Dans la barre latérale, repérez la section Espaces et cliquez sur le bouton +
2. Donnez un nom à l’espace
3. Sous Ajouter des agents, sélectionnez l’agent que vous venez de créer
4. Si l’espace de travail compte des dépôts, choisissez ceux sur lesquels cet espace doit travailler
5. Cliquez sur Créer

L’espace s’ouvre. En arrière-plan, Control Center provisionne un arbre de travail en copie sur écriture des dépôts sélectionnés pour cette conversation, sur sa propre branche. Votre checkout source n’est jamais modifié.

Étape 3 : Envoyer une tâche

Saisissez une tâche concrète et petite sur le dépôt que vous avez enregistré. Quelque chose dont le résultat est vérifiable fonctionne le mieux — ajoutez un test, corrigez un avertissement de lint, renommez un symbole.

Appuyez sur Entrée. Vous n’avez pas besoin de mentionner quelqu’un avec @ : avec un seul agent dans l’espace, un simple message le réveille. Dans un espace comptant plusieurs agents, @name en désigne un.

Control Center assemble l’invite à partir des instructions de l’agent, de sa persona, de ses compétences et du contexte de l’espace, puis lance l’exécution.

Point de contrôle. Le bouton d’envoi du composeur devient un bouton d’arrêt — un agent travaille dans cette conversation — et le texte commence à arriver.

Étape 4 : Le regarder travailler

La conversation affiche l’exécution au fur et à mesure :

• Raisonnement, affiché en ligne pendant que l’agent réfléchit
• Appels d’outils : lectures et écritures de fichiers, recherches, commandes shell, chacun avec son résultat
• Texte : résumés, explications et questions qui vous sont adressées

Si l’agent pose une question, répondez dans la conversation et il reprend.

Pour les paramètres propres à une exécution et ses commandes de pause, de reprise et d’arrêt, repérez l’agent en cours dans la section Agents du panneau Général de l’espace et choisissez Ouvrir l’activité.

Dans le volet d’activité, la pastille d’état affiche En cours, puis Réussi à la fin de l’exécution. Une exécution qui cale ou qui boucle affiche Bloqué ; une exécution qui se termine en erreur affiche Échoué. Dans le registre des agents, l’anneau de la liste est vide avant la première exécution et plein dès que l’agent redevient inactif.

Ce qui encadre l’exécution : son propre arbre de travail en copie sur écriture, les identifiants délivrés par le courtier au lancement et révoqués au démontage, un environnement assaini, la surface d’outils que son mode autorise et les garde-fous d’action. Les effets comme pousser une branche ou ouvrir une demande de tirage sont contrôlés séparément — voir Garde-fous.

Étape 5 : Vérifier le résultat

1. Ouvrez Paramètres → Espace de travail → Agents et sélectionnez votre agent
2. Ouvrez l’onglet Journaux

Point de contrôle. Une ligne d’exécution, affichant son état, sa durée, ses heures de début et de fin et l’adaptateur utilisé.

Les modifications de l’agent sont commitées sur la branche de la conversation, dans son arbre de travail. Les commits sont attribués à l’agent, avec votre nom crédité dans une ligne Co-Authored-By:.

Obtenir une demande de tirage

Rien n’ouvre de demande de tirage de lui-même. Si vous en voulez une, demandez-la dans la même conversation :

Poussez cette branche et ouvrez une demande de tirage vers la branche par défaut.

Le push (gitPush) et la création de PR (prCreate) demandent tous deux votre approbation par défaut, attendez-vous donc à une confirmation avant chacun. Si aucun approbateur n’est connecté au moment où l’invite se déclenche, l’action est refusée plutôt qu’autorisée — les garde-fous échouent en mode fermé.

La PR est ouverte sous l’identité GitHub dont l’exécution a utilisé le jeton — la vôtre, si vous avez enregistré un jeton personnel — et non sous le nom de l’agent. La qualité d’auteur de l’agent apparaît sur les commits.

Vous pouvez aussi l’ouvrir vous-même : le panneau Contrôle de source de l’espace comporte un bouton Créer une demande de tirage qui transporte la branche de la conversation dans l’écran de rédaction, et Demandes de tirage → Nouvelle PR ouvre le même écran vide. C’est là que le prochain tutoriel reprend.

Récapitulatif

Vous avez créé un agent, configuré son adaptateur et son modèle, lui avez donné un espace et une tâche, et avez regardé une vraie exécution se terminer dans un arbre de travail isolé sans toucher à votre checkout.

Ensuite : Examiner votre première demande de tirage pour apprendre le flux de révision.

Pour en savoir plus sur les agents : Le modèle d’agent. Pour les détails du lancement : Cycle de vie du lancement d’un agent.