Template : Guide pas-à-pas — Construire un agent IA avec Claude (20 minutes, sans code)

1) Compte Claude (accès à Claude Code / capacités d'outils) — clé API ou interface Claude Code ouverte. 2) Compte Telegram et création d'un Bot via BotFather (clé du bot). 3) Compte sur une plateforme no-code d'automatisation (Zapier, Make/Make.com ou Pipedream no-code). 4) Stockage persistante simple : Google Sheets, Airtable ou un endpoint fourni par la plateforme no-code. 5) Un fichier de configuration (JSON) contenant : nom de l'agent, tâches supportées, ton, et règles basiques de sécurité.

Résumé : 1) Outils : APIs, web search, exécution de code, stockage fichiers. 2) Mémoire : base persistante (Airtable/Google Sheets/BDD légère). 3) Boucle : planifier → exécuter → vérifier → itérer jusqu'à tâche complète. Diagramme ASCII rapide : Claude Code (Orchestrateur) → [Outils: WebSearch | CodeRunner | APIs externes] ↔ Mémoire persistante (Sheet/Airtable) → Telegram (UI / notifications). Prompt image (copier/coller dans un générateur) : "Diagram, flat style, French labels: 'Claude Code' central, arrows to 'Outils (Recherche, APIs, Exécution code)', 'Mémoire persistante (Airtable/Google Sheets)', and 'Telegram Bot', show loop symbol and step numbers 1-3, high-contrast, 1200x800".

System prompt (rôle général) : "Tu es AgentClaude, un orchestrateur autour d'un modèle Claude Code. Tu dois planifier, appeler des outils, stocker ou lire la mémoire, et boucler jusqu'à ce que la tâche soit marquée 'TERMINÉE'. Respecte les règles de sécurité et demande confirmation avant d'effectuer des actions sensibles." Prompt d'initialisation (exemple, à envoyer au début d'une tâche) : "Tâche: [OBJECTIF]. Contexte utilisateur: [CONTEXT]. Règles: 1) Priorise sources récentes; 2) Si incertain, ajoute une action de vérification; 3) Ne partage pas d'informations sensibles. But final attendu: [DELIVERABLE]." Template de décomposition (planning interne) : "Étape A: rechercher sources; Étape B: synthétiser 3 points; Étape C: rédiger livrable; Étape D: sauvegarder et notifier."

Pattern d'appel d'outil (format JSON que l'orchestrateur envoie) : {"tool":"web_search","query":"[query]","limit":15}. Exemple de prompt pour recherche : "Lis et résume ces 15 URLs (format: titre — 1 ligne) et fournis 5 citations vérifiables, puis propose 3 angles de publication et un post final de 200 mots dans le ton [TON_UTILISATEUR]." Pour exécution de code (Claude Code executor) : envoie le bloc code, demande à Claude d'exécuter, capte la sortie, en cas d'erreur demande correction automatique (retry loop). Template d'erreur : "Si l'exécution échoue, extrais l'erreur, propose 3 correctifs, applique le premier si il est non-risque et relance."

Schéma de table simple (Airtable/Google Sheets) : colonnes: id_task, user_id, task_status, context_summary, last_actions (JSON), embeddings_stamp (optionnel), created_at, updated_at. Exemple d'entrée context_summary : "Préférences: ton professionnel, audience: PME SaaS, veto: pas d'arguments légaux". Règles de conservation : 1) Garder uniquement ce qui sert aux décisions futures; 2) Masquer/hashed données sensibles; 3) Rotations/TTL pour données temporaires (ex: 30 jours). Pour rappel, Claude peut consulter et enrichir ces champs via les appels d'API/no-code.

Flux type (Zapier/Make) : Trigger (Webhook entrant) ←→ Action 1 (Envoyer payload à Claude Code via HTTP request / API module) ←→ Action 2 (Parser réponse; stocker résumé en Google Sheet / Airtable) ←→ Action 3 (Envoyer message formaté au Telegram Bot via 'SendMessage' avec token). Exemple de payload vers Claude : {"user_id":"123","task":"trouve 3 sujets IA qui trendent","context":"mes posts précédents: [link]","memory_snapshot_id":"abc"}. Exemple de message Telegram de sortie : "Sujet choisi: X. Post: [texte]. Tape /approve pour publier ou /revise pour réécrire." Configuration technique clefs : - Webhook URL générée par Zapier/Make. - Module HTTP: POST Content-Type: application/json; Authorization: Bearer [CLAUDE_API_KEY]. - Réponses: standardiser en JSON {status, actions[], final_text}. Astuce: utiliser un filtre (Zapier filter) pour lancer la boucle tant que status != 'TERMINÉE'.

Pattern de boucle (logique) : 1) Planifie sous-tâches (n items). 2) Pour chaque sous-tâche : appeler outil → analyser résultat → écrire dans mémoire → vérifier critère d'acceptation. 3) Si tous les critères OK → status = 'TERMINÉE' et envoyer notification finale. Critères d'acceptation (exemples) : 1) Synthèse couvre 5 sources majeures; 2) Post respecte ton et longueur; 3) Tests unitaires de code passent. Exemple prompt pour vérification finale : "Vérifie la complétude par rapport à la liste de critères suivante: [...]. Si un critère échoue, ajoute un plan d'actions (max 3) et exécute la première."

Tests rapides (5 minutes) : 1) Test unitaire : demander une recherche simple et vérifier que 3 sources sont listées. 2) Test de loop : lancer une tâche multi-étapes et vérifier qu'il fait 2 itérations minimum. 3) Test de mémoire : vérifier qu'une modification de préférence est lue lors d'une deuxième session. Grille d'acceptation (score 0-3 par critère): a) Autonomie (applique actions sans intervention)=3; b) Fidélité ton=3; c) Robustesse erreurs=3; d) Persistance mémoire=3. Score total >10 = prêt à production.

1) Agent recherche, prompt d'input utilisateur : "Trouve 3 études récentes sur adoption IA PME FR, synthèse 6 lignes chacune, 5 citations et un post LinkedIn (150-200 mots)." 2) System template pour style : "Adopte un ton direct, professionnel, avec humour léger. Structure: hook, 3 insights, CTA." 3) Message Telegram interactif : "AgentClaude: J'ai fini la synthèse. 1) Voir synthèse 2) Demander réécriture 3) Publier maintenant. Réponds 1/2/3."

Offre 1 (prestation): Installation + 1 semaine d'itérations (forfait). Offe 2 (SaaS-lite): templates + support mensuel. Pitch court : "Agent personnalisé pour [fonctions] => x heures économisées/semaine => ROI mesurable en mois." Inclure clause d'onboarding, SLA basique (temps de réponse, mises à jour).