> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Concepts clés

> Sessions, projets, serveurs cloud, exécution sur votre appareil, Harness et modèles, sources de modèles, permissions, interventions requises et sous-agents, ainsi que le rôle de chaque zone de l'interface.

Cette page explique les concepts que vous rencontrerez régulièrement en utilisant Cloud Agent. Les deux plus importants sont les **sessions** et les **serveurs cloud** : vous confiez du travail à l'agent dans une session, et l'agent le réalise sur un serveur cloud ou sur votre ordinateur.

## Sessions

Une **session** est l'historique complet de votre travail avec l'agent sur une tâche donnée, y compris vos messages, les étapes de l'agent, ses réponses et ses modifications. Une session peut appartenir à un projet ou à aucun projet. Cliquez sur **New chat** dans la barre latérale pour démarrer une session. Vous pouvez archiver les sessions terminées et, lorsque vous souhaitez essayer une autre direction, bifurquer (fork) une nouvelle session à partir d'un message. Consultez [Démarrer une session](https://docs.aihubmix.com/fr/cloud/sessions/start-a-session.md) et [Gérer les sessions](https://docs.aihubmix.com/fr/cloud/sessions/manage-sessions.md).

## Projets

Un **projet** est le répertoire de code ou le dépôt auquel une session appartient. Il en existe deux types :

* **Projet cloud** : créé dans le cloud, importé depuis GitHub ou téléversé depuis votre ordinateur. Il s'exécute sur le serveur cloud, et vous pouvez lui configurer un environnement.
* **Projet local** : un dossier de votre ordinateur associé dans l'application de bureau. Les sessions s'exécutent sur cet ordinateur, et le dossier n'est pas synchronisé avec le cloud.

Une session qui n'appartient à aucun projet s'exécute dans un répertoire de travail temporaire. Vous pouvez la déplacer dans un projet plus tard. Consultez [Projets et configuration de l'environnement](https://docs.aihubmix.com/fr/cloud/environments/projects.md).

## Serveur cloud et exécution sur votre appareil

Un **serveur cloud** est la machine Linux dédiée avec une IP publique incluse avec Plus. Les sessions qui s'y exécutent continuent lorsque vous éteignez votre ordinateur. Vous pouvez ouvrir un bureau à distance pour suivre ce que fait l'agent ou prendre le contrôle vous-même.

L'**exécution sur votre appareil** (affichée dans l'interface sous le nom **Run on your device**) est l'autre mode d'exécution : l'agent reste dans le cloud, mais la lecture et l'écriture des fichiers ainsi que l'exécution des commandes ont lieu sur l'ordinateur que vous choisissez, avec le même effet qu'une exécution locale. Cet ordinateur doit être connecté à l'application de bureau avec **Allow execution** activé.

| | Serveur cloud | Sur votre appareil |
| - | - | - |
| Environnement et fichiers utilisés | La copie du projet et l'environnement du projet sur le serveur cloud | L'environnement et les dossiers de projet de cet ordinateur |
| Projets disponibles | Projets cloud, sessions sans projet | Projets locaux de cet ordinateur, sessions sans projet |
| Harness pris en charge | Tous | Uniquement Claude Code pour le moment |
| Ordinateur éteint ou hors ligne | Aucun effet | La tâche en cours est mise en pause et reprend automatiquement après la reconnexion |

Vous choisissez le lieu d'exécution lors de la création d'une session et ne pouvez plus le modifier ensuite. Consultez [Serveur cloud](https://docs.aihubmix.com/fr/cloud/environments/cloud-host.md) et [Exécuter sur votre appareil](https://docs.aihubmix.com/fr/cloud/environments/your-device.md).

## Harness et modèles

Un **Harness** est le framework qui exécute l'agent, comme Claude Code ou Codex CLI. Un **modèle** est le grand modèle de langage que le Harness appelle. Après l'envoi du premier message d'une session, vous ne pouvez plus changer de Harness, mais vous pouvez toujours changer de modèle. Le **niveau de raisonnement** (affiché dans l'interface sous le nom **Effort**) détermine la profondeur de réflexion du modèle. Les niveaux disponibles varient selon le modèle. Consultez [Choisir un modèle](https://docs.aihubmix.com/fr/cloud/models/choose-a-model.md).

## Sources de modèles

La **source de modèles** détermine qui fournit le modèle et où l'utilisation est comptabilisée.

| | Modèles Plus | Vos abonnements | BYOK |
| - | - | - | - |
| Description | Modèles inclus dans le forfait Plus | Vos propres comptes d'abonnement ChatGPT, Claude ou autres | Clés API que vous ajoutez vous-même |
| Où l'utilisation est comptabilisée | Le forfait Plus, sans frais supplémentaires | Le quota de ce compte d'abonnement | Le fournisseur correspondant, facturé à ses tarifs |

Avec BYOK, AIHubMix est un fournisseur passerelle ordinaire : une clé API AIHubMix que vous ajoutez est facturée de la même manière que toute autre clé et n'a aucun lien avec Plus. Consultez [Sources de modèles](https://docs.aihubmix.com/fr/cloud/models/model-sources.md).

## Permissions

Les **permissions** déterminent si l'agent vous demande votre accord avant d'effectuer une action. Choisissez-les en bas à gauche du champ de saisie :

* **Ask for approval** : demande toujours votre accord avant de modifier des fichiers en dehors de l'environnement ou d'accéder à Internet.
* **Approve for me** : ne demande que lorsqu'il détecte une action potentiellement dangereuse.
* **Full access** : accède à Internet et à tous les fichiers de l'environnement cloud sans restriction. Les nouvelles sessions utilisent ce niveau par défaut.

Vous pouvez modifier les permissions à tout moment pendant une session.

## Votre intervention est requise

Lorsque l'agent s'arrête pour attendre que vous approuviez une commande, répondiez à une question, fournissiez un secret ou effectuiez une action qu'il ne peut pas faire à votre place, comme une connexion, **votre intervention est requise** dans la session. La demande apparaît au-dessus du champ de saisie, et la session est également signalée dans la barre latérale. Une fois la demande traitée, la session reprend automatiquement. Consultez [Travailler avec l'agent](https://docs.aihubmix.com/fr/cloud/sessions/work-with-agent.md).

## Sous-agents

Un **sous-agent** est un assistant que l'agent envoie au sein de la même session pour traiter certaines parties du travail en parallèle. Une fois qu'ils ont tous terminé, les résultats sont fusionnés dans la session principale. Vous pouvez consulter le déroulement de chaque sous-agent dans le panneau de droite, mais vous ne pouvez pas lui envoyer de message directement. Un sous-agent est différent d'une session que vous bifurquez manuellement : la bifurcation crée une session distincte et ordinaire. Consultez [Sous-agents](https://docs.aihubmix.com/fr/cloud/sessions/subagents.md).

## Aperçu de l'interface

* **Barre d'icônes** : la colonne d'icônes à l'extrême gauche de la fenêtre. Elle permet de passer de Cloud Tasks à Scheduled, Projects, Cloud servers et Activity. L'avatar en bas ouvre le menu du compte.
* **Barre latérale** : la liste des sessions, regroupées en Pinned, Cloud projects, Local projects et Recents.
* **Zone de session** : la zone principale au centre de la fenêtre. Elle affiche les messages échangés entre vous et l'agent, ses étapes et les résultats.
* **Champ de saisie** : en bas de la zone de session. Il sert à envoyer des messages, ajouter des pièces jointes et choisir le modèle, le niveau de raisonnement et les permissions.
* **Panneau de droite** : les modifications, les fichiers, les aperçus web, le bureau à distance du serveur cloud, la discussion latérale et les sous-agents s'ouvrent tous ici.

> [!NOTE]
>
> Le web mobile n'a pas de barre d'icônes. Les mêmes entrées se trouvent en bas de la barre latérale. Lorsque le panneau de droite s'ouvre, il occupe toute la page.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.