Agent Canvas mit Agent Composer verwenden
Canvas und Composer integrieren über Fähigkeits-Erkennung, behalten aber Trennung von Präsentation und Workflow-Richtlinie.
- Canvas verantwortet Templates, Template Parts, Patterns, Styles, semantische Tokens und finales Rendering.
- Composer verantwortet Config Sets, Site Contracts, Blueprints, Validierung, Audit, Portabilität und Draft-only-Ausführung.
Canvas liefert ein statisches, schreibgeschütztes Präsentationsmanifest. Composer kann es als Discovery-Eingabe nutzen; das Theme erstellt, aktualisiert oder aktiviert aber keine Composer-Konfiguration.
Ersteinrichtung
- Canvas installieren und aktivieren.
- Öffnen Sie SmartCloud → Agent Composer → Theme & Provider.
- Wählen Sie Seite neu scannen und bestätigen Sie Canvas-Name, Version, Templates, Patterns und Core-Blöcke.
- Erstellen Sie einen inaktiven Config Set aus einem geeigneten Preset, einem Detected Theme Starter oder manuell.
- Prüfen Sie Konfiguration & Blueprints und bestätigen Sie jedes Ziel-Template, erlaubte Pattern, verschachtelte Blöcke, Pflichtsequenz, Exzerpt-Richtlinie und Restriktionen.
- Wende gestufte Änderungen an, validieren Sie den vollständigen Config Set und aktivieren Sie ihn explizit.
- Laden Sie in einem kompatiblen Client Design-Kontext, Blueprint und freigegebene Patterns; validieren Sie einen minimalen Plan, erstellen Sie einen agenteneigenen Entwurf und prüfen Sie die Vorschau.
Nach einem Canvas-Update
Ein Sitescan ermittelt aktuelle Fähigkeiten, ohne den aktiven Config Set neu zu generieren oder umzuschreiben. Nach Upgrade von Canvas:
- Site erneut scannen;
- aktiven Satz unverändert lassen;
- klonen, wenn Template-, Pattern-, Block- oder Manifeständerung eine Aktualisierung benötigt;
- Arbeitskopie anpassen;
- Vertretbare Seitenarten und Vorschauen validieren;
- den Nachfolger erst nach Prüfung aktivieren.
Fehlerbehebung
- Blueprint-Validierung meldet fehlendes Pattern oder fehlenden Block: neu scannen, Existenz der Fähigkeit bestätigen, danach klonierten Arbeits-Config-Set korrigieren.
- Theme-Wechsel erzeugte doppeltes H1: verwenden Sie ein Content-Pattern ohne H1 kombiniert mit einem H1-freien Template oder lassen Sie das Template den Titel rendern und entfernen Sie Pflicht-H1 aus dem Content.
- Agent erhält altes Blueprint oder neue Fähigkeit fehlt: aktiven Config Set und deployte Composer-Version bestätigen, PHP-Runtime und site-spezifischen MCP/Tunnel-Service neu starten, anschließend Client-Aktionstabelle neu laden und kanonische Toolliste prüfen, dann neue Konversation starten.
- Validierung meldet
Custom HTML blocks cannot be enabled by a Blueprint: klone oder ersetze den Config Set, entfernen Siecore/html,custom_html: true, JavaScript-in-HTML-Zulassungen und zugehörige veraltete Erweiterungseinstellungen. Ein erneutes Scannen ändert den Config Set nicht. - Client liefert
INVALID_ARGUMENTnach Aktivierung neuer Vertragsregel: Client Action Schema aktualisieren und die exaktecontent_languageaus dem Blueprint mit Validierung und Entwurfsoperationen senden.
Löse eine Discovery-Differenz nicht per Theme-Änderung zur Speicherung sitespezifischer Blueprint-Richtlinie. Korrigiere den Composer Config Set, außer die erforderliche Präsentationsfähigkeit fehlt tatsächlich im Theme.
