Projets¶

Donne à chaque travail son étagère. Un projet est un dossier à part sur le serveur de ton agent, avec ses propres fichiers, ses propres instructions et ses propres conversations. La rénovation reste avec la rénovation, la thèse avec la thèse, le tout sur un seul agent.

🏠 Généralton dossier principal

💬Programme de la semaine
💬Questions sur la déclaration d'impôts

📁 Rénovationles nouveaux chats commencent ici

📝« Budget 15 000 €, toujours comparer trois devis »
📄devis.pdf · plan.png
💬Carrelage de la cuisine
💬Planning de l'électricien

📁 Voyage en famille👥 partagé

📄billets.pdf
💬Programme jour par jour

Ce qu'un projet t'apporte¶

Un dossier à part

L'agent travaille dans le dossier du projet : les fichiers que tu envoies dans ses conversations y atterrissent, tout comme les fichiers qu'il crée, le code qu'il exécute et les tâches qu'il planifie.
Ses propres instructions

Une note que l'agent lit au début de chaque conversation du projet : à quoi il sert, comment travailler, ce qu'il faut garder à l'esprit.
Ses propres conversations

La liste des conversations affiche le projet où tu te trouves, et chaque nouveau chat y commence. Rien à retenir, rien à trier après coup.
Privé ou partagé

Sur un agent que tu partages avec d'autres, un projet peut n'être qu'à toi, ou partagé avec tout le monde, fichiers et conversations compris.

Tout le reste est identique dans tous les projets : la mémoire et la personnalité de l'agent, ses compétences, le modèle et les paramètres, les clés et les connexions, ainsi que ton crédit. Le Gestionnaire de fichiers et le Terminal du panneau montrent toujours l'ensemble du serveur. Changer de projet change l'endroit où l'agent travaille, pas qui il est.

1 Active les projets¶

Les projets sont désactivés tant que personne ne les active, et pendant ce temps rien n'en apparaît : toutes les conversations travaillent dans ton dossier principal. Comme ils sont nouveaux, le panneau les marque Bêta.

Panneau : Paramètres → Projets → Utiliser les projets.
Telegram : envoie /projects et appuie sur ▶️ Activer les projets.

L'interrupteur vaut pour tout l'agent : toute personne qui l'utilise, propriétaire ou utilisateur invité, peut l'activer ou le désactiver. Le désactiver ne touche à aucun dossier. Les conversations commencées dans un projet continuent d'y travailler ; seules les nouvelles reviennent à ton dossier principal.

2 Crée un projet¶

Panneau : ouvre le sélecteur de projets en haut de la barre latérale et choisis Nouveau projet. Donne-lui un nom, clique sur Ajouter un projet, et te voilà dedans, avec un nouveau chat qui t'attend.
Telegram : /projects → ➕ Nouveau projet, puis envoie le nom. Le bot crée le projet et t'y fait basculer.
Paramètres → Projets → + Nouveau projet en crée un sans quitter le projet où tu te trouves.

Chaque projet a son propre dossier sur le serveur de l'agent.

💡 Quand Autoriser des utilisateurs supplémentaires est activé sur ton agent, le panneau demande aussi Qui peut le voir : Moi seulement ou Tous les utilisateurs de cet agent. Tu peux changer ce choix plus tard, voir Projets sur un agent partagé. Un projet créé dans Telegram démarre en privé.

3 Passe d'un projet à l'autre¶

Dans le panneau, le sélecteur au-dessus de la liste des conversations indique le projet où tu te trouves. Choisis-en un autre : ses conversations remplissent la liste, et les nouveaux chats y commencent. Gérer les projets, en bas du même menu, ouvre les paramètres.

Dans Telegram, /projects (ou /menu → Paramètres → 📁 Projets) affiche tes projets : 🏠 ton dossier principal, 📁 les tiens, 👥 les projets partagés, avec ✅ sur le projet actif. Appuie sur un autre pour basculer. Si le chat où tu te trouves appartient à un autre projet, une nouvelle conversation démarre aussitôt dans celui que tu as choisi, et son titre épinglé commence par le nom du projet. /sessions affiche ensuite les conversations de ce projet, avec son nom en tête.

Renommer, partager, modifier les instructions et retirer un projet, tout cela se fait dans le panneau.

Bon à savoir :

Une conversation reste là où elle a commencé. Changer de projet ne déplace jamais un chat déjà en cours. Il garde son projet, son dossier et ses instructions ; le changement décide seulement où commence le suivant.
Le panneau et Telegram choisissent chacun de leur côté. Tu peux être dans Rénovation sur Telegram pendant que le panneau affiche Thèse. Chacun retient son propre choix.

4 Donne des instructions au projet¶

Paramètres → Projets → le ⋯ à côté d'un projet → Instructions…

Écris-y ce que l'agent doit savoir : à quoi sert le projet, qui y participe, les décisions déjà prises, la façon dont tu aimes que le travail soit fait. L'agent le lit au début de chaque conversation de ce projet, tu n'as donc pas à réexpliquer le contexte à chaque fois.

Par exemple

« Rénovation de notre appartement. Budget 15 000 €, fin des travaux en mars. Toujours comparer au moins trois devis. Tenir un tableau des coûts dans couts.xlsx et le mettre à jour à chaque nouvelle offre. »

L'essentiel en premier

