diff --git a/.gitignore b/.gitignore index 650fc40..25e4524 100644 --- a/.gitignore +++ b/.gitignore @@ -2,4 +2,5 @@ node_modules/ docs/.vitepress/dist/ docs/.vitepress/cache/ .DS_Store -_source/ \ No newline at end of file +_source/ +/*.zip \ No newline at end of file diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index e541d04..e979ae0 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -56,7 +56,7 @@ export default defineConfig({ ] }, { - text: '第三章 企业智能体开发实战', + text: '第三章 智能报价场景实战', collapsed: false, items: [ { text: '3.1 智能报价场景说明', link: '/guide/scenario' }, @@ -67,6 +67,19 @@ export default defineConfig({ { text: '3.6 会话流智能体', link: '/guide/chatflow-agent' }, { text: '附录 1-2 智能体测试结果', link: '/guide/appendix' } ] + }, + { + text: '第四章 数据分析场景实战', + collapsed: false, + items: [ + { text: '4.1 数据分析场景说明', link: '/guide/data-scenario' }, + { text: '4.2 工作区环境准备', link: '/guide/data-workspace' }, + { text: '4.3 项目搭建及资料分析', link: '/guide/data-project' }, + { text: '4.4 数据分析技能开发', link: '/guide/data-skill' }, + { text: '4.5 数据分析智能体开发', link: '/guide/data-agent' }, + { text: '4.6 EIOSpace 运行智能体', link: '/guide/data-eiospace' }, + { text: '附录:异常问题处理示例', link: '/guide/data-appendix' } + ] } ] }, diff --git a/docs/guide/agent-dev.md b/docs/guide/agent-dev.md index 4b3a656..029a233 100644 --- a/docs/guide/agent-dev.md +++ b/docs/guide/agent-dev.md @@ -4,13 +4,13 @@ title: 3.3 项目搭建及方案生成 # 3.3 项目搭建及方案生成 -## Step 1:进入客户端首页 +### Step 1:进入客户端首页 进入 IndepthAI 客户端,进入首页,选择"**通用**"。 ![客户端首页选择"通用"](/media/image23.webp) -## Step 2:选择项目目录并设定权限 +### Step 2:选择项目目录并设定权限 **Step 2-1**:点击【选择项目】→【选择目录作为项目】,选择 3.2 创建的工作区对应的文件夹"汽车零部件智能报价_xxxx"。 @@ -22,7 +22,7 @@ title: 3.3 项目搭建及方案生成 ![权限设定选择"完全访问权限"](/media/image26.webp) -## Step 3:输入需求并发送 +### Step 3:输入需求并发送 在下方对话框中输入需求(复制下方灰色背景文本框的文字,填入对话框),然后点击**发送**按钮,进入会话页面,AI 开始基于需求进行智能体生成,并等待工作完成(预计 10~15 分钟)。 @@ -40,7 +40,7 @@ title: 3.3 项目搭建及方案生成 ![发送后等待任务](/media/image28.webp) -## Step 4:检查生成的方案 +### Step 4:检查生成的方案 约 10 分钟后智能体生成的方案完成,产出物"**智能报价设计方案.md**",检查方案是否与设想的有出入。 diff --git a/docs/guide/appendix.md b/docs/guide/appendix.md index e75ff59..2b23247 100644 --- a/docs/guide/appendix.md +++ b/docs/guide/appendix.md @@ -1,5 +1,8 @@ --- title: 附录 1-2 智能体测试结果 +next: + text: '4.1 数据分析场景说明' + link: /guide/data-scenario --- # 附录 diff --git a/docs/guide/data-agent.md b/docs/guide/data-agent.md new file mode 100644 index 0000000..60e8927 --- /dev/null +++ b/docs/guide/data-agent.md @@ -0,0 +1,100 @@ +--- +title: 4.5 数据分析智能体开发 +prev: + text: '4.4 数据分析技能开发' + link: /guide/data-skill +next: + text: '4.6 EIOSpace 运行智能体' + link: /guide/data-eiospace +--- + +# 4.5 数据分析智能体开发 + +### Step 1:选择推理智能体助手 + +继续之前会话,在对话框选择输入 `/推理`,选择"**推理智能体助手**"。 + +![输入 /推理 选择推理智能体助手](/media/image114.webp) + +### Step 2:创建智能体指令 + +如下图,输入创建阀体销售数据分析智能体的开发指令(复制下方灰色背景文本框的文字,填入对话框,注意替换的内容)。 + +![输入智能体开发指令](/media/image115.webp) + +```text +按方案进入 Agent 层开发,注意绑定技能:valve-sales-analysis-skill-20261112-dongsk +``` + +::: warning 注意 +上方 `valve-sales-analysis-skill-20261112-dongsk` 需替换为 **4.4 生成的技能名称**。 +::: + +**输出结果:** + +![智能体生成输出结果](/media/image116.webp) + +### Step 3:进入开发配置界面 + +点击上图 agent.ira 的"**打开**"按钮,进入自主推理智能体开发配置界面。 + +![点击打开进入配置界面](/media/image117.webp) + +打开自主推理智能体开发配置界面,通过上述画面可以对提示词、对话开场白、开场白预设问题等进行优化,以及知识库与知识库配置等: + +- **推理配置**:提供模型选择及输出格式校验; +- **Skills**:可以引入不同技能,对技能进行调整。 + +![自主推理智能体开发配置界面](/media/image118.webp) + +### Step 4:进入试运行 + +点击"**试运行**",进入试运行预览画面。 + +![点击试运行](/media/image119.webp) + +### Step 5:试运行 - Dashboard + +点击"**帮我生成一份 9 月各销售大区的销售数据对比看板**"。 + +![点击开场白预设问题](/media/image120.webp) + +运行结果: + +![试运行运行结果](/media/image121.webp) + +打开交互式看板链接查看 Dashboard: + +![交互式 Dashboard 看板](/media/image122.webp) + +### Step 6:试运行 - 推荐问题追问 + +如下图,选择一个问题进行追问,复制①处的问题到输入框后,点击**发送**按钮。 + +![选择推荐问题追问](/media/image123.webp) + +查看结果: + +![追问结果](/media/image124.webp) + +### Step 7:智能体发布 + +1、点击**发布**按钮。 + +![点击发布按钮](/media/image125.webp) + +2、确认绑定 Skill 无误。 + +![确认绑定 Skill](/media/image126.webp) + +3、确认发布形式及类型后,点击【确认发布】即可。 + +![确认发布](/media/image127.webp) + +::: warning 注意 +发布形式选择 **EIOSpace**;发布类型选择 **自用 Agent**。 +::: + +4、发布后确认。 + +![发布后确认](/media/image128.webp) diff --git a/docs/guide/data-appendix.md b/docs/guide/data-appendix.md new file mode 100644 index 0000000..3bdba74 --- /dev/null +++ b/docs/guide/data-appendix.md @@ -0,0 +1,26 @@ +--- +title: 附录:异常问题处理示例 +prev: + text: '4.6 EIOSpace 运行智能体' + link: /guide/data-eiospace +--- + +# 附录:异常问题处理示例 + +在 **4.4 数据分析技能开发** Step 5(Skill 调试结果查看)中,打开链接看到如下图画面无任何信息展示,这个时候是有异常了,那么接下来处理这个异常。 + +![可视化为空白的异常画面](/media/image137.webp) + +### Step 1:在当前会话框做下面操作 + +1. 输入 `/Skill`,选择 "**Skill 工程助手**"; +2. 输入类似下图提示词,直接告诉 Skill 工程助手生成的内容异常,需要修正; +3. 点击【发送】开始进行修复。 + +![输入修复提示词](/media/image138.webp) + +### Step 2:执行结果 + +下图输出执行结果信息可以看到问题已被修复,可以打开新的链接查看是否正常。 + +![修复执行结果](/media/image139.webp) diff --git a/docs/guide/data-eiospace.md b/docs/guide/data-eiospace.md new file mode 100644 index 0000000..8195de3 --- /dev/null +++ b/docs/guide/data-eiospace.md @@ -0,0 +1,53 @@ +--- +title: 4.6 EIOSpace 运行智能体 +prev: + text: '4.5 数据分析智能体开发' + link: /guide/data-agent +next: + text: '附录:异常问题处理示例' + link: /guide/data-appendix +--- + +# 4.6 EIOSpace 运行智能体 + +EIOSpace 地址:[https://eiospace.digiwincloud.com.cn](https://eiospace.digiwincloud.com.cn/) + +### Step 1:登录 EIOSpace + +打开浏览器输入 EIOSpace 地址([https://eiospace.digiwincloud.com.cn](https://eiospace.digiwincloud.com.cn/)),按下图输入登录信息后进行登录。 + +![EIOSpace 登录](/media/image129.webp) + +登录成功后,进入 EIOSpace 首页: + +![EIOSpace 首页](/media/image130.webp) + +### Step 2:设定常用模型 + +在下图①处点击,可以选择常用模型,这边使用 **qwen3.8-flash**。 + +![选择常用模型](/media/image131.webp) + +### Step 3:选择专家智能体 + +点击上图②处即下图①处的位置,按照下图①→②→③顺序依次操作,即可选择到前面做的数据分析智能体。 + +![选择专家智能体](/media/image132.webp) + +### Step 4:输入指令运行智能体 + +如下图,可以看到三个页签(开场白预设问题),点击"**分析近半年小型阀体外壳的月度销售数据及趋势看板**"页签即可自动发送指令驱动智能体执行。 + +![点击开场白页签](/media/image133.webp) + +1、开始执行,如下图: + +![开始执行](/media/image134.webp) + +2、执行结果,如下图: + +![执行结果](/media/image135.webp) + +3、点击链接查看分析报告,如下图: + +![查看分析报告](/media/image136.webp) diff --git a/docs/guide/data-project.md b/docs/guide/data-project.md new file mode 100644 index 0000000..d05d9bf --- /dev/null +++ b/docs/guide/data-project.md @@ -0,0 +1,39 @@ +--- +title: 4.3 项目搭建及资料分析 +prev: + text: '4.2 工作区环境准备' + link: /guide/data-workspace +next: + text: '4.4 数据分析技能开发' + link: /guide/data-skill +--- + +# 4.3 项目搭建及资料分析 + +### Step 1:选择目录作为项目 + +进入 Agent Builder 客户端,进入首页,选择"**通用**"。点击【选择项目】→【选择目录作为项目】,选择 4.2 创建的工作区对应的文件夹"**阀体销售分析_xxxx**"。 + +![客户端首页选择"通用"](/media/image93.webp) + +![选择目录作为项目](/media/image94.webp) + +::: warning 注意 +注意权限设定,选择"**完全访问权限**",过程中不会频繁出现"确认执行"的审批。 +::: + +![权限设定选择"完全访问权限"](/media/image95.webp) + +### Step 2:输入资料分析指令并发送 + +在下方对话框中输入资料分析指令(复制下方灰色背景文本框的文字,填入对话框),然后点击**发送**按钮,进入会话页面,AI 开始分析文件夹下的资料,并等待工作完成(预计 5~10 分钟)。 + +![输入资料分析指令](/media/image96.webp) + +```text +熟悉当前项目文件夹下的文档资料 +``` + +![资料分析执行过程与输出结果](/media/image97.webp) + +以上是输出结果,接下来进行技能开发。 diff --git a/docs/guide/data-scenario.md b/docs/guide/data-scenario.md new file mode 100644 index 0000000..e7df16b --- /dev/null +++ b/docs/guide/data-scenario.md @@ -0,0 +1,74 @@ +--- +title: 4.1 数据分析场景说明 +prev: + text: '附录 1-2 智能体测试结果' + link: /guide/appendix +next: + text: '4.2 工作区环境准备' + link: /guide/data-workspace +--- + +# 数据分析场景实战 + +## 4.1 数据分析场景说明 + +本次示例以汽车零部件行业中"小型阀体外壳(Small Valve Body Housing)"的**销售数据分析**为典型场景,演示如何在 **Digi Agent Builder 3.0** 中**构建一个面向销售数据分析与智能问数的智能体**。 + +> "企业销售管理人员需要快速了解小型阀体外壳产品销售情况——各区域/产品/客户的销售额与利润对比、月度趋势与同比环比、成本结构与毛利率变化、销售员业绩排名等。传统方式依赖 BI 工程师手动建报表,响应周期长、技术门槛高、报表风格不统一,难以满足业务快速决策的需求。" + +### 业务场景与核心痛点 + +**小型阀体外壳**广泛应用于变速箱阀体、发动机油路阀体、制动阀体及转向器阀体等系统。企业已积累大量销售订单数据,涵盖订单、成本、利润、客户、产品、区域等多维度信息。当前决策分析平台上的阀体外壳销售记录 × 35 个字段,覆盖 4 个销售大区、多个产品线、多种材质与铸造工艺。 + +当前**数据分析与获取流程**为: + +1. 业务人员向数据部门提交报表需求 → +2. BI 工程师理解需求并确认口径 → +3. 编写 SQL 或配置报表工具 → +4. 生成 Excel 或静态图表 → +5. 业务人员获取报表并阅读分析 → +6. 如需追问或调整维度,重新提交需求。 + +该流程存在以下核心痛点: + +| # | 痛点 | 说明 | +|:--|:--|:--| +| 1 | **响应速度慢** | 一份常规报表从需求提出到交付通常需要半天至数天,难以满足管理层"即时决策"需求,错过最佳决策窗口。 | +| 2 | **技术门槛高** | 业务人员需掌握 SQL 或 Excel 高级功能才能自主查数;一线销售和管理人员只能被动等待数据部门出报表,自主分析能力受限。 | +| 3 | **报表风格不统一** | 不同 BI 工程师制作的报表格式、图表风格各异,缺乏统一标准,跨部门对比和汇总困难。 | +| 4 | **追问成本高** | 看到报表后想进一步追问某个维度或下钻细节,需要重新提需求、排队等待,分析链路被反复打断。 | +| 5 | **数据价值未释放** | 大量历史销售数据沉睡在系统中,缺乏便捷的探索手段,无法快速发现趋势、异常与机会点。 | + +### 智能体可承担的角色 + +在本场景中,AI 智能体将作为"**销售数据分析助手**",承担以下核心任务: + +- **自然语言问数**:业务人员用日常说话的方式提问(如"上个月华东大区卖了多少""哪个产品毛利率最高"),智能体自动调用问数引擎从数据集中查出答案,秒级响应。 +- **Dashboard 自动生成**:用户一句话描述分析需求(如"帮我生成销售分析看板"),智能体自动批量查询 10+ 项数据,选择合适的图表类型,生成包含 KPI 卡片与多个交互式图表的 HTML 仪表盘。 +- **多维度灵活分析**:支持按时间、区域、产品、客户、销售员、材质、铸造方式等 15 个维度字段任意组合分析,覆盖 15 个数值指标的查询与对比。 +- **智能图表选型**:根据数据特征(分类对比、占比分布、时间序列、排名数据等)自动选择最合适的图表类型(柱状图、饼图、折线图、条形图、散点图等 14 种)。 +- **关键洞察提炼**:基于数据分析结果自动提炼 3~5 条关键洞察,并给出可操作的行动建议。 +- **持续追问与下钻**:支持基于已有看板或查询结果继续追问(如"西部大区的毛利率是多少""近三个月订单金额趋势怎样"),在同一会话中上下文连贯地深入分析。 + +### 期望价值与成功标准 + +通过构建该智能体,企业期望实现: + +- **数据获取响应时间**:从半天至数天缩短至秒级响应,自然语言提问即可获取数据结果。 +- **Dashboard 生成效率**:一句话生成包含 10+ 图表的交互式 HTML 看板,支持离线查看,无需 BI 工程师介入。 +- **分析维度覆盖率**:支持全部 15 个维度字段与 15 个数值指标的任意组合查询,覆盖区域对比、趋势分析、产品排名、客户分布、成本结构、利润分析等全部常见分析场景。 +- **降低使用门槛**:普通销售人员无需掌握 SQL 或 Excel 高级功能,经简单引导即可独立完成数据查询与分析。 +- **释放数据价值**:通过便捷的探索式分析,快速发现销售趋势、异常与机会点,让数据真正驱动业务决策。 + +本示例后续章节将以该场景为例,详细介绍在 **Digi Agent Builder 3.0** 中完成需求建模、方案构建、技能编排(智能问数 + Dashboard 生成)、模型配置、系统集成及持续优化的完整开发步骤。 + +### 开发规则说明 + +主要涉及开发过程中相关命名规则,防止发布技能或智能体的时候有冲突。 + +涉及到命名的统一加后缀,格式:**年月日 + 账号后四位流水码**。 + +假设日期为 2026/11/13,当前账号:DigiZZ0001 + +- **技能命名示例**:`valve-sales-analysis-skill-2611130001` +- **智能体命名示例**:`小型阀体外壳销售数据分析-2611130001` diff --git a/docs/guide/data-skill.md b/docs/guide/data-skill.md new file mode 100644 index 0000000..8b667d3 --- /dev/null +++ b/docs/guide/data-skill.md @@ -0,0 +1,104 @@ +--- +title: 4.4 数据分析技能开发 +prev: + text: '4.3 项目搭建及资料分析' + link: /guide/data-project +next: + text: '4.5 数据分析智能体开发' + link: /guide/data-agent +--- + +# 4.4 数据分析技能开发 + +接下来开始进行小型阀体外壳销售数据分析技能开发。 + +### Step 1:选择 Skill 工程技能 + +继续当前会话,对话框输入 `/Skill`,选择"**Skill 工程助手**"来创建技能。 + +![输入 /Skill 选择 Skill 工程助手](/media/image98.webp) + +### Step 2:输入 Skill 开发指令 + +如下图,在下方对话框中输入要求(先看下方注意事项,复制下方灰色背景文本框的文字,填入对话框),然后点击**发送**按钮,进入会话页面,AI 开始基于要求进行技能开发,等待开发完成(预计 10~20 分钟)。 + +![输入 Skill 开发指令](/media/image99.webp) + +```text +先按方案落地 Skill 包,如下注意事项需特别注意: + +1、技能的命名请按方案中的规则来; +2、需要完全遵循 chatbi-toolchain.md 问数引擎调用细则; +3、Dashboard 或者 HTML 交互分析报告,需模板复用,不逐字手写来实现可以避免异常及提高效率,其余按方案要求来 +``` + +![技能开发执行中](/media/image100.webp) + +### Step 3:查看生成产物 + +![技能生成产物](/media/image101.webp) + +此时,技能需要进行**调试**后再发布。 + +![点击【调试】进入调试界面](/media/image102.webp) + +### Step 4:Skill 调试 + +继续当前对话: + +1. 点击下图①处【调试】; +2. 下图②处对话框中输入:**分析今年上半年阀体外壳销售的整体情况**。 + +![对话框中输入调试内容](/media/image103.webp) + +输入完成后,点击**发送**按钮,开始进行调试技能,直到调试完成并输出结果。 + +![调试执行过程](/media/image104.webp) + +### Step 5:Skill 调试结果查看 + +可以看到技能的执行结果及诊断报告,先看下 Skill 输出的结果,点击"**可视化分析报告**"查看结果。 + +![点击可视化分析报告](/media/image105.webp) + +可视化分析报告显示: + +![可视化分析报告内容](/media/image106.webp) + +查看诊断报告: + +![诊断报告](/media/image107.webp) + +::: tip 通过标准 +如上图所示,**未发现 Skill 侧可优化项,则说明技能测试通过**,可以进行下一步。 +::: + +::: warning 注意 +若有类似下图优化的建议,则需要进行优化。 +::: + +![诊断报告中的优化建议](/media/image108.webp) + +在对话框中输入指令:**按建议优化**,然后点击发送后进行优化。 + +![按建议优化执行中](/media/image109.webp) + +### Step 6:Skill 发布 + +1、打开 SKILL.md 文档,点击【发布】按钮。 + +![点击发布按钮](/media/image110.webp) + +2、在出现的发布配置界面中,按照下图①→②→③进行设定,设定完成,点击【确认】。 + +![发布配置界面](/media/image111.webp) + +3、点击【上传覆盖】,技能进行发布。 + +![点击上传覆盖](/media/image112.webp) + +发布成功: + +![发布成功](/media/image113.webp) + +至此,Skill 技能已经开发完成,下面进入数据分析智能体开发。 diff --git a/docs/guide/data-workspace.md b/docs/guide/data-workspace.md new file mode 100644 index 0000000..ba81fe4 --- /dev/null +++ b/docs/guide/data-workspace.md @@ -0,0 +1,51 @@ +--- +title: 4.2 工作区环境准备 +pageClass: gb-chapter-lead +prev: + text: '4.1 数据分析场景说明' + link: /guide/data-scenario +next: + text: '4.3 项目搭建及资料分析' + link: /guide/data-project +--- + +# 4.2 工作区环境准备 + +### Step 1:获取账号密码 + +账号密码由授课老师提供,并根据授课老师的指导进行操作。 + +账号示例:`DigiTraineexxxx` + +拿到账号后先参考「**1.2 如何登录 Agent Builder**」完成相关操作,再展开后续内容。 + +### Step 2:下载数据分析 hands-on 资料包 + +直接下载数据分析 hands-on 资料包: + +
+ +| 平台 | 下载链接 | 说明 | +|:--|:--|:--| +| 🍎 macOS | [**data-analysis-hands-on-mac.zip**](/data-analysis-hands-on-mac.zip) | 适用于 Apple Silicon / Intel Mac | +| 🪟 Windows | [**data-analysis-hands-on-win.zip**](/data-analysis-hands-on-win.zip) | 适用于 Windows 10 / 11 | + +
+ +::: warning 版本说明 +- `……-win.zip` 适配 Windows 电脑 +- `……-mac.zip` 适配 Mac 电脑 +::: + +### Step 3:准备数据分析 hands-on 资料 + +将下载下来的 hands-on 资料解压后把文件夹重命名为 **"阀体销售分析_xxxx"**,并确认文件夹下内容(如下图展示)。 + +![hands-on 资料文件夹结构](/media/image92.webp) + +::: tip 注意事项 +1. **文件夹命名规则**:阀体销售分析 + 账号后四位流水码(鼎捷员工使用 5 位工号)。 +2. `chatbi-toolchain.md`:问数引擎调用细则。 +::: + +确认完成后,现在可以开始进行数据分析智能体开发了。 diff --git a/docs/guide/environment-login.md b/docs/guide/environment-login.md index 13fb3e7..52d7d03 100644 --- a/docs/guide/environment-login.md +++ b/docs/guide/environment-login.md @@ -8,7 +8,7 @@ title: 1.2 如何登录 Agent Builder **Web 端地址**: -## Step 1:进入登录界面 +### Step 1:进入登录界面 浏览器地址栏输入 进入登录界面。根据授课老师提供的账号信息登录。 @@ -22,55 +22,55 @@ title: 1.2 如何登录 Agent Builder ![Web 端登录界面](/media/image6.webp) -## Step 1-1:密码修改提示 +### Step 1-1:密码修改提示 若出现下方提示,则依据提及进行密码修改,点击"**前往鼎捷云修改密码**",若无则正常登录首页进行客户端下载。 ![密码修改提示](/media/image7.webp) -## Step 1-2:鼎捷云企业用户登录 +### Step 1-2:鼎捷云企业用户登录 跳转到鼎捷云登录界面,选择【企业用户登录】,依次输入 Step 1 的租户 ID、账号、密码。输入完成后点击【登入】。 ![鼎捷云企业用户登录](/media/image8.webp) -## Step 1-3:点击立即变更 +### Step 1-3:点击立即变更 点击登入后提示需要修改密码信息,点击【**立即前往变更**】。 ![立即前往变更](/media/image9.webp) -## Step 1-4:完成密码变更 +### Step 1-4:完成密码变更 在弹出的请变更密码对话框中,输入原始密码及新密码后,点击【送出】即可变更密码。密码变更后,回到 登录界面进行登录,即回到 Step 1。 ![完成密码变更](/media/image10.webp) -## Step 2:下载桌面客户端(Web 端首页) +### Step 2:下载桌面客户端(Web 端首页) 若不提示修改密码则登录到首页,左下角点击【用户头像】→【下载桌面客户端】,下载完成后进行安装。 ![用户头像菜单中下载桌面客户端](/media/image11.webp) -## Step 3:通过导航栏下载客户端 +### Step 3:通过导航栏下载客户端 或者在左侧导航栏下方点击【客户端】,下载完成后进行安装。(安装过程不在此介绍说明) ![左侧导航栏的客户端入口](/media/image12.webp) -## Step 4:打开客户端 +### Step 4:打开客户端 客户端安装完成后,打开客户端,点击【登录】。 ![客户端打开后点击登录](/media/image13.webp) -## Step 5:参考 Step 1 登录客户端 +### Step 5:参考 Step 1 登录客户端 参考 Step 1 进行登录。 ![客户端登录界面](/media/image14.webp) -## Step 6:允许登录弹框 +### Step 6:允许登录弹框 出现弹框提示,选择【允许】后自动登录客户端并打开。 diff --git a/docs/guide/scenario.md b/docs/guide/scenario.md index c3f73e8..cd2ae13 100644 --- a/docs/guide/scenario.md +++ b/docs/guide/scenario.md @@ -2,7 +2,7 @@ title: 3.1 智能报价场景说明 --- -# 企业智能体开发实战 +# 智能报价场景实战 ## 3.1 智能报价场景说明 diff --git a/docs/guide/skill.md b/docs/guide/skill.md index 571989f..bd4ea8d 100644 --- a/docs/guide/skill.md +++ b/docs/guide/skill.md @@ -4,7 +4,7 @@ title: 3.4 报价流程编排技能开发 # 3.4 报价流程编排技能开发 -## Step 1:创建 Skill 技能 +### Step 1:创建 Skill 技能 继续当前会话,对话框输入 `/Skill`,选择"**Skill 工程助手**"来创建技能。 @@ -14,7 +14,7 @@ title: 3.4 报价流程编排技能开发 ![选择 Skill 工程助手后](/media/image33.webp) -## Step 2:输入技能开发要求 +### Step 2:输入技能开发要求 在下方对话框中输入要求(先看下方注意事项,复制下方灰色背景文本框的文字,填入对话框),然后点击**发送**按钮,进入会话页面,AI 开始基于要求进行技能开发,等待开发完成(预计 10~20 分钟)。 @@ -30,7 +30,7 @@ title: 3.4 报价流程编排技能开发 下方技能名称命名 `-2609290**001**` 需换成对应的 **yyMMdd + 用户名后面四位流水号**(两位年 + 两位月 + 两位日 + 四位流水)。 ::: -## Step 3:查看开发结果 +### Step 3:查看开发结果 大概 10~20 分钟后,技能开发完成(如图),可以点击【SKILL.md】进入技能目录。 @@ -40,7 +40,7 @@ title: 3.4 报价流程编排技能开发 ![点击 SKILL.md 进入技能目录](/media/image36.webp) -## Step 4:调试 Skill 技能 +### Step 4:调试 Skill 技能 继续当前对话,在对话框中做以下输入: @@ -58,7 +58,7 @@ title: 3.4 报价流程编排技能开发 ![测试执行结果](/media/skill-test-result.webp) -## Step 5:试运行技能 +### Step 5:试运行技能 在测试完毕后直接点击"**试运行**"按钮(此步骤可跳过)。 @@ -74,7 +74,7 @@ title: 3.4 报价流程编排技能开发 ![试运行结果](/media/image41.webp) -## Step 6:发布技能 +### Step 6:发布技能 **Option 1**:在测试及试运行完毕后直接点击"**发布**"按钮。 diff --git a/docs/index.md b/docs/index.md index abf0c38..de32dbb 100644 --- a/docs/index.md +++ b/docs/index.md @@ -18,7 +18,7 @@ features: title: 智能体架构介绍 details: 用户感知层、服务能力层、关联系统层三层架构,明确平台能力底座与开发环境准备流程。 - icon: 🚗 - title: 企业智能体开发实战 + title: 智能报价场景实战 details: 以汽车零部件「小型阀体外壳」智能报价为典型场景,演示从需求建模到智能体发布的完整开发链路。 - icon: 🧩 title: Skill 技能编排 @@ -30,11 +30,13 @@ features: ## 关于本指导书 -本指导书面向 Digi Agent Builder 3.0(IndepthAI 3.0)的智能体开发者,围绕**架构介绍**与**开发实战**两大部分展开: +本指导书面向 Digi Agent Builder 3.0(IndepthAI 3.0)的智能体开发者,按四个章节循序展开: -1. **智能体架构介绍**——介绍平台定位、三层架构、开发环境准备(登录、界面功能、前置数据准备)。 -2. **企业智能体开发实战**——以汽车零部件行业中「小型阀体外壳」的销售报价场景为例,完整演示工作区准备、项目搭建、技能编排、智能体搭建与发布的全流程。 +1. **智能体平台架构介绍**——介绍平台定位、三层架构与开发环境准备(登录、界面功能、前置数据准备)。 +2. **超级智能体使用说明**——介绍超级智能体的能力与基本功能,并以智能报价技能为例完成实战体验。 +3. **智能报价场景实战**——以汽车零部件行业中「小型阀体外壳」的销售报价场景为例,完整演示工作区准备、项目搭建、技能编排、智能体搭建与发布的全流程。 +4. **数据分析场景实战**——以数据分析场景为例,演示工作区准备、项目搭建、技能开发、智能体开发与在 EIOSpace 中运行验证的全流程。 ::: tip 学习建议 -建议按左侧目录顺序学习。第二章的开发步骤需要在 IndepthAI 客户端与 Web 端分别完成操作,请提前准备好账号、hands-on 资料与测试用询价单。 +建议按左侧目录顺序学习。第三、四章的开发步骤需要分别在 IndepthAI 客户端与 Web 端完成操作,请提前准备好账号、hands-on 资料与测试用数据。 ::: diff --git a/docs/public/data-analysis-hands-on-mac.zip b/docs/public/data-analysis-hands-on-mac.zip new file mode 100644 index 0000000..6567a5d Binary files /dev/null and b/docs/public/data-analysis-hands-on-mac.zip differ diff --git a/docs/public/data-analysis-hands-on-win.zip b/docs/public/data-analysis-hands-on-win.zip new file mode 100644 index 0000000..cc6d4c1 Binary files /dev/null and b/docs/public/data-analysis-hands-on-win.zip differ diff --git a/docs/public/media/image100.webp b/docs/public/media/image100.webp new file mode 100644 index 0000000..425ef09 Binary files /dev/null and b/docs/public/media/image100.webp differ diff --git a/docs/public/media/image101.webp b/docs/public/media/image101.webp new file mode 100644 index 0000000..a8f8e44 Binary files /dev/null and b/docs/public/media/image101.webp differ diff --git a/docs/public/media/image102.webp b/docs/public/media/image102.webp new file mode 100644 index 0000000..0745be9 Binary files /dev/null and b/docs/public/media/image102.webp differ diff --git a/docs/public/media/image103.webp b/docs/public/media/image103.webp new file mode 100644 index 0000000..36b0ee3 Binary files /dev/null and b/docs/public/media/image103.webp differ diff --git a/docs/public/media/image104.webp b/docs/public/media/image104.webp new file mode 100644 index 0000000..324f5ae Binary files /dev/null and b/docs/public/media/image104.webp differ diff --git a/docs/public/media/image105.webp b/docs/public/media/image105.webp new file mode 100644 index 0000000..b4f7cee Binary files /dev/null and b/docs/public/media/image105.webp differ diff --git a/docs/public/media/image106.webp b/docs/public/media/image106.webp new file mode 100644 index 0000000..3653d74 Binary files /dev/null and b/docs/public/media/image106.webp differ diff --git a/docs/public/media/image107.webp b/docs/public/media/image107.webp new file mode 100644 index 0000000..5824565 Binary files /dev/null and b/docs/public/media/image107.webp differ diff --git a/docs/public/media/image108.webp b/docs/public/media/image108.webp new file mode 100644 index 0000000..67591bb Binary files /dev/null and b/docs/public/media/image108.webp differ diff --git a/docs/public/media/image109.webp b/docs/public/media/image109.webp new file mode 100644 index 0000000..0bbe494 Binary files /dev/null and b/docs/public/media/image109.webp differ diff --git a/docs/public/media/image110.webp b/docs/public/media/image110.webp new file mode 100644 index 0000000..59e919e Binary files /dev/null and b/docs/public/media/image110.webp differ diff --git a/docs/public/media/image111.webp b/docs/public/media/image111.webp new file mode 100644 index 0000000..3c52458 Binary files /dev/null and b/docs/public/media/image111.webp differ diff --git a/docs/public/media/image112.webp b/docs/public/media/image112.webp new file mode 100644 index 0000000..485c50b Binary files /dev/null and b/docs/public/media/image112.webp differ diff --git a/docs/public/media/image113.webp b/docs/public/media/image113.webp new file mode 100644 index 0000000..237e118 Binary files /dev/null and b/docs/public/media/image113.webp differ diff --git a/docs/public/media/image114.webp b/docs/public/media/image114.webp new file mode 100644 index 0000000..f71cde4 Binary files /dev/null and b/docs/public/media/image114.webp differ diff --git a/docs/public/media/image115.webp b/docs/public/media/image115.webp new file mode 100644 index 0000000..274ddfb Binary files /dev/null and b/docs/public/media/image115.webp differ diff --git a/docs/public/media/image116.webp b/docs/public/media/image116.webp new file mode 100644 index 0000000..d021d6f Binary files /dev/null and b/docs/public/media/image116.webp differ diff --git a/docs/public/media/image117.webp b/docs/public/media/image117.webp new file mode 100644 index 0000000..f68d629 Binary files /dev/null and b/docs/public/media/image117.webp differ diff --git a/docs/public/media/image118.webp b/docs/public/media/image118.webp new file mode 100644 index 0000000..00ee50f Binary files /dev/null and b/docs/public/media/image118.webp differ diff --git a/docs/public/media/image119.webp b/docs/public/media/image119.webp new file mode 100644 index 0000000..46a1860 Binary files /dev/null and b/docs/public/media/image119.webp differ diff --git a/docs/public/media/image120.webp b/docs/public/media/image120.webp new file mode 100644 index 0000000..3124edf Binary files /dev/null and b/docs/public/media/image120.webp differ diff --git a/docs/public/media/image121.webp b/docs/public/media/image121.webp new file mode 100644 index 0000000..dbad704 Binary files /dev/null and b/docs/public/media/image121.webp differ diff --git a/docs/public/media/image122.webp b/docs/public/media/image122.webp new file mode 100644 index 0000000..ea362e6 Binary files /dev/null and b/docs/public/media/image122.webp differ diff --git a/docs/public/media/image123.webp b/docs/public/media/image123.webp new file mode 100644 index 0000000..7403650 Binary files /dev/null and b/docs/public/media/image123.webp differ diff --git a/docs/public/media/image124.webp b/docs/public/media/image124.webp new file mode 100644 index 0000000..62e39c8 Binary files /dev/null and b/docs/public/media/image124.webp differ diff --git a/docs/public/media/image125.webp b/docs/public/media/image125.webp new file mode 100644 index 0000000..b360a3d Binary files /dev/null and b/docs/public/media/image125.webp differ diff --git a/docs/public/media/image126.webp b/docs/public/media/image126.webp new file mode 100644 index 0000000..d7f4e40 Binary files /dev/null and b/docs/public/media/image126.webp differ diff --git a/docs/public/media/image127.webp b/docs/public/media/image127.webp new file mode 100644 index 0000000..a96f542 Binary files /dev/null and b/docs/public/media/image127.webp differ diff --git a/docs/public/media/image128.webp b/docs/public/media/image128.webp new file mode 100644 index 0000000..5363a83 Binary files /dev/null and b/docs/public/media/image128.webp differ diff --git a/docs/public/media/image129.webp b/docs/public/media/image129.webp new file mode 100644 index 0000000..3c5a12a Binary files /dev/null and b/docs/public/media/image129.webp differ diff --git a/docs/public/media/image130.webp b/docs/public/media/image130.webp new file mode 100644 index 0000000..a7f377d Binary files /dev/null and b/docs/public/media/image130.webp differ diff --git a/docs/public/media/image131.webp b/docs/public/media/image131.webp new file mode 100644 index 0000000..e123c47 Binary files /dev/null and b/docs/public/media/image131.webp differ diff --git a/docs/public/media/image132.webp b/docs/public/media/image132.webp new file mode 100644 index 0000000..04561fc Binary files /dev/null and b/docs/public/media/image132.webp differ diff --git a/docs/public/media/image133.webp b/docs/public/media/image133.webp new file mode 100644 index 0000000..9ad6909 Binary files /dev/null and b/docs/public/media/image133.webp differ diff --git a/docs/public/media/image134.webp b/docs/public/media/image134.webp new file mode 100644 index 0000000..1b0eb69 Binary files /dev/null and b/docs/public/media/image134.webp differ diff --git a/docs/public/media/image135.webp b/docs/public/media/image135.webp new file mode 100644 index 0000000..dcd3e52 Binary files /dev/null and b/docs/public/media/image135.webp differ diff --git a/docs/public/media/image136.webp b/docs/public/media/image136.webp new file mode 100644 index 0000000..301b000 Binary files /dev/null and b/docs/public/media/image136.webp differ diff --git a/docs/public/media/image137.webp b/docs/public/media/image137.webp new file mode 100644 index 0000000..a7ad660 Binary files /dev/null and b/docs/public/media/image137.webp differ diff --git a/docs/public/media/image138.webp b/docs/public/media/image138.webp new file mode 100644 index 0000000..3d122b9 Binary files /dev/null and b/docs/public/media/image138.webp differ diff --git a/docs/public/media/image139.webp b/docs/public/media/image139.webp new file mode 100644 index 0000000..ac1fadf Binary files /dev/null and b/docs/public/media/image139.webp differ diff --git a/docs/public/media/image91.webp b/docs/public/media/image91.webp new file mode 100644 index 0000000..5764431 Binary files /dev/null and b/docs/public/media/image91.webp differ diff --git a/docs/public/media/image92.webp b/docs/public/media/image92.webp new file mode 100644 index 0000000..4f216e3 Binary files /dev/null and b/docs/public/media/image92.webp differ diff --git a/docs/public/media/image93.webp b/docs/public/media/image93.webp new file mode 100644 index 0000000..b8b4fa3 Binary files /dev/null and b/docs/public/media/image93.webp differ diff --git a/docs/public/media/image94.webp b/docs/public/media/image94.webp new file mode 100644 index 0000000..2be974b Binary files /dev/null and b/docs/public/media/image94.webp differ diff --git a/docs/public/media/image95.webp b/docs/public/media/image95.webp new file mode 100644 index 0000000..75b3953 Binary files /dev/null and b/docs/public/media/image95.webp differ diff --git a/docs/public/media/image96.webp b/docs/public/media/image96.webp new file mode 100644 index 0000000..2074af8 Binary files /dev/null and b/docs/public/media/image96.webp differ diff --git a/docs/public/media/image97.webp b/docs/public/media/image97.webp new file mode 100644 index 0000000..b77ca92 Binary files /dev/null and b/docs/public/media/image97.webp differ diff --git a/docs/public/media/image98.webp b/docs/public/media/image98.webp new file mode 100644 index 0000000..279ad0b Binary files /dev/null and b/docs/public/media/image98.webp differ diff --git a/docs/public/media/image99.webp b/docs/public/media/image99.webp new file mode 100644 index 0000000..5cbc00a Binary files /dev/null and b/docs/public/media/image99.webp differ diff --git a/scripts/export-static.sh b/scripts/export-static.sh new file mode 100644 index 0000000..9e70630 --- /dev/null +++ b/scripts/export-static.sh @@ -0,0 +1,94 @@ +#!/usr/bin/env bash +# export-static.sh —— 导出可离线浏览的 VitePress 静态包 +# +# 用法: +# bash scripts/export-static.sh # 仅构建并修复路径 +# bash scripts/export-static.sh --pack # 额外打包成 dist.zip +# +# 产物路径:docs/.vitepress/dist/ (附 start-server.command / start-server.bat) +# +# 原理: +# 1) 以 base=./ 构建,让 JS/CSS 等资源引用指向相对路径。 +# 2) VitePress 对 Markdown 里的 /media/xxx 不会按 HTML 所在层级自动调相对 +# 路径,所以这里手工把 guide/*.html 里的 /media/ 改成 ../media/,根目录 +# 的 *.html 里的 /media/ 改成 ./media/。 +# 3) 放入 start-server.command / start-server.bat,用 Python/Node 起本地 +# HTTP 服务(解决浏览器对 file:// 下 ES Module 的 CORS 限制)。 +# +set -euo pipefail + +ROOT="$(cd "$(dirname "$0")/.." && pwd)" +DIST="$ROOT/docs/.vitepress/dist" +cd "$ROOT" + +echo "==> 1) 构建 VitePress(base=./)" +VITEPRESS_BASE=./ pnpm docs:build + +echo "==> 2) 修复 Markdown 绝对图片路径" +# guide/*.html 需要 ../media/,根目录 *.html 需要 ./media/ +if [ -d "$DIST/guide" ]; then + for f in "$DIST"/guide/*.html; do + [ -e "$f" ] || continue + sed -i '' 's|src="/media/|src="../media/|g; s|href="/media/|href="../media/|g' "$f" + done +fi +for f in "$DIST"/*.html; do + [ -e "$f" ] || continue + sed -i '' 's|src="/media/|src="./media/|g; s|href="/media/|href="./media/|g' "$f" +done + +# 校验是否还有残留 +if grep -RIn 'src="/media\|href="/media' "$DIST" >/dev/null 2>&1; then + echo "⚠️ 仍有绝对 /media/ 路径残留,建议检查" + grep -RIn 'src="/media\|href="/media' "$DIST" | head +else + echo "✅ /media 路径全部转为相对" +fi + +echo "==> 3) 写入本地 HTTP 启动脚本" +cat > "$DIST/start-server.command" <<'EOF' +#!/bin/bash +# Digi Agent Builder 3.0 指导书 - 本地静态服务启动器(macOS / Linux) +cd "$(dirname "$0")" +PORT=8000 +if command -v python3 &>/dev/null; then + open "http://localhost:${PORT}/" 2>/dev/null || true + python3 -m http.server "${PORT}" +elif command -v python &>/dev/null; then + open "http://localhost:${PORT}/" 2>/dev/null || true + python -m SimpleHTTPServer "${PORT}" +elif command -v node &>/dev/null; then + open "http://localhost:${PORT}/" 2>/dev/null || true + npx --yes serve -l "${PORT}" . +else + echo "未检测到 Python 或 Node,请先安装 Python 3。" + read -n 1 -s -r -p "按任意键退出..." +fi +EOF +chmod +x "$DIST/start-server.command" + +cat > "$DIST/start-server.bat" <<'EOF' +@echo off +REM Digi Agent Builder 3.0 指导书 - 本地静态服务启动器(Windows) +cd /d "%~dp0" +set PORT=8000 +where python3 >nul 2>&1 && (start "" "http://localhost:%PORT%/" & python3 -m http.server %PORT% & goto :eof) +where python >nul 2>&1 && (start "" "http://localhost:%PORT%/" & python -m SimpleHTTPServer %PORT% & goto :eof) +where node >nul 2>&1 && (start "" "http://localhost:%PORT%/" & npx --yes serve -l %PORT% . & goto :eof) +echo 未检测到 Python 或 Node,请先安装 Python 3。 +pause +EOF + +echo "" +echo "✅ 静态导出完成:$DIST" +echo " macOS / Linux:双击 start-server.command" +echo " Windows:双击 start-server.bat" + +if [[ "${1:-}" == "--pack" ]]; then + ZIP="$ROOT/dist-export.zip" + echo "" + echo "==> 4) 打包 dist-export.zip" + rm -f "$ZIP" + (cd "$DIST" && zip -rq "$ZIP" . -x '*.DS_Store') + echo "✅ 打包完成:$ZIP ($(du -sh "$ZIP" | awk '{print $1}'))" +fi