# 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.

Source: https://aicodeops.dev/fr/docs/sessions

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

1. Ouvrez **Develop → AI Sessions** et choisissez **New session**.
2. Remplissez le formulaire **Start an AI session** (champs ci-dessous).
3. 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](https://aicodeops.dev/fr/docs/agents).
- **Project :** obligatoire. Le code généré par l'IA appartient toujours à un [projet](https://aicodeops.dev/fr/docs/projects).
- **Model tier** ou **Model :** les modèles à utiliser. Consultez [Modèles et niveaux](https://aicodeops.dev/fr/docs/models).
- **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é](https://aicodeops.dev/fr/docs/quality-gates).
- **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](https://aicodeops.dev/fr/docs/approvals-and-policies).

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

- [Agents et workflows](https://aicodeops.dev/fr/docs/agents)
- [Barrières qualité](https://aicodeops.dev/fr/docs/quality-gates)
- [Maîtrise des coûts](https://aicodeops.dev/fr/docs/cost-controls)

## 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.