Une conversation déjà en cours garde les instructions avec lesquelles elle a commencé : une modification s'applique donc à partir du chat suivant. Des instructions longues ne posent pas de problème, mais seuls les premiers milliers de caractères parviennent directement à l'agent ; il lit le reste dans le fichier quand il en a besoin.

Les instructions sont enregistrées dans le dossier du projet sous forme de fichier ordinaire (AGENTS.md) : tu peux donc aussi demander à l'agent de les rédiger ou de les mettre à jour pour toi.

Ton dossier principal¶

Chaque personne qui utilise l'agent a son propre dossier principal, affiché comme Général dans le sélecteur. C'est là que travaillent les conversations quand les projets sont désactivés, et là que se trouve tout ce qui date d'avant les projets.

Général est ton chez-toi, pas un projet : on ne peut ni le renommer, ni le partager, ni le retirer. C'est aussi l'endroit pour le travail qui touche plusieurs projets. Depuis un projet, l'agent s'en tient au dossier de ce projet ; depuis Général, il peut accéder à tous.

Projets sur un agent partagé¶

Quand tu partages ton agent avec d'autres personnes, chacune a son propre dossier principal et ses propres projets. Chaque projet est de l'un de ces deux types :

Privé (par défaut)

Visible seulement dans ta liste, et seules tes conversations y vont.
Partagé

Visible pour tous les utilisateurs de l'agent et marqué Partagé. Tout le monde travaille avec les mêmes fichiers et instructions, et les conversations qu'il contient sont partagées elles aussi.

Dans un projet partagé, les conversations sont un terrain commun. Tout le monde les voit dans la liste du projet et peut les lire, les poursuivre, les renommer ou les supprimer, si bien que plusieurs personnes peuvent travailler dans le même chat : dans le panneau, ou dans Telegram, où /sessions les marque d'un 👥 et où il suffit d'appuyer dessus pour en rejoindre une. Chaque message indique qui l'a écrit, et l'agent sait à qui il répond. Il répond à un message à la fois : s'il est en train de répondre à quelqu'un d'autre, le panneau ou le bot te le signale, et tu envoies le tien une fois la réponse arrivée.

Partager ou rendre privé, depuis le menu ⋯ du projet : Partager avec tous les utilisateurs ou Rendre privé. Un projet rendu privé disparaît des listes des autres, et leurs conversations qui s'y trouvaient continuent dans leur propre dossier principal.
Qui gère un projet partagé : la personne qui l'a créé et le propriétaire de l'agent. Le renommer et le retirer leur revient. Seul son créateur peut le rendre à nouveau privé.
Les tâches en arrière-plan d'un projet partagé sont à tout le monde. Chaque utilisateur les voit dans Paramètres → Tâches en arrière-plan, peut les modifier et reçoit leurs notifications dans le panneau et sur Telegram.
Quand un utilisateur est supprimé, les projets qu'il partageait restent partagés et passent au propriétaire. Ses projets privés disparaissent des listes, et les fichiers restent sur le serveur.

Privé veut dire non listé, pas sous clé

Les utilisateurs invités sont des utilisateurs de confiance. Le travail de chacun s'exécute sous le même compte sur le serveur de l'agent : un projet privé est donc masqué dans les listes des autres, mais ce n'est pas un coffre-fort. Garde ce qui est vraiment secret hors d'un agent partagé.

Retirer un projet, ou le supprimer pour de bon¶

La suppression se fait en deux étapes, pour que rien ne disparaisse par accident :

⋯ → Retirer de la liste. Le projet disparaît des listes, mais ses fichiers et ses conversations restent sur le serveur, et tes conversations de ce projet apparaissent sous Général. Tu retrouves le projet dans Projets retirés, en bas de Paramètres → Projets, où Remettre dans la liste le fait revenir.
Projets retirés → ⋯ → Supprimer définitivement… Cette action supprime le dossier avec tous ses fichiers et toutes les conversations qui y ont travaillé, et elle est irréversible. Pour confirmer, tu saisis le nom du dossier. Pour un projet partagé, le panneau t'indique aussi combien d'autres utilisateurs y ont des conversations.

Bon à savoir¶

Renommer ne change que le nom. Le dossier garde le nom qu'il avait à sa création, donc les liens, scripts et outils qui l'utilisent continuent de fonctionner. La fenêtre des instructions affiche le vrai nom du dossier.
Les fichiers que tu envoies restent avec le projet. Un fichier envoyé dans une conversation d'un projet est copié dans uploads, à l'intérieur du dossier du projet, et l'agent travaille dessus sur place. Quand les projets sont désactivés, les fichiers sont conservés comme avant.
Les tâches en arrière-plan s'exécutent dans un projet. Dans Paramètres → Tâches en arrière-plan, le premier champ d'une tâche est son projet, et une nouvelle tâche démarre dans celui que tu as ouvert. Une tâche que tu demandes à l'agent dans une conversation d'un projet s'exécute dans ce projet. La tâche d'un projet partagé prévient tous ceux qui utilisent l'agent ; toute autre tâche, toi seul. Tant que les projets sont désactivés, chaque tâche ne prévient que la personne à qui elle appartient.
La recherche couvre tout. L'agent cherche dans l'historique de toutes tes conversations, quel que soit leur projet, et peut te dire de quel projet vient un résultat.
L'API travaille dans Général. Les appels passés par l'API compatible OpenAI de l'agent travaillent toujours dans le dossier principal de l'appelant.
Jusqu'à 50 projets tiennent sur un agent, tous utilisateurs confondus. Un nom peut compter jusqu'à 60 caractères.