最佳实践

Analytics Agent 的最佳实践帮助你在数据语义配置、问答准确性优化和分析域治理方面少走弯路。

生产落地

当团队准备从 PoC 进入真实业务使用时，先阅读以下文档：

• 从 PoC 到生产：Analytics Agent 落地指南 — 生产落地所需的数据边界、语义、权限、验证、反馈和运维机制

配置阶段

在分析域上线前，参考以下文档完成配置优化：

• 分析域配置原则与常见问题 — 9 条踩坑经验、6 个 FAQ、健康检查与推荐流程
• 答案构建器最佳实践 — SQL 模板设计、

  ${dims}

  ${dims}
  和

  ${filters}

  ${filters}
  使用、输出指标配置
• 配置字段语义 — 字段别名、描述、类型、用途的正确配置方法
• 配置虚拟列 — 派生字段的创建与语义配置
• 配置知识 — 业务口径与术语解释的最佳写法
• 文件与文档问答 — 文件上传、问答命中与知识配合
• 推荐问题配置 — 设计高质量引导问题

验证阶段

配置完成后，通过以下文档验证问答效果：

• 验证问答效果 — 分步验证知识、指标、答案构建器、虚拟列和表关系
• 上线检查分析域 — 健康度扫描 + 上线前人工检查清单

排查阶段

问答结果不理想时，通过以下文档定位根因：

• 排查问答准确性问题 — 从答案到 SQL 到记录的完整排查链路
• Analytics Agent 问答准确率提升 — 语义层四种能力详解

治理阶段

分析域上线后，持续管理权限和审计：

• 治理总览 — 权限分层、域隔离与审计闭环
• 管理权限 — 账号管理、授权管理与分析域权限
• 配置行级权限 — 定义权限点与用户数据范围
• 查看审计日志 — 追踪配置变更与用户操作