Projet personnel, client fictif, artisans réels

Cocon · Agent IA

Un agent IA qui agit à votre place, sous contrôle

Jusqu'où laisser faire un agent, et comment la personne garde la main. Cas concret : de la facture d'énergie à la visite d'un artisan RGE.

L'enjeu
Faire des travaux dans sa résidence, estimer le coût et maîtriser un agent IA qui réserve un artisan.
Mon rôle
Recherche, parcours, comportement de l'agent, prompt, fiches outils, maquettes, code et mise en ligne.
Stack
Node.js, API Claude (Haiku), boucle d'outils écrite à la main, JavaScript sans framework, API RGE de l'ADEME
Résultat
Six outils qui font tous les calculs.

Le prototype fonctionne : vous pouvez suivre le parcours jusqu'à la réservation.

Essayer Cocon
L'écran « Vérifiez avant de réserver » de Cocon : à gauche la conversation avec l'agent, à droite le récapitulatif de la visite du jeudi 29 octobre à 14 h, l'artisan, l'objet et ce que l'artisan reçoit. En haut, la jauge des quatre étapes, à l'étape Artisan.
Avant la seule action irréversible, un récapitulatif complet : l'artisan, le créneau, ce qu'il reçoit et ce que ça engage.

Le cas d'usage

Les Moreau, maison de 1974 à Melun

Quatre écrans du parcours Cocon : la consommation (3 450 € par an), les travaux rentables cochés, le plan de financement (6 200 € à payer) et le choix d'un créneau chez trois artisans certifiés.
Les quatre étapes des Moreau : consommation, travaux, plan de financement, artisans et créneaux.

Le fil rouge du projet : 120 m², chaudière gaz de 2008, DPE E.

1. L'analyse

Cocon a déjà leurs douze factures : premier résultat sans rien demander. Une seule question, pour confirmer l'année, la surface et le chauffage.

2. Les travaux

La pompe à chaleur rapporte le plus : environ 1 950 € par an pour 14 000 €, remboursée en 7 ans. L'agent précise l'hypothèse clé, un rendement de 2,6 avec les radiateurs actuels.

3. Les aides

Revenus demandés en tranche, refus possible. La page affiche quand l'argent arrive, et que l'accord de l'Anah doit précéder le devis d'au moins 15 jours.

4. L'artisan

Trois entreprises réelles à moins de 9 km. L'agent signale de lui-même deux qualifications qui expirent en novembre 2026. À « oui c'est bon, réserve », il renvoie au bouton.

3 450 €de gaz par an, dont 78 % pour le chauffage
10 200 €d'aides sur 16 400 € de travaux, en tranche modeste
6 200 €environ à payer, pour environ 2 100 € de gain par an

Quand l'agent s'arrête

La rénovation d'ampleur exige un audit et un accompagnateur agréé. L'agent s'arrête à l'étape 3 et oriente vers France Rénov' avec le récapitulatif du plan.

L'enjeu

Maîtriser les réponses et les actions d'un agent IA

Le projet en 45 secondes : le parcours de l'analyse aux travaux, l'agent et ses six outils, le serveur qui décide, puis Cocon en exemple.

Cocon agit : il enchaîne quatre étapes et finit par engager un tiers, un artisan réel trouvé dans les données de l'ADEME.

1Analyse
2Travaux
3Aides
4Artisan
Étapes 1 et 2 · analyse, travauxLes Moreau, maison de 1974Ne savent pas par où commencer. 85 % des ménages rénovent sans conseiller.→ partir des factures, montrer les hypothèses de chaque gain
Étape 3 · aidesSophie, revenus très modestesDossier trop complexe, argent à avancer. 41 % citent les aides comme frein.→ reste à charge, date de versement, revenus en fourchette
Étape 4 · artisanPatrick, retraité démarchéNe fait confiance à personne. 37 % peinent à trouver un artisan fiable.→ qualification RGE et sa date de fin, rien sans clic
Chaque persona décroche à une étape différente. Trois proto-personas tirés d'enquêtes publiques (FBF et IFOP 2025, UFC-Que Choisir 2025, TREMI) : des hypothèses à valider.
1seule action irréversible, et un verrou dans le code qui refuse toute réservation sans clic
6outils, qui calculent tous les montants à la place du modèle
11cas difficiles conçus, aucun sans suite

