Partager un agent avec un client

Partager un agent avec un client, c'est donner à une personne externe une salle où elle peut poser des questions à l'agent du projet, le voir travailler et recevoir des livrables, tandis que l'agent, le code et vos identifiants restent sur votre machine. Bien fait, c'est en lecture seule par défaut, limité dans le temps et révocable en un clic. Mal fait, c'est un compte partagé.

C'est la configuration que nous recommandons aux agences, aux freelances et à quiconque a un client qui souhaite « voir où ça en est » plus souvent qu'un point hebdomadaire ne le permet.

La structure

Un client, une salle, un agent, un dossier.

• Un dossier. ~/clients/acme ne contient que le projet de ce client. L'agent qui y est assigné ne peut pas voir ~/clients/beta, le dossier de votre entreprise ou vos clés.
• Un agent, nommé d'après le client pour éviter toute confusion : acme.
• Une salle, avec le client et vous. Vos autres salles lui sont invisibles.
• Le mode plan pour l'agent, pour qu'il réponde aux questions sans rien modifier sur le disque, sauf décision contraire de votre part.

Le client voit la salle ; la salle voit un seul dossier ; tout le reste sur la machine est hors de portée.

Ce que le client peut faire

• Poser des questions : « qu'est-ce qui a changé cette semaine », « pourquoi l'export prend-il une minute », « montre-moi les design tokens actuels ».
• Voir l'agent travailler dans la timeline : les fichiers qu'il a lus, les commandes qu'il a exécutées, la fin de la sortie texte.
• Recevoir des artefacts : un récapitulatif, un diagramme, un fichier exporté, une image d'aperçu.
• Joindre des éléments : une capture d'écran d'un bug, un tableur contenant des modifications de texte.

Ce que le client ne peut pas faire

• Modifier du code, en mode plan. Si vous basculez l'agent sur acceptEdits pour une phase donnée, ses modifications ne peuvent toujours pas push, supprimer, dépenser ni toucher à des identifiants sans votre approbation.
• Voir les fichiers. Le daemon téléverse des événements de la timeline, pas l'arbre de travail. Consultez ce que le daemon téléverse.
• Voir les autres salles, les autres clients ou vos propres agents.
• Approuver ses propres actions dangereuses. Celles-ci vous sont directement transmises.

Limitation dans le temps

Accordez au client une autorisation permanente pour la durée du projet, et programmez un rappel pour la date de fin. Révoquer l'autorisation, retirer le client de la salle ou arrêter le daemon prend effet immédiatement ; les requêtes en attente venant de lui sont annulées et tout ce qui est en cours d'exécution se termine et reste dans l'historique. Les liens d'invitation peuvent eux-mêmes comporter une expiration et un nombre maximal d'utilisations.

Livrables et approbations

Un client qui demande à l'agent de « push le fix » déclenche l'action push to a shared branch et se met en attente de votre validation. C'est le comportement souhaité : vous décidez du moment où un livrable est expédié. Approuvez-le, rejetez-le, ou répondez « continue read-only » et livrez-le vous-même plus tard. La note que vous y joignez fait partie de l'historique.

Ce que cela remplace

Checklist

1. Créez ~/clients/<name> et clonez-y le projet.
2. Créez un agent assigné à ce dossier, en mode plan, nommé d'après le client.
3. Créez une salle ; ajoutez l'agent ; invitez le client avec un lien qui expire.
4. Approuvez sa première requête ; puis accordez « Allow always » pour la durée du projet si vous souhaitez qu'il n'ait plus à vous attendre.
5. Installez le daemon en tant que service pour que la salle fonctionne même lorsque vous n'êtes pas à votre bureau.
6. À la fin du projet : révoquez l'autorisation et retirez le membre. L'historique reste conservé pour vous.

Foire aux questions

Le client a-t-il besoin d'un compte ? Il se connecte avec un code par e-mail ou via Google pour accepter l'invitation. Aucune installation requise.

Deux clients peuvent-ils partager un même agent ? À éviter. Un dossier par client garantit une séparation physique, et pas seulement logique.

Combien cela me coûte-t-il ? Les requêtes s'exécutent sur votre abonnement. La consommation par personne est enregistrée, ce qui vous permet de voir ce que coûtent les questions du client et de refacturer en conséquence si vous le souhaitez.

Le client peut-il voir mes prompts envoyés à l'agent ? Uniquement ce qui se passe dans sa salle. Vos propres travaux sur la même base de code doivent se faire dans une autre salle avec un agent différent.

Donnez une salle au projet et laissez le client poser ses questions. Commencez ici.