快速导航

你可以搜索、切换角色、展开步骤、查看任务操作细节、复制示例提示词、勾选管理员初始化清单,并按指标寻源流程逐步复核。

按角色进入操作路径

点击角色切换推荐流程,适合不同团队从自己的工作入口开始使用。

数据开发推荐流程

  1. 登录并选择平台项目
  2. 上传 SQL、接口文档或数据字典
  3. 让 DataAGI 解释、生成或优化 SQL
  4. 确认审批卡片中的写入动作
  5. 下载测试套件或同步方案

用户指南

每一项都可展开查看前置条件、详细步骤、预期结果和排障路径。

支持管理员邮箱密码、钉钉登录和百晓免密跳转。登录成功后进入聊天工作台,非管理员访问设置中心会被重定向。

前置条件

  • 已获得 Web 访问地址
  • 账号已创建或可通过企业身份认证
  • 浏览器允许企业登录回调

操作步骤

  1. 打开 Web 访问地址,进入登录页。
  2. 按企业配置选择管理员登录、钉钉登录或百晓入口。
  3. 管理员登录需输入邮箱和密码;钉钉登录需完成企业授权;百晓入口需携带有效 tk 参数。
  4. 登录成功后检查左侧会话栏和项目选择器是否可见。
  5. 如果要进入设置中心,确认当前账号具备管理员角色。

预期结果

用户进入聊天工作台;管理员可看到设置入口,普通用户只看到授权范围内的工作台能力。

常见问题

  • 邮箱或密码错误:检查初始化管理员配置。
  • 钉钉登录失败:检查 OAuth、回调域名、企业授权和用户邮箱。
  • 百晓登录失败:检查 token 是否过期,是否包含邮箱和姓名。

工作台左侧管理会话,右侧承载对话、工具过程、审批卡片、结果卡片和报告链接。

建议一个主题使用一个会话。重要会话需要命名,避免后续无法追溯报告和审批上下文。

平台项目是 DataAGI 的数据边界和权限边界。元数据、指标寻源、表盘点和平台作业都依赖项目上下文。

支持普通文本、通用附件、大段粘贴自动附件化、指标寻源 Excel 和结构化参数 chip。

数据入仓、平台任务创建、任务提交部署等高风险动作会展示审批卡片。所有结构化产物可在会话产物和报告中心查看。

常用任务操作

点击任务切换完整操作说明,示例提示词可以直接复制。

SQL 解释

拆解 SQL 的输入表、输出粒度、过滤条件、聚合逻辑和潜在风险。

适用场景

  • 接手陌生 SQL
  • 评审口径实现
  • 定位性能风险

操作步骤

  1. 选择项目,确保 DataAGI 能读取表字段和注释。
  2. 粘贴 SQL,说明希望输出业务含义、输入表、输出粒度和风险。
  3. 查看表和字段解释,重点核对状态条件、时间口径和金额字段。
  4. 让 DataAGI 继续补充性能风险或改写建议。
示例提示词
解释下面这段 SQL 的业务含义、输入表、输出粒度和潜在风险:
<粘贴 SQL>
SQL 逻辑拆解表字段含义聚合粒度过滤条件风险提示

指标寻源全流程

按步骤点击查看每个阶段要准备什么、看什么、复核什么。

前置准备

管理员需完成平台项目、JDBC 源、元数据、RAG 索引、语义权威源和元数据图谱健康检查。

  • 项目已添加
  • JDBC 已添加
  • 元数据已同步
  • RAG 成功
  • 语义权威源已构建

指标寻源复核动作

复核不是只看最高分候选,必须逐项确认业务域、粒度、字段角色和证据链。

确认候选表

  • 业务域匹配
  • 表粒度匹配
  • 时间字段正确
  • 状态字段覆盖口径
  • 维度字段可用

否决候选表

  • 表业务域不匹配
  • 字段缺失
  • 候选仅名称相似
  • 数据源不是权威来源

确认字段术语

  • 字段语义明确
  • 可复用到后续指标
  • 术语名称符合项目规范

口径验证 SQL

  • SQL 只读
  • 分区条件合理
  • 大表验证范围受控
  • 错误信息可追溯

管理员初始化清单

按顺序完成以下初始化动作,确保模型、数据源、知识库和监控审计都处于可用状态。

  1. 配置 AI 模型供应商和默认模型
  2. 配置 RAG Embedding 模型
  3. 添加 Dataphin 或 Simba 平台
  4. 导入平台项目
  5. 为项目配置 JDBC 数据源
  6. 同步项目元数据和表字段元数据
  7. 构建 RAG 索引与语义权威源
  8. 上传必要知识文档并补充 Snippet
  9. 邀请普通用户使用 Web 或桌面端
  10. 通过监控、通知和审计日志运营

报告中心与测试套件

报告和测试套件不是结果截图,而是后续复核、下载和执行的工作入口。

报告中心

  1. 进入报告中心,按报告类型筛选表目录盘点、字段盘点、数据画像或指标寻源。
  2. 查看报告标题、数据源、条目数和生成时间。
  3. 打开报告详情,检查数据口径、异常项和建议动作。
  4. 按需下载 Markdown 或 CSV,部分报告类型只提供 Markdown。

测试套件

  1. 打开测试套件详情,先查看概览中的总用例数、P0/P1/P2 数量和元数据缺口。
  2. 进入设计视图,按分层、表、维度、优先级和执行类型筛选。
  3. 进入执行视图,核对业务 SQL、验证 SQL、预期值和业务日期。
  4. 如需要准备数据,切换到数据构造页签补充执行前置条件。

管理员操作详解

切换管理主题,查看路径、步骤和检查项。

设置中心 -> 模型列表 / 默认模型

模型供应商与默认模型

  1. 新增供应商,填写名称、API Base URL、API Key 和默认模型。
  2. 点击测试连接,确认地址、密钥和模型可用。
  3. 刷新模型列表,删除不可用模型。
  4. 在默认模型中选择普通任务模型,在路由模型中选择 supervisor 判断模型。
API Key 权限正确Base URL 路径完整默认模型稳定路由模型响应快

桌面客户端

适合在 IDE、数据开发平台和浏览器之间快速唤起 DataAGI。

  1. 打开下载页,选择适合 macOS 或 Windows 的安装包。
  2. 安装后打开客户端,选择钉钉登录或管理员登录。
  3. 钉钉登录会打开浏览器授权,并回调本机 http://127.0.0.1:19527/callback。
  4. 进入设置,配置不与 IDE、浏览器或系统冲突的唤起快捷键。
  5. macOS 选中文本引用需要辅助功能权限,授权后点击刷新。
  6. 在桌面端新建会话、选择项目、输入任务并查看产物面板。

安全与运维

项目边界、只读验证、审批和审计是 DataAGI 私有化使用的基本约束。

项目边界

所有项目相关任务必须在明确平台项目后执行,用户只能访问被授权项目。

只读与写入

JDBC 源主要用于元数据同步、只读探查和受控 SQL 验证,写入动作必须审批。

审计与排障

排查失败时优先筛选 TASK_FAILED、SKILL_FAILED、APPROVAL_REQUIRED 和 Duration。