agent-ia-produit

Agent IA produit (Lovable × API Anthropic × MCP Rapido)

Étape 0 — Références (obligatoire)

Charger ${CLAUDE_PLUGIN_ROOT}/reference/directives-outils.md et ${CLAUDE_PLUGIN_ROOT}/reference/architecture-lovable.md (mode B en entier). KB : ton-et-accroches.md (voix de l'agent), produits-services.md et propositions-valeur.md (ce que l'agent sait), processus-internes.md (limites, seuils).

Workflow

1. Définir le RÔLE de l'agent — un agent = un métier :
   • réservation restaurant → MCP foodeatup (reservation_availability, create_reservation, list_dishes pour répondre sur la carte) ;
   • SAV / questions clients → lecture seule sur les serveurs concernés ;
   • qualification commerciale → MCP rapidocrm (create_contact, ajouter_prospect_pipeline, create_rdv). N'exposer à l'agent QUE les serveurs de son rôle (principe du moindre privilège).
2. Écrire le SYSTEM PROMPT de l'agent — dérivé des personas du plugin concerné et de la KB : ton et vocabulaire (ton-et-accroches.md), offres et prix (produits-services.md), limites (processus-internes.md : ce que l'agent ne promet pas, quand il passe la main à un humain). Y encoder les niveaux d'autonomie : LECTURE libre ; toute ÉCRITURE (réservation, prospect, RDV) = récapitulatif + confirmation de l'utilisateur FINAL avant l'appel. Faire valider ce prompt par l'utilisateur — c'est le contrat de l'agent.
3. Valider l'architecture en PLAN MODE — get_workspace (crédits) puis create_project (UI de chat minimale) et send_message avec plan_mode: true : discuter l'architecture SANS coder — edge function /chat (historique complet renvoyé à chaque tour, streaming éventuel), secrets (clé API Anthropic en variable serveur), mcp_servers limités au rôle, parsing par TYPE de bloc. Ne passer au code qu'après accord.
4. Construire — send_message (sans plan mode) pour implémenter :
   • UI de chat (historique, indicateur de frappe, erreurs propres) ;
   • edge function appelant POST /v1/messages (header anthropic-beta: mcp-client-2025-04-04, mcp_servers = URLs publiques des MCP du rôle, system = le prompt validé) ;
   • RÈGLES NON NÉGOCIABLES (architecture-lovable.md) : blocs parsés par TYPE (mcp_tool_use / mcp_tool_result / text), jamais par position ; clé API jamais côté client ; jamais de données personnelles en dur.
5. Tests guidés — dérouler avec l'utilisateur sur la preview :
   • le cas nominal du rôle (ex. réserver une table → l'agent vérifie la disponibilité PUIS demande confirmation PUIS crée) ;
   • un cas de refus (demande hors rôle → l'agent décline et redirige) ;
   • un cas d'erreur (MCP indisponible → message propre, pas de crash).
6. Déployer — deploy_project (confirmation niveau 2 : l'agent devient public et agit sur les vrais systèmes). Transmettre l'URL + rappeler la surveillance (get_project_analytics, et les objets créés visibles dans les serveurs Rapido).

Garde-fous

• L'agent embarqué HÉRITE des niveaux d'autonomie de la marketplace : lecture libre, écriture = confirmation de l'utilisateur final, jamais d'action destructrice exposée (pas de delete_* dans son rôle).
• Un agent qui écrit dans les systèmes réels se déploie APRÈS les tests guidés, jamais avant.
• Pas de données personnelles en dur dans le code, le prompt ou les exemples ; le system prompt ne contient pas de secrets.

Kit connecteur MCP (source canonique, v2)

Le branchement MCP (edge function, secrets, scope, écritures confirmées) suit désormais le kit reference/kit-connecteur-mcp/ — ne pas réimplémenter le pattern localement. Pour câbler un MCP sur l'agent embarqué, déléguer à connecteur-mcp-lovable (prompts étagés P1-P5) et passer le gate reference/gate-securite.md avant livraison. Rappels non négociables : clés du client uniquement, appels serveur, scope injecté serveur, écritures confirmées dans l'UI.