Iniciar sesión

Usar Agent Canvas con Agent Composer

Canvas y Composer se integran mediante el descubrimiento de capacidades, manteniendo separadas la presentación y la política de los flujos de trabajo.

  • Canvas gestiona las plantillas, partes de plantilla, patrones, estilos, tokens semánticos y renderizado final.
  • Composer gestiona Config Sets, Site Contracts, Blueprints, validación, auditoría, portabilidad y ejecución limitada a borradores.

Canvas incluye un manifiesto de presentación estático y de solo lectura. Composer puede inspeccionarlo como entrada para el descubrimiento, pero el tema no crea, actualiza ni activa la configuración de Composer.

Configuración inicial​

  1. Instale y active Canvas.
  2. Abra SmartCloud → Agent Composer → Theme & providers.
  3. Seleccione Rescan site y confirme el nombre y la versión de Canvas, sus plantillas, patrones y bloques del núcleo.
  4. Cree un Config Set inactivo a partir de un ajuste predefinido adecuado, Detected Theme Starter o una configuración manual.
  5. Revise Configuration & blueprints y verifique cada plantilla de destino, patrón permitido, bloque anidado, secuencia obligatoria, política de extractos y restricción.
  6. Aplique los cambios preparados, valide el Config Set completo y actívelo explícitamente.
  7. En un cliente compatible, cargue el contexto de diseño, el Blueprint y los patrones aprobados; valide un plan mínimo; cree un borrador propiedad del agente y revise su vista previa.

Después de actualizar Canvas​

Un escaneo del sitio descubre las capacidades actuales; no regenera ni reescribe el Config Set activo. Después de actualizar Canvas:

  1. vuelva a escanear el sitio;
  2. mantenga inmutable el conjunto activo;
  3. clónelo cuando un cambio de plantilla, patrón, bloque o manifiesto requiera actualizarlo;
  4. ajuste la copia de trabajo;
  5. valide tipos de página y vistas previas representativos;
  6. active el sucesor solo después de revisarlo.

Solución de problemas​

  • La validación del Blueprint informa de que falta un patrón o bloque: vuelva a escanear, confirme que la capacidad esté registrada y corrija después un Config Set de trabajo clonado.
  • Un cambio de tema ha duplicado el H1: combine un patrón con H1 propiedad del contenido con una plantilla sin título, o deje que la plantilla renderice el título y elimine el requisito de H1 del contenido.
  • El agente recibe un Blueprint antiguo o no encuentra una Ability recién instalada: confirme el Config Set activo y la versión desplegada de Composer, reinicie el runtime de PHP correspondiente y el servicio MCP/túnel específico del sitio; después actualice o vuelva a crear las acciones detectadas por la aplicación cliente, verifique la lista canónica de herramientas e inicie una conversación nueva.
  • La validación muestra Custom HTML blocks cannot be enabled by a Blueprint: clone o sustituya el Config Set y elimine core/html, custom_html: true, los permisos de JavaScript dentro de HTML y las opciones de extensión obsoletas relacionadas. Volver a escanear por sí solo no cambia el Config Set.
  • El cliente devuelve INVALID_ARGUMENT tras activar un contrato nuevo: actualice el esquema de acciones del cliente y envíe el valor exacto de content_language que devuelve el Blueprint en las operaciones de validación y borrador.

No corrija una discrepancia de descubrimiento editando archivos del tema Canvas para almacenar políticas de Blueprint específicas del sitio. Corrija el Config Set de Composer, salvo que al tema le falte realmente la capacidad de presentación necesaria.