- Accueil
- Documentation
- Les sessions
Les sessions
Lancez une session IA dans AI CodeOps : décrivez la tâche, choisissez un projet et un workflow, regardez les agents travailler en direct, relisez le diff et ouvrez une pull request.
Une session est un travail de l'IA sur un projet. Vous décrivez une tâche ; une équipe d'agents la planifie et écrit le changement, vos tests s'exécutent dessus, puis les agents relisent ce qui a été écrit. Vous relisez ensuite le résultat et décidez s'il est livré. Tout s'exécute sur la plateforme ; vous le suivez dans le navigateur.
Lancer une session
- Ouvrez Develop → AI Sessions et choisissez New session.
- Remplissez le formulaire Start an AI session (champs ci-dessous).
- Choisissez Start session. La session est mise en file d'attente et apparaît dans la liste.
Les champs du formulaire :
- What should the session do? Décrivez la tâche en mots simples, par exemple « Add rate limiting to the public API and write tests for it. »
- Workflow : la façon dont les agents doivent travailler. Le workflow par défaut, Plan, Build, Review & Test, convient à la plupart des changements. Consultez Agents et workflows.
- Project : obligatoire. Le code généré par l'IA appartient toujours à un projet.
- Model tier ou Model : les modèles à utiliser. Consultez Modèles et niveaux.
- File context (optional) : des chemins séparés par des virgules que les agents doivent lire en premier.
Vous pouvez aussi en lancer une depuis la page d'un projet avec Run workflow.
Quelle taille un changement peut avoir
Le changement d'une session doit être assez petit pour qu'une personne puisse le relire :
- son diff peut atteindre 60 KB ;
- il peut modifier jusqu'à 25 fichiers, chacun de 64 KB au plus.
Un changement plus gros est refusé en bloc, jamais coupé : la session se termine avec « The change is too large to review » et nomme les fichiers où se trouve l'essentiel de la taille. Découpez la tâche en tâches plus petites.
Une session réécrit en entier chaque fichier qu'elle modifie, et seul le début d'un long fichier lui est montré. Une réécriture qui supprimerait des lignes qu'elle n'a jamais vues n'est pas écrite : la session reçoit ces fichiers en entier et réessaie une fois, et si le résultat les supprime encore, la session se termine en indiquant le motif. Demandez alors un changement plus ciblé, ou nommez la partie du fichier à modifier.
La suivre en direct
La page de la session se met à jour pendant son exécution. Vous voyez chaque étape (quel agent, ce qu'il fait, son statut), ainsi que le coût et les tokens de la session à mesure qu'ils s'accumulent. La liste sous AI Sessions affiche chaque session avec son projet, sa durée, son coût et son statut, et des badges pour les sessions qui ont produit des changements ou des constats.
Pour arrêter une session, choisissez Cancel session et donnez un motif. Le motif est enregistré sur la session et affiché sur sa page.
Relire le résultat
Lorsque la session se termine, sa page affiche :
- Summary : ce que les agents ont fait, dans les termes de la dernière étape. Lorsque le workflow comporte des étapes qui suivent le code, comme Review et Test, il est écrit après l'exécution de vos tests. Si ce qu'il dit des tests contredit le résultat enregistré, un avertissement placé au-dessus l'indique.
- Proposed changes : le diff, avec un téléchargement
.patch. Si votre demande nommait des fichiers et que le changement en a laissé certains intacts, une note les liste. - Quality gates : les résultats des tests et si le changement est prêt à être livré. Consultez Barrières qualité.
- Findings : les problèmes que la revue a trouvés, avec la gravité et le fichier.
Chaque session qui écrit du code est aussi listée sous Develop → Changes, où vous pouvez la suivre de la proposition à la revue, à la fusion et au déploiement.
Demander des modifications
Utilisez la zone Follow-up prompt sur la page de la session pour demander des ajustements ou une tâche suivante qui s'appuie sur celle-ci. Choisissez Send follow-up ; la session de suivi repart du contexte de la session. La page de la session de suivi affiche la Task d'origine et, en dessous, Latest request (follow-up N). Tant qu'une session est encore en cours, un suivi lance une nouvelle session liée ; celle qui est en cours continue sans changement.
Re-run relance la même tâche depuis le début.
Approuver et ouvrir une pull request
Une session qui modifie du code ouvre une revue dans Review & Gate → Approvals. Sur la page de la session, choisissez Accept changes ou Reject. La personne qui a lancé la session ne peut pas l'approuver si quelqu'un d'autre dans l'espace de travail le peut. Consultez Approbations et politiques.
Une fois le changement approuvé et ses barrières qualité franchies, AI CodeOps ouvre la pull request pour vous : une nouvelle branche codeops/run-<id> dans le dépôt du projet, vers sa branche par défaut. Vous pouvez aussi choisir Create Pull Request vous-même. Le bouton explique ce qui manque s'il est verrouillé, par exemple Connect git to open PR ou Add a repository to open PR.
Rien n'est fusionné sans votre approbation.
Terminal
Develop → Terminal (bêta) ouvre un shell à la racine d'un projet, dans son propre bac à sable isolé, pour les moments où vous voulez explorer ou exécuter une commande vous-même. Les commandes ne s'exécutent jamais sur les serveurs de la plateforme. La disponibilité dépend de votre offre.
Étapes suivantes
Questions fréquentes
Dois-je installer quelque chose pour exécuter une session ?
Non. Les sessions s'exécutent dans le cloud et vous les suivez dans le navigateur. Il n'y a ni CLI ni configuration locale.
Puis-je modifier le résultat d'une session avant de l'approuver ?
Vous pouvez demander des modifications avec un prompt de suivi. Modifier le changement après son approbation réinitialise cette approbation, il doit donc être approuvé de nouveau.