chart-visualization

ユーザーの入力内容に基づいて、データを図表に可視化してください。

手順

1. ユーザーのデータと要件を分析し、最適な図表タイプを選択する
2. 仕様に準拠した JSON リクエストボディを構築する
3. curl ツールを使用して API を呼び出し、図表画像を生成する
4. 返された画像 URL を Markdown 画像形式で出力する

図表選択ガイド

ユーザーのデータ特性と要件に基づいて、最適な図表タイプを選択してください：

• 時系列データ：line（トレンド）または area（累積トレンド）を使用；異なる量纲の場合は dual-axes を使用
• 比較類：bar（横方向カテゴリ比較）または column（縦方向カテゴリ比較）を使用；度数分布には histogram を使用
• 占有率類：pie（比率構成）または treemap（階層占有率）を使用
• 関係性とフロー：scatter（相関性）、sankey（フロー）、または venn（集合の重なり）を使用
• 階層と木構造：organization-chart または mind-map を使用
• 専用タイプ：
  • radar：多次元比較
  • funnel：プロセスステージの変換
  • liquid：パーセンテージ/進捗
  • word-cloud：テキスト単語の頻度
  • boxplot / violin：統計分布
  • network-graph：複雑なノード関係
  • fishbone-diagram：因果分析
  • flow-diagram：フローチャート
  • spreadsheet：構造化データテーブルまたはピボットテーブル

API インターフェース

POST https://antv-studio.alipay.com/api/gpt-vis

リクエストボディは JSON で、type と source: "chart-visualization-skills" フィールドを必ず含める必要があります。

例：

curl -X POST https://antv-studio.alipay.com/api/gpt-vis \
  -H "Content-Type: application/json" \
  -d '{"type":"line","source":"chart-visualization-skills","data":[{"time":"2025-01","value":100}],"title":"示例图表"}'

戻り値の例：

{"success":true,"resultObj":"https://..."}

resultObj 内の URL を Markdown 画像形式で出力してください：![図表](URL)

サポートされている図表タイプ

カテゴリ	図表タイプ
比較類	棒グラフ(bar)、柱状図(column)、ウォーターフォール図(waterfall)、双軸図(dual-axes)
トレンド類	面積図(area)、折れ線グラフ(line)、散布図(scatter)
分布類	箱ひげ図(boxplot)、ヒストグラム(histogram)、バイオリンプロット(violin)、漏斗図(funnel)
占有率類	円グラフ(pie)、水波図(liquid)、ワードクラウド(word-cloud)
階層類	組織図(organization-chart)、マインドマップ(mind-map)、ツリーマップ(treemap)、サンキー図(sankey)
関係類	ネットワークグラフ(network-graph)、ベン図(venn)
フロー類	フローチャート(flow-diagram)、フィッシュボーン図(fishbone-diagram)
多次元類	レーダーチャート(radar)
テーブル類	テーブル/ピボットテーブル(spreadsheet)

通用オプションパラメータ

パラメータ	タイプ	デフォルト	説明
theme	string	"default"	テーマ："default" / "academy" / "dark"
width	number	600	図表の幅
height	number	400	図表の高さ
title	string	""	図表のタイトル
style.texture	string	"default"	テクスチャ："default" / "rough"（手描きスタイル）

座標軸を持つ図表は、axisXTitle、axisYTitle もサポートしています。

各図表の data フォーマット

• area / line: {time: string, value: number, group?: string}[]、オプション stack: boolean
• bar: {category: string, value: number, group?: string}[]、オプション group / stack (デフォルト stack: true)
• column: {category: string, value: number, group?: string}[]、オプション group (デフォルト true) / stack
• scatter: {x: number, y: number, group?: string}[]
• pie: {category: string, value: number}[]、オプション innerRadius: number (0-1)
• radar: {name: string, value: number, group?: string}[]
• funnel: {category: string, value: number}[]
• waterfall: {category: string, value?: number, isTotal?: boolean, isIntermediateTotal?: boolean}[]
• dual-axes: categories: string[], series: {type: "column"|"line", data: number[], axisYTitle?: string}[]
• histogram: number[]、オプション binNumber: number
• boxplot / violin: {category: string, value: number, group?: string}[]
• liquid: percent: number (0-1)、オプション shape: "circle"|"rect"|"pin"|"triangle"
• word-cloud: {text: string, value: number}[]
• sankey: {source: string, target: string, value: number}[]、オプション nodeAlign
• treemap: {name: string, value: number, children?: ...}[] (最深 3 層)
• venn: {sets: string[], value: number, label?: string}[]
• network-graph / flow-diagram: {nodes: {name: string}[], edges: {source: string, target: string, name?: string}[]}
• fishbone-diagram / mind-map: {name: string, children?: ...} (最深 3 層)
• organization-chart: {name: string, description?: string, children?: ...} (最深 3 層)、オプション orient: "horizontal"|"vertical"
• spreadsheet: Record<string, string | number>[]、オプション rows / columns / values（ピボットテーブルフィールド）