DIV集成AI对话分析

1.1 功能概述

Wyn 支持将 AI 对话式分析嵌入到 Web 应用程序的任意 DIV 容器中，为最终用户提供自然语言问答、洞察分析和推荐问题能力。

2. 操作步骤

2.1 安装集成包

当前仓库示例使用的集成包是 @grapecity-software/wyn-integration。

npm install @grapecity-software/wyn-integration

2.2 集成

将 Wyn AI Chat Analysis 添加到 DIV 容器 wyn-root 中。

import { WynIntegration } from "@grapecity-software/wyn-integration";

let aiChatAnalysis = null;

const createAIChatAnalysis = async (baseUrl, token, dataset) => {
  if (aiChatAnalysis) {
    aiChatAnalysis.destroy();
    clearContainer();
  }

  aiChatAnalysis = await WynIntegration.createAIChatAnalysis({
    baseUrl,
    token,
    theme: "default",
    lng: "zh",
    dataset,
    datasetSelection: "manual",
    insights: true,
    advancedAnalysis: true,
    suggestedQuestions: true,
    analysisMode: "standard",
    showDataPanel: true,
    setupGuide: {
      title: "AI Chat 尚未完成配置",
      subtitle: "请先完成初始化设置",
      description: "完成 AI Chat Analysis 相关配置后，即可开始提问和分析。",
      actionText: "前往配置",
      actionUrl: "/admin"
    },
    onError: (error) => {
      console.error("AI Chat Analysis 初始化失败：", error);
    }
  }, "#wyn-root");
};

const clearContainer = () => {
  const container = document.querySelector("#wyn-root");
  if (container) {
    container.innerHTML = "";
  }
};

2.3 当前仓库 Demo 说明

说明如下：

通过 createAIChatAnalysis(config, selector) 创建实例。
创建成功后返回 AIChatAnalysis 实例，当前实例支持调用 destroy() 释放资源。

3. 属性说明

3.1 AI Chat Analysis 支持属性

属性名	值类型	是否必填	说明
`lng`	`string`	否	AI 对话式分析界面语言，例如 `zh`、`en`。
`theme`	`string`	否	AI 对话式分析界面主题。
`dataset`	`string`	否	默认使用的数据集或者数据模型 ID。进入页面后优先基于该数据集进行分析。
`availableDatasets`	`string[]`	否	AI 对话式分析可使用的数据集或者数据模型 ID 列表，用于限制用户可选的数据范围。
`datasetSelection`	`'manual' \| 'auto'`	否	数据集/数据模型选择模式。`manual` 表示用户手动选择，`auto` 表示允许 AI 智能匹配自动选择。
`insights`	`boolean`	否	是否启用"数据洞察"相关能力和界面。
`advancedAnalysis`	`boolean`	否	是否启用"高级分析"能力。
`suggestedQuestions`	`boolean`	否	回答完成后"是否展示推荐问题"。
`analysisMode`	`'standard' \| 'advanced'`	否	新会话默认分析模式，可以选择"高级分析"和"常规分析"。
`showDataPanel`	`boolean`	否	是否显示数据面板。
`setupGuide`	`AIChatAnalysisSetupGuideOptions`	否	AI 对话式分析尚未完成配置时显示的引导信息。
`container`	`Element`	否	备用挂载容器。实际集成时仍优先建议通过 `createAIChatAnalysis(config, selector)` 的第二个参数传入容器选择器。
第二个参数 `selector`	`string`	是	挂载目标容器选择器，例如 `#wyn-root`。
`onError`	`(error: unknown) => void`	否	创建或初始化失败时触发的错误回调。

注意：
若要以下四个参数起效：datasetSelection、insights、advancedAnalysis、suggestedQuestions，用户需要后台管理站点中开启这四个对应选项：

3.2 `setupGuide` 子属性

属性名	值类型	是否必填	说明
`setupGuide.title`	`string`	否	引导区域主标题。
`setupGuide.subtitle`	`string`	否	引导区域副标题。
`setupGuide.description`	`string`	否	未配置状态下的说明文本。
`setupGuide.actionText`	`string`	否	操作按钮文案。
`setupGuide.actionUrl`	`string`	否	操作按钮点击后打开的链接地址。

4. 参数获取说明

baseUrl 指 Wyn 服务器地址。
token 指访问 Wyn 服务器的令牌。令牌对应的用户需要具备访问 AI 对话式分析相关页面的权限。
dataset 和 availableDatasets 中使用的数据集或数据模型 ID，通常可从 Wyn 工作空间中的数据集/数据模型列表中获取。
selector 指前端页面中用于承载 AI 对话式分析的 DOM 容器选择器，例如 #wyn-root。

DIV集成AI对话分析

1.1 功能概述

2. 操作步骤

2.1 安装集成包

2.2 集成

2.3 当前仓库 Demo 说明

3. 属性说明

3.1 AI Chat Analysis 支持属性

3.2 setupGuide 子属性

4. 参数获取说明

3.2 `setupGuide` 子属性