Este documento técnico describe el procedimiento oficial para producir y entregar informes y paneles de analítica de datos dentro de un sistema con modo de trabajo (Work Mode) y fuera de él. Antes de renderizar cualquier artefacto, se debe invocar la función validate_artifact con el manifiesto completo y una instantánea acotada, corrigiendo allí los errores y evitando placeholders visibles. Una vez validado, fuera de Work Mode se utiliza render_artifact para alojar el manifiesto y la instantánea dentro de la aplicación MCP como vía predeterminada de entrega al lector; si falla o el usuario lo solicita, se recurre a HTML estático, localhost o archivos. En Work Mode no se deben llamar a render_artifact, render_chart ni render_table, ya que la ruta de renderizado fiable puede descartar widgets sin appContext; en su lugar se publica el artefacto validado mediante Sites, con HTML comoFallback automático.
La guía detalla además las reglas de estructura de las instantáneas: máximo 50 conjuntos de datos, 2.000 filas por conjunto, 3 MB de carga útil y 200.000 caracteres de fuente, con datasets como objetos indexados por identificador y filas como matrices de objetos simples. Los informes deben incluir un bloque markdown inicial con un encabezado # igual al título del manifiesto y al menos un bloque de visualización con datos. Los gráficos nativos deben usar encodings.x.field y encodings.y.field o encodings.y.fields, con campos opcionales de color para datos agrupados; los campos heredados xField y series se rechazan. Las tablas requieren un defaultSort declarado. Por último, cuando se necesite un enlace a Sites para un artefacto MCP validado, se debe invocar export_artifact_package e implementar ese paquete en lugar de generar HTML manual, preservando el tiempo de ejecución real del artefacto.