DataMagic: Authoring Data Videos through Declarative Multi-Agent Orchestration
Organizations: The Hong Kong University of Science and Technology (Guangzhou), Guangzhou, China
Abstract
Data videos communicate data insights through dynamic charts, voice narration, and synchronized animations, and have become a widely adopted form of data storytelling. However, producing them requires expertise in data analysis, narrative design, and video editing. Static visualization tools lack narrative and animation capabilities; authoring tools rely on pre-prepared charts rather than raw data; and pixel-level models generate videos end-to-end but cannot guarantee data accuracy or provenance. End-to-end automatic generation faces two core challenges: how to uniformly represent charts, narration, and animations together with their temporal relationships, and how to efficiently search a vast design space for narrative-coherent compositions. We present DataMagic, which authors data videos from raw tabular data through declarative multi-agent orchestration. First, the declarative specification DVSpec unifies charts, narration, and animations with data-bound references and declarative synchronization, ensuring data provenance and automatic audio-visual alignment. Second, a "Generate-then-Orchestrate" multi-agent strategy generates candidate scenes in parallel and then optimizes narrative coherence through global orchestration. DVSpec provides a shared state for three complementary interaction modes, bridging full automation with fine-grained human control. Evaluations on 109 real-world samples show that even the most advanced LLM (e.g., GPT-5) achieves only 2.13/5 with execution success rates between 48.62% and 86.24%; DataMagic improves quality to 3.89 (+83%) with success rates above 95%, with the most significant gains in animation and narrative dimensions. A user study shows that, compared to a conversational LLM workflow, DataMagic improves creation efficiency (79.7% reduction in task time) and reduces perceived cognitive load. Project page: https://github.com/HKUSTDial/DataMagic.
Figures & tables
| Evaluation Dimensions | |||||||
| Method | Exec Rate (%) | Intent | Insight | Narrative | Animation | Aesthetic | Avg. Score |
| Direct Generation Methods | |||||||
| DeepSeek-V3.2 | 48.62% | 1.95 | 1.98 | 1.88 | 1.65 | 2.09 | 1.91 |
| Gemini-2.5-Pro | 66.06% | 2.38 | 2.25 | 2.07 | 1.94 | 2.44 | 2.22 |
| GPT-5 | 86.24% | 2.36 | 2.22 | 2.05 | 1.84 | 2.17 | 2.13 |
| Claude-Sonnet-4 | 84.40% | 2.28 | 2.01 | 1.98 | 1.91 | 2.71 | 2.18 |
| Variant | Intent | Insight | Narrative | Animation | Aesthetic | Avg. Score |
| DataMagic (Full) | 3.79 | 3.37 | 3.84 | 4.39 | 4.05 | 3.89 |
| w/o Story Planner | 3.42 | 3.16 | 3.26 | 3.79 | 3.58 | 3.44 |
| w/o Orchestration | 3.32 | 3.21 | 3.42 | 3.95 | 3.79 | 3.54 |
Appendix figures & tables12 assets
Supplementary material from the paper’s appendix.
Appendix
| Source | Datasets | Samples | Small (<100 rows) | Med. (100-1K) | Large (>1K rows) |
| T2R-bench | 36 | 85 | 4 | 14 | 18 |
| DAComp-DA | 24 | 24 | 2 | 7 | 15 |
| Total | 60 | 109 | 6 | 21 | 33 |
| Dimension | Min | Median | Max | Mean |
| Rows | 23 | 1,436 | 150,000 | 17,065.58 |
| Columns | 3 | 16 | 555 | 32.42 |
| Numeric columns | 1 | 8 | 552 | 24.25 |
| Categorical columns | 0 | 7 | 57 | 8.17 |
| Query Type | Count | Percentage | Typical Patterns |
| Trend analysis | 12 | 11.0% | Time-series changes; Periodic patterns |
| Comparative analysis | 15 | 13.8% | Cross-category comparison; Ranking analysis |
| Distribution analysis | 18 | 16.5% | Value distribution; Proportion |
| Correlation analysis | 33 | 30.2% | Variable relationships; Correlation |
| Comprehensive analysis | 31 | 28.4% | Multi-dimensional analysis |
| Total | 109 | 100.0% | – |
| Domains | Sub-domains |
| Technology and Engineering | Electronics and Automation Manufacturing; Academic Research; Energy Production and Power Systems; Automotive Industry |
| Environmental Management | Environmental Protection; Agriculture and Forestry; Resource Management |
| Transportation Logistics | Communication and Digital Infrastructure; Transportation Networks and Logistics Management |
| Social Policy Administration | Education Policy and Public Education; Government Administration and Public Sector Services; Labor and Employment Administration; Healthcare Systems and Public Health; Demographics and Social Development |
| Commercial Services and Markets | Retail Trade and E-commerce Platforms; Tourism and Hospitality Services; Digital Entertainment and Gaming; Food and Beverage Services; Real Estate and Housing Market; Business Management and Supply Chain |
| Financial Economics | Economic Development and International Trade; Banking and Financial Services |
| Dimension | Pearson | MAE | MSE |
| Overall | 0.91 | 0.38 | 0.23 |
| Intent | 0.78 | 0.57 | 0.49 |
| Insight | 0.76 | 0.51 | 0.47 |
| Narrative | 0.83 | 0.60 | 0.59 |
| Animation | 0.90 | 0.47 | 0.48 |
| Aesthetic | 0.77 | 0.73 | 0.84 |