如何打造儀表板：資料來源、關鍵指標、圖表與存取權限

要打造儀表板，請從它必須回答的問題與閱讀它的人開始，精準定義一小組指標，串接這些指標所需的資料，並為每個指標選擇簡單的圖表。接著決定誰可以看到哪些數字。AI 應用程式建置工具能在幾分鐘內產生精美的儀表板；真正困難、也決定大家是否信任它的部分，是把資料與定義做對。

從問題開始，而不是圖表

試圖顯示所有內容的儀表板，通常只會被打開一次。在思考圖表之前，先回答以下問題：

• 它是給誰看的？ 創辦人、業務團隊、營運人員、投資人，還是你的客戶？
• 它支援什麼決策？「我們需要再聘一位客服人員嗎？」是儀表板能回答的問題；「給我看我們的資料」則不是。
• 他們多久會看一次？ 每日營運儀表板需要即時資料與警示；每月的董事會檢視則不需要。

寫下三到五個問題。每個問題對應一到兩個指標。

精確定義每一個指標

大多數關於儀表板的爭論，其實都是關於定義的爭論。請為每個數字寫下簡短的定義：

請把這些定義貼進你的提示詞中。否則 AI 可能會挑選一個聽起來合理、但與你的業務計算方式不符的算法。

資料從哪裡來

有兩項原則適用於所有情況：

1. 金鑰留在伺服器端。 API 金鑰與資料庫密碼應放在應用程式的環境變數中，絕不能放在瀏覽器程式碼裡。
2. 決定資料的新鮮度。 每次載入頁面時都從多個 API 拉取資料，既慢又可能觸發速率限制。對多數企業儀表板而言，每小時或每晚同步一次到你自己的資料庫，並在頁面上顯示「最後更新時間」，會更簡單也更可靠。

如果你還不熟悉 API，什麼是 API與什麼是資料庫會說明基本概念。

選擇正確的圖表

• 附變化幅度的單一數字（「42k 美元，較上月增加 8%」）——KPI 卡片。這是多數儀表板中最有用的元素。
• 隨時間變化的趨勢——折線圖。只有在期數很少時才使用長條圖。
• 比較類別——依數值排序的水平長條圖。
• 整體的一部分——堆疊長條圖。圓餅圖只適合兩到三個區塊。
• 細節與例外情況——附排序、搜尋與篩選的表格。通常比任何圖表都更有用。

顏色要保持一致：「本期」用一種顏色，「比較對象」用柔和的顏色，紅色只用在需要注意的事項上。

誰能看到什麼

在打造之前就要決定存取權限：

• 內部使用，所有人看到全部——最簡單。若包含企業資料，仍需登入。
• 依角色區分——業務看業務數字，財務看利潤率，主管看自己團隊的數字。
• 面向客戶——每位客戶只能看到自己的資料。每個查詢都必須在伺服器端依客戶帳號進行篩選。以兩位不同的客戶身分登入來測試。

若營收或客戶資料放在沒有登入的公開網址上，就等於是一個等待被發現的資料外洩漏洞。

行之有效的首次提示詞

為一間十人規模的 B2B 軟體公司打造銷售儀表板。對象：創辦人與業務主管，每週一查看。總覽頁面：本月新增 MRR、總 MRR、本月新客戶數、本月流失客戶數與銷售管道金額的 KPI 卡片，各附與上月相比的變化；過去 12 個月 MRR 的折線圖；依來源分類的新交易長條圖。交易頁面：可搜尋、可排序的表格（公司、負責人、金額、階段、成交日期），並可依負責人與階段篩選。指標定義：MRR 為有效月訂閱金額的總和，年繳方案除以 12；流失客戶數計算當月訂閱結束的客戶。目前請在資料庫中使用真實感的範例資料，之後再串接 Stripe。顯示「最後更新時間」。需要登入。乾淨的側邊欄版面。

這個提示詞包含了對象、每個附定義的指標、圖表與資料計畫，並從範例資料開始，讓你在串接真實來源之前就能先對設計達成共識。

建置步驟

1. 以範例資料製作版面。 在資料是假的、修改成本低的時候，先就指標與圖表達成共識。
2. 串接一個真實來源。 逐一與來源系統手動核對每個數字。如果 MRR 與 Stripe 顯示的不同，先查明原因再繼續。
3. 逐一加入其他來源，每加入一個就核對一次。
4. 排程更新或載入時查詢，並加上「最後更新」標籤。
5. 篩選器——先做日期範圍，再加入一兩個大家常問的篩選條件。
6. 登入與角色。
7. 空白與錯誤狀態——當來源無法連線或篩選結果為空時，頁面該顯示什麼。
8. 與目標對象分享，然後一個月後移除沒人看的內容。

讓它變快

速度慢的儀表板會被較少查看。把計算成本高的總計預先算好（例如用每日彙總資料表，而不是掃描每筆訂單），對大型表格分頁，並先載入標題卡片，讓頁面在圖表完成前就已經有用。若某個數字需要很長時間計算，請顯示它上次計算的時間，而不是每次造訪都重新計算。

常見錯誤

• 圖表太多。 如果每樣東西都被強調，就等於什麼都沒有被強調。
• 指標未定義。 兩個人看同一份儀表板，應該得出相同的結論。
• 從不與來源核對數字。 一個錯誤的數字，就會讓人們不再信任整個儀表板。
• 每次載入頁面都查詢每個 API。 慢、脆弱，有時還很昂貴。
• 缺乏日期脈絡。 一定要顯示期間與比較基準。
• 前端放入祕密金鑰。 瀏覽器中可見的 API 金鑰，任何打開頁面的人都能複製。

何時 BI 工具是更好的選擇

如果你的資料已存放在資料庫或資料倉儲中，而主要使用者是想探索、切分資料並自行製作圖表的分析師，那麼 Looker Studio、Power BI、Metabase 等 BI 工具，會比自行打造更能滿足他們的需求。許多 SaaS 工具也內建不錯的報表；在重新打造之前，請先檢查這些內建功能。當儀表板是給客戶或非分析人員使用、需要 BI 工具無法表達的邏輯或權限、以符合你業務特性的方式結合多個來源，或必須放在你已經在營運的產品之中時，自行打造會更合適。

如果工作重點不在於檢視數字，而在於修改紀錄，你需要的是管理後台或內部工具，請參閱如何打造內部工具。如果你的數字目前放在試算表中，如何把試算表變成應用程式會是很好的下一篇閱讀。

使用 Mythex 打造

在 Mythex 中，你描述儀表板，代理人會在即時預覽中建置頁面與圖表，先使用真實感的範例資料；當數字需要保存時，再轉移到專用的 Postgres 資料庫。文件中的儀表板使用案例提供了入門提示詞。如果你的資料存放在 Google 試算表等工具中，你可以透過連接器連接帳號，並要求代理人讀取資料並據此建立儀表板。

應用程式本身沒有內建的資料倉儲連接器：對於 BigQuery、Snowflake、Stripe 等服務，應用程式會使用你儲存為專案祕密的金鑰呼叫其 API。檢視儀表板的人員登入與角色，是你所打造應用程式的一部分。若要從提示詞開始，可以瀏覽儀表板範本，例如指標儀表板。

常見問題