← Tous les joursJour 5 · Paperclip
05

Pratique — Votre entreprise IA livre son premier projet

Exécutez le pipeline complet : définir un objectif, laisser le PDG décomposer, approuver la stratégie, regarder les heartbeats en action

Pourquoi "Construire une landing page" ?

Quatre jours de théorie ont été complétés. L'entreprise IA doit maintenant livrer un vrai produit. Le projet de landing page satisfait des critères spécifiques :

  • ›Couverture complète du pipeline : Planification → Design → Développement → Livraison
  • ›Résultats immédiatement visibles consultables dans un navigateur en quelques secondes
  • ›Collaboration multi-rôles à travers les postes de l'organisation
  • ›De vrais pièges qui se connectent aux apprentissages précédents

Checklist pré-vol

Requis avant de commencer :

  • ›Serveur Paperclip en cours d'exécution
  • ›Organigramme avec les rôles PDG et Ingénieur
  • ›Heartbeat du PDG activé
  • ›Budget alloué (10 $ entreprise, 5 $ par agent minimum)

Étape 1 : Assigner une mission

Créez un Objectif d'Entreprise avec des exigences spécifiques. L'exemple inclut :

  • ›Un seul fichier HTML sans ressources externes
  • ›Sections spécifiques : Hero, À propos, Vitrine de projets (3 cartes), Contact
  • ›Thème sombre avec design responsive mobile
  • ›Emplacement du fichier de sortie défini
Piège n°1 : Objectifs vagues = Output poubelle : Passez 5 minutes de plus à rendre l'objectif spécifique. Ces 5 minutes vous feront économiser 50 minutes d'allers-retours. Sans spécifications détaillées, les livrables deviennent génériques, remplis de Lorem Ipsum et de styles par défaut.

Étape 2 : Le PDG décompose la stratégie

Le PDG va :

  • ›Lire l'objectif de l'entreprise
  • ›Créer un Projet
  • ›Décomposer le projet en Tickets
  • ›Soumettre une Demande d'Approbation

Examinez soigneusement la décomposition pour la logique, les chemins de sortie et les assignations correctes.

Piège n°2 : Le PDG crée trop de Tickets : Le PDG peut sur-décomposer, créant 8-10 tickets quand 3-4 suffisent. Rejetez et ajoutez des contraintes à l'objectif original.

Étape 3 : Regarder le moteur de heartbeat travailler

Déclenchement manuel via l'interface : Cliquez sur le bouton "Run Heartbeat" sur la page de détail de l'Agent.

Via API :

bash
curl -X POST http://localhost:3100/api/agents/{agentId}/heartbeat/invoke

Le rythme respiratoire (Diastole-Systole)

Diastole : Le PDG découvre les Tickets approuvés et les assigne. Systole : L'Ingénieur récupère le travail, exécute, met à jour le statut.

Piège n°3 : Rien ne se passe après l'approbation : L'intervalle de heartbeat par défaut est de 3600 secondes (une fois par heure). Pour les tutoriels, réduisez à 120 secondes.

Pour accélérer les heartbeats, modifiez les paramètres via l'interface ou l'API :

bash
curl -X PATCH http://localhost:3100/api/agents/{agentId} \
  -H "Content-Type: application/json" \
  -d '{
    "runtimeConfig": {
      "heartbeat": {
        "enabled": true,
        "intervalSec": 120,
        "cooldownSec": 30,
        "wakeOnDemand": true,
        "maxConcurrentRuns": 1
      }
    }
  }'
ParamètreButRéglage tutoriel
intervalSecFréquence de réveil120 (2 minutes)
cooldownSecÉcart minimum entre exécutions30
wakeOnDemandDéclenchement manueltrue
maxConcurrentRunsExécution parallèle1

En production, utilisez des intervalles beaucoup plus élevés (PDG : 1 heure, Ingénieur : 30 minutes).

Étape 4 : Inspecter le livrable

Indicateurs de succès :

  • ›Tous les Tickets passés au statut "done"
  • ›Fichier index.html généré
  • ›Le PDG envoie un résumé final

Ouvrez le fichier localement pour visualiser la landing page terminée. La perfection visuelle n'est pas garantie, mais la fonctionnalité sera présente.

Étape 5 : Itérer comme un patron

N'éditez pas le code manuellement. À la place, créez de nouveaux Tickets avec des retours détaillés. Le PDG gère l'assignation et l'orchestration. Chaque itération déclenche un nouveau cycle d'exécution.

Rétrospective : ce qui s'est réellement passé

L'entreprise IA a accompli :

  • ›Reçu un objectif stratégique
  • ›Décomposé de manière autonome en tâches actionnables
  • ›Attendu l'approbation avant l'exécution
  • ›S'est auto-planifiée via le mécanisme de heartbeat
  • ›A livré un artefact tangible
  • ›A fonctionné dans les contraintes budgétaires
  • ›A itéré en fonction des retours

Concepts reliés aux jours précédents

JourConceptApplication
1Entreprise IA vs AssistantGérer une équipe, pas discuter
2OrganigrammeLe PDG a délégué à l'Ingénieur
3Alignement objectifsPage conçue pour la marque personnelle
4Contrôle budgétaireL'alerte à 80% a empêché le dépassement
5Exécution de bout en boutLes agents ont travaillé de manière autonome

Rapport de coûts

Ventilation approximative :

  • ›PDG (décomposition + 3 cycles heartbeat) : ~6,13 $
  • ›Ingénieur (génération HTML + 1 itération) : ~1,26 $
  • ›Total : ~7,39 $

Les coûts réels dépendent de la sélection du modèle, de la complexité de l'objectif et du nombre d'itérations. Le changement de modèle (Sonnet vs. Opus) peut économiser 50-70%.

Manuel d'urgence : problèmes courants

SymptômeCauseSolution
Rien après approbationintervalSec trop élevéCliquer Run Heartbeat manuellement
Agent bloqué en coursmaxTurnsPerRun dépasséAugmenter à 500
Fichier au mauvais endroitChemin manquant dans l'objectifAjouter le chemin de sortie complet
Page moche/génériqueObjectif vagueAjouter des spécifications de design
Alerte budget précoceBudget trop basAugmenter ou accepter le résultat
Deux agents modifient le même fichierGarde atomique manquantDéfinir maxConcurrentRuns: 1

Vos tâches du jour

  • [01]Rédigez un Objectif d'Entreprise spécifique pour la landing page
  • [02]Accélérez les heartbeats : changez intervalSec à 120 pour le PDG et l'Ingénieur
  • [03]Approuvez le plan stratégique du PDG
  • [04]Ouvrez le fichier HTML livré dans un navigateur
  • [05]Créez un Ticket d'itération pour des améliorations
  • [06]Consultez le tableau de bord des Coûts
TL;DR

Votre entreprise IA vient de livrer son premier produit. Pas en discutant — en définissant un objectif, en approuvant une stratégie, et en laissant la machine tourner toute seule.