Se connecter

Utiliser Agent Canvas avec Agent Composer

Canvas et Composer s'intègrent par la découverte des capacités tout en gardant la présentation et la politique de workflow séparées.

  • Canvas gère les modèles, les parties de modèle, les patterns, les styles, les jetons sémantiques et le rendu final.
  • Composer gère les Config Sets, les Site Contracts, les Blueprints, la validation, l'audit, la portabilité et l'exécution de brouillons uniquement.

Canvas fournit un manifeste de présentation statique en lecture seule. Composer peut l'inspecter comme entrée de découverte, mais le thème ne crée, ne met pas à jour et n'active aucune configuration Composer.

Configuration initiale​

  1. Installez et activez Canvas.
  2. Ouvrez SmartCloud → Agent Composer → Thème et fournisseurs.
  3. Choisissez Réanalyser le site et confirmez le nom de Canvas, la version, les modèles, les patterns et les blocs de base.
  4. Créez un Config Set inactif à partir d'un préréglage adapté, de Detected Theme Starter ou d'une configuration manuelle.
  5. Examinez Configuration et blueprints et vérifiez chaque modèle cible, pattern autorisé, bloc imbriqué, séquence requise, politique d'extrait et contrainte.
  6. Appliquez les changements mis en attente, validez le Config Set complet et activez-le explicitement.
  7. Dans un client compatible, chargez le contexte de design, le Blueprint et les patterns approuvés, validez un plan minimal, créez un brouillon détenu par l'agent, puis inspectez son aperçu.

Après une mise à jour de Canvas​

Une analyse du site détecte les capacités actuelles ; elle ne régénère ni ne réécrit le Config Set actif. Après la mise à niveau de Canvas :

  1. réanalysez le site ;
  2. conservez l'immuabilité du Config Set actif ;
  3. clonez-le lorsqu'une modification de modèle, de pattern, de bloc ou de manifeste nécessite une mise à jour ;
  4. ajustez la copie de travail ;
  5. validez des types de pages et des aperçus représentatifs ;
  6. n'activez le successeur qu'après revue.

Dépannage​

  • La validation du Blueprint signale un pattern ou un bloc manquant : réanalysez, confirmez que la capacité est bien enregistrée, puis corrigez un Config Set de travail cloné.
  • Une modification du thème a provoqué un H1 dupliqué : associez un pattern H1 détenu par le contenu à un modèle sans titre, ou laissez le modèle afficher le titre et supprimez l'exigence de H1 dans le contenu.
  • L'agent reçoit un ancien Blueprint ou ne dispose pas d'une capacité récemment installée : confirmez le Config Set actif et la version déployée de Composer, redémarrez le runtime PHP concerné et le service MCP/tunnel spécifique au site, puis actualisez ou recréez les actions analysées de l'application cliente, vérifiez la liste canonique des outils et démarrez une nouvelle conversation.
  • La validation signale Custom HTML blocks cannot be enabled by a Blueprint : clonez ou remplacez le Config Set et supprimez core/html, custom_html: true, les autorisations JavaScript dans HTML et les paramètres d'extension obsolètes associés. La simple réanalyse ne modifie pas le Config Set.
  • Le client renvoie INVALID_ARGUMENT après l'activation d'un nouveau contrat : actualisez le schéma d'actions du client et envoyez exactement la valeur content_language renvoyée par le Blueprint pour les opérations de validation et de brouillon.

Ne corrigez pas un décalage de découverte en modifiant les fichiers du thème Canvas pour y stocker une politique de Blueprint spécifique au site. Corrigez le Config Set Composer, sauf si la capacité de présentation requise est réellement absente du thème.