析言GBI使用指南

简介

析言GBI是基于阿里云千问大语言模型在数据分析领域专门增强的原生数据助理，通过自然语言交互实现NL2SQL、数据问答、分析、洞察等多维度的大模型智能分析应用，适用于业务变化较快、数据分析时效性强的一线业务场景。

操作指引

析言GBI产品入口：前往应用广场页面，搜索析言GBI并点击卡片即可进入析言GBI控制台。析言GBI为每个客户提供免费试用额度。超出免费额度后，如需继续使用，请按需购买产品规格。

当试用或购买某个产品规格后，您需要先完成初始化。您可以按照如下步骤进行初始化配置，将您的数据库连接到析言GBI。

1. 关联并授权析言访问指定数据库；

2. 配置您授权析言访问的数据表schema信息；

3. 配置您在使用析言进行问答时可能涉及的业务知识。

数据库连接

配置数据库

首次使用时，您需要在数据源管理中进行数据库授权，关联您的数据库。析言GBI支持关联公网可访问的MySQL或PostgreSQL协议数据库，VPC可访问的AnalyticDB PostgreSQL版数据库，以及仅能通过API连接的虚拟数据库（MySQL或PostgreSQL）。

1. 在左侧导航栏点击数据表管理。

2. 选择一个数据库，点击授权联接。

   重要

   每个业务空间下仅能关联一种类型的数据库，如需更改，可取消授权并重新连接新的数据库。

3. 在访问公网数据库中连接MySQL或PostgreSQL数据库时，请确保您填写的数据库实例IP/域名为公网可访问的地址，这里的数据库IP/域名可以是您在阿里云购买的云上数据库地址，或本地机房的数据库服务地址。如果遇到连接失败的情况，请检查数据库访问是否有IP白名单限制。如有限制，请在白名单中添加析言GBI的IP地址：39.107.142.91。

   在数据库授权弹窗中，依次填写IP/域名、端口号、数据库名称、数据库用户名、数据库密码，单击授权联接完成连接。

4. 在访问VPC数据库中授权连接AnalyticDB PostgreSQL前，需要先“授权ADB实例”。若未进行ADB实例授权，则在授权ADB实例弹窗中，点击授权联接按钮会先进行ADB实例授权。执行此操作会自动创建一个服务关联角色。该权限将允许阿里云百炼析言GBI访问您的云原生数据仓库 AnalyticDB PostgreSQL版资源，使用该权限可查询数据库、表、列等信息，执行SQL查询数据相关功能。

   授权ADB实例后，需要填写表单，授权析言GBI连接您的ADB数据库。

   • Region：必填，可选范围有北京、上海、杭州、深圳等，默认北京。

   • 数据库实例：必填，Region范围内的数据库实例，仅支持选择一个实例。

   • 用户名和密码：必填，访问已选ADB数据库实例的用户名和密码。

5. 连接数据库成功后，选择授权析言GBI访问的数据表信息，以完成数据表同步。当数据库中存在大量数据表时，此数据同步过程可能需要更多时间。数据表同步成功后，您可在页面列表中进行管理。

   在数据表管理页面，单击右上角关联数据表，开始选择需要授权同步的数据表。

   在弹出的关联数据表面板中，按需勾选数据表（支持全选），下方会显示已选数据表标签，确认无误后单击确认关联完成同步。

配置数据表schema信息

数据表同步成功后，为使析言GBI能正常接入，需要您在数据表管理维护该表的schema信息，同时确保和源数据库的结构一致。数据表管理位于左侧导航栏数据源管理下。

在数据表管理列表中，定位需要维护的数据表，单击对应操作列的编辑进入schema配置页面。

• 基础信息：包含数据表描述、数据表的主键、外键信息。

  进入数据表详情页后，顶部的基础信息卡片展示当前表的数据表描述、主键和外键关系配置。

  在基础信息编辑弹窗中，可修改数据表描述、设置数据表主键，并在数据表外键区域逐条添加本表列与其他表列的映射关系。

• 数据表描述：当前表记录的数据内容与颗粒度等，例如：变电站安装记录表，用于xxxx；

