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

  1. Canvas installieren und aktivieren.
  2. Öffnen Sie SmartCloud → Agent Composer → Theme & Provider.
  3. Wählen Sie Seite neu scannen und bestätigen Sie Canvas-Name, Version, Templates, Patterns und Core-Blöcke.
  4. Erstellen Sie einen inaktiven Config Set aus einem geeigneten Preset, einem Detected Theme Starter oder manuell.
  5. Prüfen Sie Konfiguration & Blueprints und bestätigen Sie jedes Ziel-Template, erlaubte Pattern, verschachtelte Blöcke, Pflichtsequenz, Exzerpt-Richtlinie und Restriktionen.
  6. Wende gestufte Änderungen an, validieren Sie den vollständigen Config Set und aktivieren Sie ihn explizit.
  7. 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:

  1. Site erneut scannen;
  2. aktiven Satz unverändert lassen;
  3. klonen, wenn Template-, Pattern-, Block- oder Manifeständerung eine Aktualisierung benötigt;
  4. Arbeitskopie anpassen;
  5. Vertretbare Seitenarten und Vorschauen validieren;
  6. 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 Sie core/html, custom_html: true, JavaScript-in-HTML-Zulassungen und zugehörige veraltete Erweiterungseinstellungen. Ein erneutes Scannen ändert den Config Set nicht.
  • Client liefert INVALID_ARGUMENT nach Aktivierung neuer Vertragsregel: Client Action Schema aktualisieren und die exakte content_language aus 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.