Docs de agentes

Diseño · crear, editar, verificar y exportar

← Todos los módulos · Conecta tu agente →

Diseño · crear, editar, verificar y exportar

Cómo está hecho un diseño

Antes de diseñar

1. resolve_brand({ workspaceId, brand }) → paleta, tipografías, logo, plantillas de la marca.

2. get_active_styles({ workspaceId }): si hay estilos bloqueados, son obligatorios.

3. Si la marca tiene plantillas aprobadas, parte de ellas (create_from_plantilla, skill musa-marcas) en vez de empezar en blanco.

Flujos

Pieza nueva (post, story, banner)

1. create_template({ name, workspaceId, engine: "html", width, height }) → templateId y el Frame 1.

2. set_frame_layers({ templateId, frameId, background, fontImports, layers }): el diseño completo como lista plana de capas (id, name, kind, x, y, width, height, contenido, estilo). Es la herramienta recomendada.

3. Si el texto es largo, mide antes con text_metrics para elegir tamaño y que no se desborde.

4. Íconos: search_icons → insert_icon. Fotos: search_stock_image o upload_image; ilustraciones: search_illustrations → get_illustration_svg.

5. Verifica (ver abajo) y entrega el enlace con editor_open({ templateId, surface: "design" }).

Carrusel o deck en una llamada

Editar un diseño existente

1. get_template (o get_html_frames para ver HTML/CSS de los frames) y get_template_structure para el árbol de capas.

2. Cambios puntuales: edit_text_content (textos), set_paint (colores), transform_element (posición y tamaño), update_element (HTML/CSS de una capa), update_frame_content (por selector CSS).

3. Agregar o quitar: add_element, add_primitive, remove_element, duplicate_frame, create_html_frame.

4. Rehacer un frame entero: set_frame_layers de nuevo sobre el mismo frame.

5. Cambios guiados por instrucción en lenguaje natural: enhance_template({ templateId, instruction }).

Llevar a otros formatos

1. adapt_all_formats({ templateId, formats: ["story", "post", "banner", ...] }) o adapt_format para uno.

2. compare_adaptations para revisar lado a lado; corrige lo que se rompa.

Desde una imagen o un prompt

Replicar una referencia con HTML (importar o pegar)

Verificar antes de entregar (obligatorio)

1. lint_design({ templateId, frameId }) → puntaje y problemas (textos desbordados, capas fuera del frame, contraste).

2. validate_brand({ templateId, brandId }) si es de una marca; check_contrast o check_accessibility si hay dudas de lectura.

3. render_frame_png({ templateId, frameId }) para ver el resultado: abre la captureUrl una vez y lee la URL del PNG. Si no puedes abrir páginas, usa render_html_template.

4. Corrige solo lo que falle. update_thumbnail si cambió mucho.

Exportar y compartir

Herramientas

Archivo y frames

Capas

Estilo

Contenido visual

IA de diseño

Formatos

Verificación

Exportar y abrir

Guías de procedimiento

Reglas

Ejemplos

Réplicas 100 % editables (de una referencia a capas nativas)

Para reproducir una referencia dejando cada parte como capa nativa (no PNG pegado). En la web están en Props › «Réplica editable» (con un frame elegido) y en la sección de cada capa; por MCP:

Vectorizar en Musa (cuándo usar cada modo)

Una sola herramienta, tres motores: layer_vectorize({ templateId, frameId, layerId, engine, options }). El resultado entra como un grupo «Vector · <capa>» con capas vectoriales nativas, recoloreables una por una; la respuesta dice cuántas capas se crearon y qué quedó raster. En la web: Props de la imagen › «Vectorizar».

Antes de vectorizar, mira la referencia y decide:

1. Ilustración de colores planos (tazas, formas planas, afiches): engine: "trace" (gratis, motor propio de Musa, una capa por color con curvas).

2. Lettering o texto dibujado: si quieres cada letra como capa recoloreable, engine: "color_layers" (las letras salen como los huecos claros del manchón: «letra 1», «letra 2»…); si solo necesitas la forma completa, "trace".

3. Halftone o trama de puntos: no vectorices si puedes evitarlo; usa layer_apply_halftone( (paramétrico). Si no, "trace" funciona pero los puntos pequeños salen algo cuadrados.

4. Textura crayón o grano: "color_layers" conserva el borde moteado pero aplana el relleno a un color. Para textura de relleno usa layer_apply_texture(. No prometas textura de relleno desde una vectorización.

5. Fotos: ningún modo. Son raster por naturaleza; para aislar algo usa layer_split_subject(.

6. Degradados: "trace" con más colores los aproxima como bandas. Si el degradado es protagonista, prueba "ai" o reconstrúyelo como degradado nativo.

7. Íconos y logos simples: "trace".

8. Ilustración densa donde el trace se ve duro: engine: "ai" (Quiver con la llave del usuario). Sin confirmCost: true solo devuelve el costo estimado y no cobra: muéstralo y pide confirmación antes de pagar.

Opciones: trace → colormode (color|bw), colorPrecision, filterSpeckle, cornerThreshold, pathPrecision, hierarchical (stacked|cutout), removeBackground. color_layers → colors (hex picados) o maxColors, tolerance, simplify, lettersAsLayers, keepBackground. ai → model (arrow-1.1 | arrow-2 | arrow-2-telos).

Reglas: nunca pagues el modo "ai" sin mostrar el costo y que la persona confirme; después de vectorizar, reporta qué quedó vector y qué siguió raster (design_layer_report().

Código → diseño 100 % editable (con tiempo: portada, animación y presentación)

Documentación de agentes de Musaworks · actualizado 2026-11-20