• 数据表主键：用于保证数据完整性，即确保在该表格中每一行记录都是独一无二的，用来快速查找和引用特定记录；

• 数据表外键：在不同表之间建立联系，用于跟其他表格进行关联；例如： 表a.列名=表b.列名1；表之间若有外键，必须配置，否则表格之间join可能有误。

• 列信息：

  在数据表字段信息列表中，可查看每列的列名、列中文名、列描述、数据类型、是否枚举等属性，并通过操作列的编辑按钮进行调整。

• 列描述：用简单凝练的语言描述该列的具体含义；

• 列中文名：选填，在列描述信息缺失的情况下，根据列中文名理解数据表信息；

• 枚举值：对于枚举类型的列至关重要，需要罗列该列中存储的全部值，在有值含义映射的情况下，需为值设置其对应的映射值。可通过从数据库中同步枚举值来便捷操作，析言将从数据库中拉取去重后的至多99个枚举值。有一些关键的要求和最佳实践需要注意，以确保其有效性和可靠性：

  1. 值的唯一性：每个枚举值应该在预定义的范围内是唯一的，不能有重复的值。

  2. 值的描述性：枚举值应尽可能具有描述性，这样能够直观地表示其含义。例如，用 'active' 和 'inactive' 比 1 和 0 更具可读性。

  3. 合理的值数量：枚举值的数量不宜过多，过多可能会增加代码复杂度和维护成本。一般建议控制在10个以内。

  单击列操作列的编辑，在列编辑弹窗中填写列中文名和列描述；如该列为枚举类型，将是否枚举设为是后，可单击同步数据库中列枚举候选值自动从数据库拉取去重后的候选值。

  在枚举值列表中，为每个枚举值填写对应的映射值（如 1→自营、2→加盟），便于模型理解业务含义。

企业知识管理

为了帮助析言GBI更好地理解您在数据分析中的目标表述，企业知识管理模块提供了三种工具，可以满足您的业务场景需要。

知识名词解释

对于业务场景的专有名词，可以在知识名词解释中进行配置。例如：在使用自然语言提问时，通常会出现“咨询转化率”一词，但关联数据表中并没有“咨询转化率”列，其值是经“有咨询且下单成功客户”列汇总后，与“有咨询客户”列汇总的结果相除获得。对于这种情况，您可以在该词条描述下定义该指标的计算口径。

在企业知识名词解释页面，单击右上角新增知识录入业务专有名词的解释和计算口径，后续可在列表中维护。

同义词解释

使用自然语言提问时，经常涉及某个词汇的多种说法，这些说法被称为同义词。在同义词解释中，您可以维护同义词列表。例如：数据表实际存储值为“北京市”，在使用自然语言提问时，可以使用同义词“首都”来替代。

在同义词解释页面，单击右上角新增词语录入词语及其同义词列表，并在关联数据表中绑定具体的数据表列。

为提升同义词识别准确度，建议在配置同义词时，将同义词关联到数据表具体的某一列上。

在编辑同义词弹窗中，输入词语及其同义词标签，并在关联数据表下拉框中选择具体的数据表列，单击确认生效。

业务逻辑解释

当您使用自然语言提问时，企业特有的业务逻辑通常需要配置在业务逻辑解释中。例如，当查询包含“本月”时，您可以将业务逻辑解释配置为“指从本月1日至今天的数据汇总”。

在业务逻辑解释页面，单击右上角新增业务逻辑录入业务规则，模型在解析自然语言时会参考已配置的业务逻辑。

业务逻辑分为全局和智能两种。全局型业务逻辑对所有用户的问题生效。智能业务逻辑由模型根据用户问题内容选择性生效。

优化案例管理

在尝试调整问题问法及数据管理后，模型依然无法输出预期结果的情况下，您可以通过添加优化案例来指导模型进行学习。在标准版MIX中，析言开放案例自运营管理能力，可供用户在不对模型本身进行定制的情况下，依然可以通过案例管理来指导模型进行一类问题的自学习。

通配符管理