Cocon est un fournisseur d'énergie fictif. Les artisans viennent des données publiques de l'ADEME.

Les validations

Trouver le bon niveau de validation pour impliquer l'utilisateur

Lancer
Confirmer la maison
Choisir les travaux
Valider le plan
Choisir un créneau
Réserver la visite
Annuler

6 clicstout reste modifiable1 consentementdonnée sensible, refus possible1 confirmation fortela seule action irréversible

Huit moments où la personne intervient. L'annulation tient en un clic : c'est ce qui rend la confirmation forte acceptable.

L'architecture

Un agent guidé, un serveur qui décide de ce qui est permis

Un agent, c'est un modèle à qui on donne des outils. J'ai écrit la boucle moi-même, sans outil d'automatisation, pour garder la main sur trois choses : l'ordre des étapes, l'état de la session et la réservation.

La pageconversation et panneau
Le serveurNode.js, boucle écrite à la main
ClaudeHaiku
1clic : combles + PAC
2Enregistre le choix dans la session
3événement, en lecture seule
4appel d'outil : estimer les aides
5Vérifie l'ordre des étapes, exécute l'outil
6montants prêts à dire
7Explique, sans rien calculer
8texte + composant du panneau
État, ordre des étapes, verrou et journal vivent ici
Claude choisit quoi dire et quel outil appeler. Le serveur décide de ce qui est permis, et Claude ne peut ni inventer ni modifier un choix de la personne.
  • Un ordre fixe. Quatre étapes, toujours dans le même ordre, et Claude décide à l'intérieur de chacune. Moins impressionnant qu'un agent libre, plus fiable.
  • Six outils déterministes, qui font tous les calculs et renvoient des montants prêts à dire (« environ 6 200 € »).
  • Les clics ne passent pas par Claude. Un texte tapé qui imite un événement est neutralisé avant de lui parvenir.

Le verrou de réservation

ClaudeAppelle « réserver »Après un clic, ou après « oui c'est bon, réserve » tapé dans la conversation.

Verrou, dans le code

Exécuté seulement si
  1. un clic « Réserver la visite » est enregistré
  2. sur le même artisan et le même créneau
  3. il y a moins de 10 minutes
  4. et n'a jamais servi
Visite réservéeAnnulable en un clic.
RefuséNoté au journal, renvoi au bouton.
Le prompt réduit les tentatives, le code les rend sans effet. Garder l'outil dans les mains de Claude permet de journaliser chaque refus : c'est ce qui prouve que le verrou sert.

Le design

Le chat guide, le panneau sert à décider

L'écran Travaux rentables de Cocon : la conversation à gauche, le tableau des travaux à droite, avec les hypothèses de la pompe à chaleur ouvertes.
La conversation à gauche, l'étape en cours à droite. Ici, les hypothèses de la pompe à chaleur, ouvertes depuis le tableau des travaux.

Dans un seul fil, les résultats remontent hors de l'écran. J'ai retenu deux colonnes : la conversation à gauche, le résultat de l'étape à droite. Sur mobile, deux onglets.

  • Le thermomètre : les quatre étapes en jauge permanente, on sait toujours où on en est.
  • Les trois niveaux de validation se voient, du simple clic à la confirmation forte.
  • Les clics apparaissent dans la conversation, en pointillé, distincts du texte tapé.
  • Chaque gain ouvre ses hypothèses : prix retenu, rendement, prix de l'électricité.

La première version ressemblait à un assistant IA de plus. Je l'ai reprise d'après l'interface d'un thermostat : filets fins, chasse fixe, grands chiffres légers. L'agent devient un instrument de mesure qui parle.

Suivez le parcours des Moreau, de la facture à la réservation.

Essayer Cocon