2. 快速開始
以下以 Agent 專案分析（訂單漏斗範例）示範完整流程。若你只想手動跑 SQL，見 §2.8。
2.1 啟動與首次設定
開啟 Lantide Data，應用程式會自動啟動後端服務並進入主畫面。首次啟動時會自動建立一個預設工作區。
首次啟動體驗：
- 啟動完成後，先閱讀並確認 Terms of Service 與 Privacy Policy；兩項都勾選後才能進入 App。Trust Center 說明 Lantide 的資料保護方式。Terms 或 Privacy 更新時，會在下次啟動要求重新確認相應文件。
- 日後可從 Help → Legal Information 查看目前接受的 Terms／Privacy 版本、生效日期與最後確認時間，或重新開啟 Terms、Privacy Policy 與 Trust Center。
- AI Chat 面板自動展開（後續啟動預設收合）。
- Setup Mode Choice 對話框：選擇 Built-in Agent (BYOK)（在 Lantide 內聊天）或 External Agent (MCP)（在 Cursor 等外部 client 聊天，Lantide 作本機 MCP host）。
- Built-in 路徑：先彈出 Agent Preferences（可 Save / Skip）→ Welcome 引導 Open AI Settings 設定 Profile（OpenAI / Ollama / Custom）→ 完成後可開始聊天。Preferences 詳見 §15.3.1。
- External 路徑：自動開啟 Agent Integration → 暴露 MCP；使用 Codex 時可從 App 以 GUI 確認後直接配對並合併本機設定，其他 client 可用 Copy connection kit（複製成功即視為 first-run 完成）→ 可一鍵 Copy onboarding prompt 貼到外部 Agent。Welcome 不引導 Open AI Settings。詳見 §13 與 Learn External Agent Integration。
- 既有使用者升級時會自動遷移（曾看過舊版影片、已配 LLM、或已連上 MCP 者通常不會再看到 Setup Mode Choice）。
[圖片] 應用程式啟動後的初始畫面
2.2 載入資料
- 在側邊欄展開 Data 區塊。
- 若尚未綁定初始資料夾，會看到 「No local folder — click to choose」 列：點擊後會先確認，再開啟檔案選擇器。
- 選擇存放資料檔案的資料夾（例如含
orders.csv的目錄）後，Lantide Data 會掃描支援的檔案並列在 Data 之下。初始資料夾每個工作區一個，所有方案皆可用。 - 若要變更初始資料夾，在資料夾名稱列上按右鍵 → Change data folder。更多選項（Reveal in Finder、列表排序）見 §3.2、§4.1。
- 若還需要掛第二個（或更多）本機資料根、而不想搬檔，可在 Connections 新增 Additional folder；見 §4.5。
[圖片] 選擇資料夾後，側邊欄顯示檔案列表
2.3 建立專案並聚焦
- 在側邊欄 Projects 區塊點擊 ＋，輸入專案名稱（例如「Order Funnel」）並確認。
- 在專案名稱上按右鍵 → New File，建立一份 Plan 檔案。
- 點擊專案列右側的眼睛圖示聚焦該專案——圖示變綠、列背景高亮。聚焦後 Agent 自動進入專案分析模式，不再詢問快速分析或專案分析。詳見 §11.1、§11.4。
[圖片] 新建專案並聚焦
2.4 用自然語言提出分析需求
在 AI 面板輸入分析需求，例如：
分析訂單漏斗，找出流失最多的階段。分母以「建立訂單」為起點，時間範圍為最近 90 天。
Agent 可能先確認目標、分母或時間範圍（透過對話中的互動問題區塊）。AI 狀態指示器會顯示 Project Focused 或 Planning。Agent 會先探索 orders.csv 等表的 schema，再開始撰寫 Plan——不會憑空假設欄位名稱。
若你只是問「這張表有哪些欄位？」這類簡單問題，Agent 會直接回答，無需完整 Plan 流程。
2.5 審閱 Plan：口徑與 checkpoint
Agent 草擬 Plan 後會請你審閱。一份合格的漏斗分析 Plan 通常包含：
- 分析目標 — 例如找出漏斗中流失最多的階段。
- Stage 定義 — 每個漏斗階段的篩選條件（如「已付款」「已出貨」）。
- 分母（denominator） — 各階段轉化率的分母如何定義（以上一階段通過數還是固定起點）。
- 粒度（grain） — 以訂單為單位還是以用戶為單位。
- 驗證 checkpoint — 例如確認最大流失階段、檢查 NULL 或異常狀態。
草擬後的短問答（Plan Grilling）： 若口徑、分母、資料邊界或假設仍未寫死，Agent 會在對話中用 ask_user 一次只問一題，並附上建議答案與簡短理由；你確認後，Agent 以增量方式把共識寫進 Plan，再請你到 Plan 分頁做最終審閱。可透過看表結構或探數查到的事實，Agent 應自己查完再問決策，而不是拿事實來考你。分析方向若發生大轉折（換指標、換群體），Agent 也可能先短問答、再改計畫。若你在提示中已把口徑說清楚，Agent 可略過問答、直接進入審閱提示。細節與其他 ask_user 場景見 §12.7。
若某段口徑需要修改，在 Plan 的 Visual 模式下選取文字 → 點擊批註圖示 → 寫下修改意見。Agent 只會修改被批註的部分，不會整份重寫。批註操作見 §11.7。
在此階段不要按 Approve & Execute——先確認 Plan 中的口徑與步驟符合你的預期。Agent 不會假裝你已批准而擅自開始取數。
2.6 執行分析
審閱滿意後，在 Plan 工具列點擊 Approve & Execute。系統會將 Plan 切換為 Executing 狀態，並自動向 Agent 發送開始執行的指令——你不需要手動在 AI 面板輸入「開始執行」。這個按鈕核准的是目前 Plan 的生命週期與執行範圍；若使用外部 Agent，它不會提高 connection 的 Observe / Execute / Admin access mode。
執行過程中你會看到：
- Agent 先讀取 Plan，再詢問偏好的分析執行模式（前台自動分析／混合模式）。模式說明見 §12.5；在 Executing 階段同一段對話中只需選擇一次（與 Quick Analysis 的後台模式分開）。
- Plan 工具列的 Progress 按鈕出現 Todo 清單與查詢步驟（有更新時顯示紅點）。見 §11.6。
- Agent 在執行每個主要 SQL 步驟前先驗證語法，再正式取數；探索試錯與正式取數分開，避免無意義的重試迴圈。
- 若 SQL 過於複雜（例如含 3 個以上 CTE），Agent 會被要求拆成較小的步驟，方便你逐步審查。
若你使用雙螢幕或寬螢幕，可將某個 持久 SQL 分頁或 Plan 開到 Compare view 對照，主視窗繼續編輯或執行下一個步驟。見 §11.10。
若執行中斷（用戶停止、網路問題、關閉應用等），Plan 會顯示 Continue 按鈕，點擊即可從中斷處恢復，無需從頭開始。
2.7 閱讀 Report 與下一步
分析完成後，Agent 會在專案中新增一份 Report。一份合格的漏斗 Report 應包含：
- 各 stage 的定義與 分母說明
- 最大流失階段及具體 counts / rates（例如「審核通過 → 交物流：1,623 單，占 1.63%」）
- 限制與注意事項（limitations） — 資料無法回答的問題、口徑假設、相關性與因果的區別等
你可以在 Report 上繼續加批註請 Agent 修訂措辭，或使用工具列 HTML Report 匯出獨立 HTML 檔在瀏覽器分享。見 §10。
驗收 Report 時，可將同專案的 Plan 開入 Compare view，與主視窗的 Report 並列對照口徑與數字（Compare view 內為唯讀）。見 §11.10。
若分析自然延伸出下一個問題（例如按商品類別深挖），你可以在同一專案建立新的 Plan 繼續迭代。
[圖片] 完成的 Plan 與 Report 並列檢視
2.8 附錄：手動 SQL 快速查詢
若你不需要 Agent 協作，以下是最短的手動查詢路徑：
- （可選）建立工作區 — 在側邊欄 Workspace 區塊點擊 ＋，輸入名稱（1–15 字元）並確認。見 §3.1。
- 載入資料 — 同 §2.2。
- 新增 SQL 分頁 — 點擊分頁列 ＋，在編輯器輸入 SQL，例如：
SELECT * FROM "orders.csv" LIMIT 10
- 執行 — 點擊 Run 或按
Shift + Enter。 - 查看結果 — 結果顯示在編輯器下方；可翻頁（每頁 20–100 筆），畫面預覽最多 500 筆。完整資料請用匯出。
[圖片 / GIF] 在編輯器中撰寫 SQL 並執行的操作過程