AIが作成は得意でも図の解釈に苦戦するという問題を解決するため、Mermaid図をAIが読み取りやすい形式に変換する「Graph2agent」が登場しました。
想像してみてください。複雑な機械の組み立て説明書を見ながらAIに「この通りに組み立てて」とお願いしたところ、AIは図をぼんやりと眺めるだけで、見当違いの部品を持ってくる場面を。実はAIは、図の中に込められた複雑なプロセスの流れを読み取ることに大きな苦労をしていました。
最近のソフトウェア開発現場では、開発スピードを合わせるために「Mermaid」が頻繁に使われています(出典 2, 出典 4)。MermaidはMarkdownに似た文法で、文字を入力するだけでフローチャートやダイアグラムを自動で描いてくれるツールです。人間にとっては一目で理解できる非常に優れた視覚資料です(出典 10)。しかし、AIにとってこのダイアグラムはまるで暗号のようなものでした。この難題を解決するために登場したツール、「Graph2agent」を紹介します。
なぜこれが重要なのか?
日常生活でAI秘書に業務を任せる際、私たちはしばしばフローチャートや計画表を見せます。もしAIがこの図を正しく理解できなければ、結局人間がコードで改めて説明し直さなければならず、二度手間が発生します。これではAIを使う意味が薄れてしまいます。
Graph2agentは、AIがダイアグラムを見て自ら正確なコードを実装できるようにサポートします。これは単なる利便性を超え、AIモデルの「理解力」を高めることで、より複雑なソフトウェア設計業務を安心して任せられる環境を作ります。結果としてAIはより賢く行動し、人間は説明の手間を減らせる生産的な協業が可能になります。
わかりやすく解説
MermaidはJavaScriptベースのツールで、開発者がMarkdownのように文字を入力するだけでフローチャートや関係図を描いてくれます(出典 3, 出典 5)。これを「テキストで作る地図」だと考えてみてください。
人は地図を見れば「ああ、ここからあそこへ行くんだな」とすぐに理解できます。しかし、AIモデルはこの地図を「画像情報」として受け取ってしまうため、道に迷ってしまいます。Graph2agentは、この地図をAIが最も理解しやすい「決定論的なテキスト」形式に変換します。まるで地図が見えないAIの横に、地図を丁寧に文章で描写した「詳細説明書」を添えてあげるようなものです(出典 9)。
簡単に言えば、複雑な図を解釈するために頭を悩ませる必要をなくし、AIがすぐに読み取って実行できる「答え」を渡しているのです。
現状
従来の多くのAIモデルは、すでにMermaidダイアグラムを作成する能力は備えていました(出典 10)。ユーザーが「プロセスを描いて」と言えば、上手に描いてくれました。しかし、いざそのダイアグラムをもとに実際のソフトウェアを実装してほしいと頼むと、頻繁に失敗していました(出典 16)。
現在、Graph2agentはこの「読み取り能力」の不足を補っています。テストの結果、ダイアグラム全体でエラーが約50.41%も減少しました(出典 9)。特にシーケンス図(システムの流れを示すツール)のような場合には、エラー率が80%まで減少するという驚くべき成果を出しました(出典 1)。
入力されるテキスト量はわずかに増えますが(平均8%増)、AIが悩み続ける必要のある「推論トークン(モデルが思考する過程で消費されるコスト)」は逆に半分近くまで減り、全体的な作業効率が飛躍的に向上しました(出典 1)。
今後の展望
今後は、AIとより精巧なシステム設計を共有する際、別途の翻訳プロセスは不要になるでしょう。現在はGraph2agentを経由する必要がありますが、将来的にはAIモデル自体がダイアグラムをまるでテキストのように完璧に読み取れる方向に発展していくと思われます。
私たちはAIに対して「この文書を読んでプログラムを組んで」と言う代わりに、「このMermaidダイアグラムを読んでプログラムを組んで」と、より簡潔にコミュニケーションできるようになるはずです。AIが私たちの意図をより明確に把握できるようになれば、創造的で複雑なソフトウェア開発のハードルはさらに低くなるでしょう。
MindTickleBytesのAI記者視点
AIが絵を「見る」ことと「理解する」ことの間には、大きな隔たりがあります。Graph2agentは、その隔たりを埋める非常に賢明な迂回路を提示しています。本質的なモデル改善ではなく、データを加工するという単純な発想の転換が、AIの思考効率を二倍にも高めたという点は、AI技術の活用において大きな示唆を与えています。
参考資料
- ShowHN:Graph2agent;Mermaiddiagrams,explainedforagents, https://modernorange.io/item/49250014
- Online FlowChart &DiagramsEditor -MermaidLive Editor, https://mermaid.live/
-
Редактор ДиаграммMermaid- Создание Блок-Схем… ToolAct, https://toolact.com/ru/mermaid - GitHub -mermaid-js/mermaid: Generation ofdiagramslike flowcharts…, https://github.com/mermaid-js/mermaid
-
Mermaid Diagrammingand charting tool, https://mermaid.ai/open-source/ - MermaidJS: Finally There’s A Great UML &Diagram… - YouTube, https://www.youtube.com/watch?v=JiQmpA474BY
- Free OnlineMermaidEditor — Flowcharts, SequenceDiagrams& More, https://www.mermaideditor.io/
- Interactive Diagrams - Create Interactive Diagrams, https://www.bing.com/aclick?ld=e84s-zeINP6DBIUoUl5bAoeTVUCUx_gZpSNa6zgKTEi0tCj_fAaxHy_AefCBauNw4xXeWgvr_7nCGR148RGC9aUcmGaXIhEd5VUG6F0bJd5rg_Q3Tx5J0ELX3o3QzhsMdSFMlvjPoVwExtYlBMq9gJO6ZQTNagNT8kGb6OWr14PdZug28JzPRT4qQDy3zVg4Fnw6PKbjkJuD7ip2FKA–uBw5uOig&u=aHR0cHMlM2ElMmYlMmZnb2pzLm5ldCUyZmxhdGVzdCUyZiUzZmElM2RtMSUyNm1zY2xraWQlM2RmMWQ3OTM3YmEyMzIxYWYzNmUxZmY5MDE2ODIzZmUzMg&rlid=f1d7937ba2321af36e1ff9016823fe32
- GitHub - graph2agent/graph2agent: Deterministic Mermaid-to …, https://github.com/graph2agent/graph2agent
- Show HN: Graph2agent; Mermaid diagrams, explained for agents …, https://paragguptaclasses.blogspot.com/2026/08/show-hn-graph2agent-mermaid-diagrams.html
-
Nuxt HN Show HN: Graph2agent; Mermaid diagrams, explained …, https://hn.nuxt.dev/item/49250014 - New Show Hacker News story: Show HN: Graph2agent; Mermaid …, https://hacknux.blogspot.com/2026/08/new-show-hn-graph2agent-mermaid-diagrams_0348850872.html
- Show HN: Graph2agent; Mermaid diagrams, explained for agents …, https://newsliveanytime.blogspot.com/2026/08/show-hn-graph2agent-mermaid-diagrams.html
- mermaid-diagrams - Agent Skill - Agent Skills, https://agentskills.me/skill/mermaid-diagrams
- 4 News Express: Show HN: Graph2agent; Mermaid diagrams …, https://4newsexpress.blogspot.com/2026/08/show-hn-graph2agent-mermaid-diagrams.html
- Interesting, how does the automatic system diagram generation …, https://news.ycombinator.com/item?id=46939610
- 図を画像に変換する
- 図をAIが読み取れるテキストに変換する
- AIが直接図を描けるようにする
- 図を描く能力が不足していた
- 図を読み取ってコードに実装する能力が不足していた
- 図を理解する速度が遅すぎた
- シーケンス図のエラーが80%減少
- 推論トークン使用量が約50%減少
- エラー率が100%除去された