Lantide Data
此页已有简体中文译文，但尚待核对最新繁体中文原文的更新。

快速開始

2. 快速开始

以下以 Agent 项目分析（订单漏斗示例）示范完整流程。若你只想手动跑 SQL，见 §2.8。

2.1 启动与首次设置

打开 Lantide Data，应用程序会自动启动后端服务并进入主界面。首次启动时会自动建立一个默认工作区。

首次启动体验：

  1. AI Chat 面板自动展开（后续启动默认收合）。
  2. 欢迎 Dialog 弹出，包含产品介绍影片（目前为 placeholder），点击「Get Started」关闭。
  3. 关闭 Dialog 后，AI Chat 面板中的 WelcomePanel 引导你设置 API Key——点击「Open AI Settings」即可一键打开设置窗口。
  4. 在设置窗口新建或编辑 Profile（OpenAI / Ollama / Custom），填入 API Key 与模型后保存。完整步骤见 §12.3。
  5. （可选）完成 LLM 设置后，可填写 Agent Preferences（回复语言、风格等），写入 User Knowledge。见 §15.3.1。

[图片] 应用程序启动后的初始界面

2.2 加载数据

  1. 在侧边栏展开 Data 区块。
  2. 若尚未绑定文件夹，会看到 「No local folder — click to choose」 列：点击后会先确认，再打开文件选择器。
  3. 选择存放数据文件的文件夹（例如含 orders.csv 的目录）后，Lantide Data 会扫描支持的文件并列在 Data 之下。
  4. 若要变更文件夹，在文件夹名称列上按右键 → Change data folder。更多选项（Reveal in Finder、列表排序）见 §3.2、§4.1。

[图片] 选择文件夹后，侧边栏显示文件列表

2.3 建立项目并聚焦

  1. 在侧边栏 Projects 区块点击 ＋，输入项目名称（例如「Order Funnel」）并确认。
  2. 在项目名称上按右键 → New File，建立一份 Plan 文件。
  3. 点击项目列右侧的眼睛图标聚焦该项目——图标变绿、列背景高亮。聚焦后 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 的 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。

执行过程中你会看到：

  1. Agent 先读取 Plan，再询问偏好的分析执行模式（前台自动分析／混合模式）。模式说明见 §12.5；在 Executing 阶段同一段对话中只需选择一次（与 Quick Analysis 的后台模式分开）。
  2. Plan 工具列的 Progress 按钮出现 Todo 清单与查询步骤（有更新时显示红点）。见 §11.6。
  3. Agent 在执行每个主要 SQL 步骤前先验证语法，再正式取数；探索试错与正式取数分开，避免无意义的重试回圈。
  4. 若 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 协作，以下是最短的手动查询路径：

  1. （可选）建立工作区 — 在侧边栏 Workspace 区块点击 ＋，输入名称（1–15 字元）并确认。见 §3.1。
  2. 加载数据 — 同 §2.2。
  3. 新建 SQL 标签页 — 点击标签栏 ＋，在编辑器输入 SQL，例如：
 SELECT * FROM "orders.csv" LIMIT 10
  1. 执行 — 点击 Run 或按 Shift + Enter。
  2. 查看结果 — 结果显示在编辑器下方；可翻页（每页 20–100 笔），界面预览最多 500 笔。完整数据请用导出。

提示： 表名即文件名称，用双引号包裹。在侧边栏双击文件名称可自动插入表名。更多编辑器功能见 §5、§6。

[图片 / GIF] 在编辑器中撰写 SQL 并执行的操作过程

← 上一篇: Lantide Data 用户指南下一篇: 工作區管理 →