通配符是一种可以被一个或多个字符进行模糊替代的高级词汇，例如某通配符A为【品牌】，其枚举值为“小米”、“华为”、"vivo"、“oppo”；某通配符B为【职级】，其枚举值为“初级工程师”、“中级工程师”、“高级工程师”。在实际的问题问法中可能包含某个通配符的某个枚举值，此类问法在后续进行案例管理时，无需为每个枚举值逐一添加案例，模型将根据通配符的设置内容进行智能理解。

在优化案例管理页面的通配符管理标签页中，单击右上角新增通配符录入通配符名称及对应的枚举值列表。

案例库管理

添加案例可以有效提升模型解决一类问题的准确率。一条案例包含一个问题的问法描述与其预期正确执行的完整SQL内容。在设置案例时，若该案例的问法描述中包含某通配符的某个枚举值信息，请确保已在通配符管理中完成设置。

切换至案例库管理标签页，单击右上角新增案例录入问题的问法描述与对应的预期SQL内容。

模型输出干预

如果多次调整问题问法和数据管理后，模型依然回答错误，您可以设置特定回复来干预模型输出。

在模型输出干预页面，单击右上角新增干预条件录入需要干预的问法描述及其强制返回的SQL内容。

首页问答

1. 在析言GBI首页的数据库卡片中，确认已关联数据库后，点击开启对话，再在输入框内输入您需要查询的问题并提交。

   问题提交后，析言GBI将按照五个步骤解析您的问题并生成相应答案。

   系统会依次展示问题理解、表选择、SQL生成、执行结果和可视化结果五个步骤，并在最终步骤输出可视化的查询结果。

2. 针对生成的答案您可以执行以下操作。

   答案结果页面中，位置①为图表类型切换图标（柱状图/折线图/饼图）、位置②为重新生成按钮、位置③为已生成答案的切换控件、位置④为下载结果按钮、位置⑤为本次问答的 Request ID。

   操作	说明
   图表切换	点击图表切换图标（位置①）切换图表类型（柱状图、折线图、饼图）。 切换图表类型仅改变图表的展示形式，不会重新生成结果。
   重新生成答案	点击重新生成（位置②）时，已经生成的答案将被保留，最多可重新生成5次。 您可以在卡片底部点击<或>（位置③）切换已经生成的答案，默认停留在最近一次生成的答案页面。 重新生成（余2），表示还可再重新生成2次。 ”2/3”表示已经生成了3次答案，目前停留在第2次生成的答案页面。
   结果导出	点击下载结果（位置④），把本次问题及生成的答案下载至本地。 如果您生成了多次答案，仅下载当前停留页面显示的答案。 下载的文件以Request ID命名（位置⑤），格式为csv。例如，20839b75-xxx.csv。

问题自查

支持的数据库类型

数据库连接问题自查

效果不达预期问题自查

日期相关查询自查

其他错误自查

常见问题及解答

• 析言GBI的正式版和试用版本有什么区别？

  答：试用版功能与正式版相同。试用版目前有开放少量免费额度。

• 每个业务空间下仅能关联一种类型的数据库，是只能关联一个数据库？还是在MySQL/PostgreSQL下可以链接多个数据库？

  答：一个业务空间下只能连接一个数据库，目前不支持跨库查询，如果实际业务中需要多数据库查询，可以通过业务空间进行隔离，不同的业务空间使用不同的数据库。

• 如果只能链接一个数据库情况下，对于实际业务中需要对多数据库查询，有什么好的建议？

  答：目前不支持跨库查询，建议根据业务场景进行业务空间隔离，不同业务空间使用不同的数据库。

• 析言支持私有化吗？

  答：析言支持数据库在本地，服务在公共云的混合部署。目前不支持私有化部署。

• 析言产品的并发是指的什么？ 同时有2个用户访问，第二个用户需要排队吗？

  答：并发指的是系统同时处理的请求数，如果只购买1个并发，那么系统在同一时刻只能处理一个请求，在当前请求处理完之前，第二个请求会被拒绝。

• 自然语言对应生成SQL是通过列描述还是列中文名？

  答：优先列描述。

• 多个业务空间可以复用同一个GBI吗？

  答：不同业务空间数据是隔离的，无法复用。

• 析言支持定义默认查询条件吗？

  答：目前还不支持。