feat: 初始化 VitePress Web 版指导书

- VitePress 1.6 站点(中文/搜索/侧边栏/品牌主题)
- 11 个 Markdown 页面,Step 表格结构化
- 88 张图压缩为 webp(45MB → 6MB)
- favicon + 下载资料包(mac/win)
- GitHub Pages 部署工作流
This commit is contained in:
2026-10-16 16:07:54 +08:00
commit 23a81acd2d
111 changed files with 3062 additions and 0 deletions
+80
View File
@@ -0,0 +1,80 @@
import { defineConfig } from 'vitepress'
// 本地运行用 '/';部署到 GitHub Pages 等项目子路径时,通过环境变量 VITEPRESS_BASE 覆盖,
// 例如 VITEPRESS_BASE=/GuideBook/ pnpm docs:build
const base = process.env.VITEPRESS_BASE || '/'
export default defineConfig({
lang: 'zh-CN',
title: 'Digi Agent Builder 3.0',
description: '鼎捷雅典娜 IndepthAI · 智能体开发示例指导书',
base,
cleanUrls: true,
head: [
['meta', { name: 'theme-color', content: '#1c5fd4' }],
['meta', { name: 'viewport', content: 'width=device-width,initial-scale=1' }],
['link', { rel: 'icon', type: 'image/png', href: `${base}favicon.png` }],
['link', { rel: 'shortcut icon', type: 'image/png', href: `${base}favicon.png` }]
],
themeConfig: {
siteTitle: 'Digi Agent Builder 3.0 指导书',
nav: [
{ text: '首页', link: '/' },
{ text: '架构设计', link: '/guide/' },
{ text: '开发实战', link: '/guide/scenario' },
{
text: '开发平台',
items: [
{ text: 'Web 端', link: 'https://kai-wis.apps.digiwincloud.com.cn/' }
]
}
],
sidebar: {
'/guide/': [
{
text: '第一章 智能体架构介绍',
items: [
{ text: '1.1-1.2 平台简介与架构概览', link: '/guide/' },
{ text: '1.3.1 如何登录智能体开发平台', link: '/guide/environment-login' },
{ text: '1.3.2 界面关键功能简介', link: '/guide/environment-ui' },
{ text: '1.3.3 前置文档数据准备', link: '/guide/environment-prepare' }
]
},
{
text: '第二章 企业智能体开发实战',
collapsed: false,
items: [
{ text: '2.1 企业智能体示例场景说明', link: '/guide/scenario' },
{ text: '2.2.1 工作区环境准备', link: '/guide/workspace' },
{ text: '2.2.2 项目搭建及方案生成', link: '/guide/agent-dev' },
{ text: '2.2.3 报价流程编排技能开发', link: '/guide/skill' },
{ text: '2.2.4.1 自主推理智能体', link: '/guide/reasoning-agent' },
{ text: '2.2.4.2 会话流智能体', link: '/guide/chatflow-agent' }
]
},
{
text: '附录',
items: [{ text: '附录 1-2 智能体测试结果', link: '/guide/appendix' }]
}
]
},
outline: { level: [2, 4], label: '本页目录' },
search: { provider: 'local' },
docFooter: { prev: '上一页', next: '下一页' },
returnToTopLabel: '返回顶部',
sidebarMenuLabel: '目录',
darkModeSwitchLabel: '主题',
lightModeSwitchTitle: '切换到浅色模式',
darkModeSwitchTitle: '切换到深色模式',
footer: {
message: '本指导书用于 Digi Agent Builder 3.0 智能体开发示例教学',
copyright: 'Copyright © 2026 鼎捷数智'
}
}
})
+139
View File
@@ -0,0 +1,139 @@
/* ===== Digi Agent Builder 3.0 指导书主题样式 ===== */
:root {
--vp-c-brand-1: #1c5fd4;
--vp-c-brand-2: #2f7ce8;
--vp-c-brand-3: #4a92f5;
--vp-c-brand-soft: rgba(28, 95, 212, 0.14);
--vp-home-hero-name-color: transparent;
--vp-home-hero-name-background: linear-gradient(120deg, #1c5fd4 20%, #17b3a3 80%);
--vp-home-hero-image-background-image: linear-gradient(-45deg, #1c5fd4 40%, #17b3a3 100%);
--vp-home-hero-image-filter: blur(56px);
--gb-border: rgba(28, 95, 212, 0.18);
--gb-card-bg: rgba(28, 95, 212, 0.035);
}
.dark {
--gb-border: rgba(120, 170, 255, 0.22);
--gb-card-bg: rgba(120, 170, 255, 0.06);
}
/* ---- 正文排版 ---- */
.vp-doc h1 {
font-size: 1.9rem;
line-height: 1.3;
}
.vp-doc h2 {
margin-top: 2.6rem;
padding-top: 0.7rem;
border-top: 1px solid var(--vp-c-divider);
font-size: 1.42rem;
}
.vp-doc h3 {
margin-top: 1.8rem;
font-size: 1.18rem;
}
/* ---- 正文图片:统一卡片化,响应式 ---- */
.vp-doc img {
display: block;
max-width: 100%;
height: auto;
margin: 0.9rem auto;
border: 1px solid var(--gb-border);
border-radius: 10px;
background: #fff;
box-shadow: 0 2px 10px rgba(15, 23, 42, 0.08);
cursor: zoom-in;
}
.dark .vp-doc img {
background: #0f172a;
}
/* 图片说明文字 */
.vp-doc p:has(> img) + em,
.vp-doc img + em {
display: block;
text-align: center;
font-size: 0.85rem;
color: var(--vp-c-text-2);
}
/* ---- 步骤标题:Step 序号卡片化 ---- */
.vp-doc h2[id^='step-'],
.vp-doc h3[id^='step-'] {
padding-left: 0.75rem;
border-left: 4px solid var(--vp-c-brand-1);
border-top: none;
margin-top: 2.2rem;
}
/* ---- 表格 ---- */
.vp-doc table {
display: table;
width: 100%;
margin: 1.2rem 0;
}
.vp-doc tr:nth-child(2n) {
background-color: var(--gb-card-bg);
}
.vp-doc th {
background-color: var(--vp-c-brand-soft);
}
/* ---- 提示块 ---- */
.vp-doc .custom-block {
border-radius: 10px;
font-size: 0.94rem;
}
.vp-doc .custom-block.tip,
.vp-doc .custom-block.warning,
.vp-doc .custom-block.danger,
.vp-doc .custom-block.info {
border-width: 1px;
}
/* ---- 代码/斜体提示词(原文中的需复制文字) ---- */
.vp-doc em strong,
.vp-doc strong em {
display: inline-block;
padding: 0.1rem 0.3rem;
border-radius: 5px;
background: var(--vp-c-brand-soft);
font-style: normal;
color: var(--vp-c-brand-1);
}
/* ---- 首页 hero ---- */
.VPHero .name {
font-size: 2.6rem;
}
.VPHero .text {
font-size: 1.5rem;
}
.VPFeature {
border-color: var(--gb-border);
}
/* ---- 移动端 ---- */
@media (max-width: 640px) {
.vp-doc h1 {
font-size: 1.5rem;
}
.vp-doc h2 {
font-size: 1.22rem;
}
.vp-doc img {
border-radius: 8px;
}
}
+21
View File
@@ -0,0 +1,21 @@
import DefaultTheme from 'vitepress/theme'
import mediumZoom from 'medium-zoom'
import { onMounted, watch, nextTick } from 'vue'
import { useRoute } from 'vitepress'
import './custom.css'
export default {
extends: DefaultTheme,
setup() {
const route = useRoute()
const initZoom = () => {
// 所有正文图片支持点击放大查看
mediumZoom('.vp-doc img:not(.no-zoom)', {
background: 'rgba(15, 23, 42, 0.82)',
margin: 24
})
}
onMounted(() => nextTick(initZoom))
watch(() => route.path, () => nextTick(initZoom))
}
}
+55
View File
@@ -0,0 +1,55 @@
---
title: 2.2.2 项目搭建及方案生成
---
# 2.2.2 项目搭建及方案生成
## Step 1:进入客户端首页
进入 IndepthAI 客户端,进入首页,选择"**通用**"。
![客户端首页选择"通用"](/media/image23.webp)
## Step 2:选择项目目录并设定权限
**Step 2-1**:点击【选择项目】→【选择目录作为项目】,选择 2.2.1 创建的工作区对应的文件夹"汽车零部件智能报价_xxxx"。
![选择目录作为项目](/media/image24.webp)
![选择工作区文件夹](/media/image25.webp)
**Step 2-2**:注意权限设定,选择"**完全访问权限**",过程中不会频繁出现"确认执行"的审批。
![权限设定选择"完全访问权限"](/media/image26.webp)
## Step 3:输入需求并发送
在右侧对话框中输入需求(复制下方文字,斜体字都要复制,填入对话框),然后点击**发送**按钮,进入会话页面,AI 开始基于需求进行智能体生成,并等待工作完成(预计 10~15 分钟)。
![输入需求](/media/image27.webp)
> **请熟悉当前文件夹内容,再明确 NB-AI-汽车零部件-2026-0088.md 文档的 MVP 需求,基于需求的描述提供一份汽车零部件(小型阀体外壳)智能报价的设计方案。**
>
> **方案要求:只需聚焦 接收客户询价单 → 自动完成解析、客户校验、材质对照、成本核算、目标价比对 → 生成报价单(需要 HTML 格式输出,以便在线查看) → 报价记录写入 CRM(询价单/报价单/商机三单串联不做),全程无需人工参与。**
>
> **最后注意,要独立完成方案设计,方案不能参考现有任何相关已开发或发布的技能内容,如:auto-parts-quotation-engine 编排引擎等,切记这点很重要!**
点击发送按钮后开始任务:
![发送后等待任务](/media/image28.webp)
## Step 4:检查生成的方案
约 10 分钟后智能体生成的方案完成,产出物"**智能报价设计方案.md**",检查方案是否与设想的有出入。
![方案生成完成](/media/image29.webp)
生成的 MD 文件内容示例:
![生成的 MD 方案内容示例](/media/image30.webp)
点击右上角【"..."】→【打开文件】,可以看见生成的方案文件。
![点击"..."菜单](/media/image31.webp)
方案确认没有问题,可以进行报价流程编排的技能开发,继续当前会话。
+13
View File
@@ -0,0 +1,13 @@
---
title: 附录 1-2 智能体测试结果
---
# 附录
## 附录 1:智能体测试结果 — 总结输出
![智能体测试结果 - 总结输出](/media/image89.webp)
## 附录 2:智能体测试结果 — HTML 报价单
![智能体测试结果 - HTML 报价单](/media/image90.webp)
+112
View File
@@ -0,0 +1,112 @@
---
title: 2.2.4.2 会话流智能体
---
# 2.2.4.2 会话流智能体
登录 Web 端 IndepthAI:<https://kai-wis.apps.digiwincloud.com.cn>
## 2.2.4.2.1 会话流智能体开发与测试
### Step 1:新增 Agent
登录云端开发平台,进入【开发中心】→【Agent 开发】→【新增】。
![进入 Agent 开发新增](/media/image73.webp)
### Step 2:选择会话流并配置基础信息
请选择【**会话流**】,并陆续配置【Agent 名称】→【Agent 描述】→【分组】→【确定】。
![选择会话流并配置](/media/image74.webp)
> **名称**:汽车零部件报价智能体 2609290001(根据当前日期及被分配的账号调整数字)
>
> **描述**:汽车零部件智能体 MVP 版本,小型阀体外壳的报价,目标:利用汽车零部件小型阀体外壳的报价 Skill(auto-parts-quotation-skill-2609290001),把客户 Excel 询价单在 5 分钟内变成「单文件 HTML 报价单 + CRM 存档 + 处理摘要」。
### Step 3:删除默认节点
创建后进入画布,先删除默认的节点。
![删除默认节点](/media/image75.webp)
> **操作说明**:鼠标悬浮于要删除的节点上,右上角会出现删除按钮,点击删除按钮即可删除。
### Step 4:新增 SKILL 调用节点
![新增 SKILL 调用节点](/media/image76.webp)
### Step 5:连接节点
将 SKILL 调用节点与开始节点连起来。
![连接开始节点与 Skill 调用节点](/media/image77.webp)
> **操作说明**:将鼠标悬浮于【开始】节点上,移动到边框中间会出现"+",按下鼠标左键同时拖动鼠标,让鼠标悬浮于【Skill 调用】节点左侧边框中间,当出现"+"时,松开鼠标即可。
### Step 6:配置 Skill 调用节点
选择 Skill 调用节点,进行节点配置:
- 选择自己开发完成的技能,如:小型阀体外壳智能报价 0001 / `auto-parts-quotation-skill-260929001`
- 模型选择:**Qwen-3.7-plus 或 Qwen-3.6-35B-A3B**
![配置 Skill 调用节点](/media/image78.webp)
::: warning 注意
这边需选择带自己账号后面对应流水号的技能。
:::
确认参数传入系统变量"**系统文件数组 sys.files**",其余设置默认即可。
![确认参数传入 sys.files](/media/image79.webp)
选择前面开发完成的 Skill:
![选择 Skill](/media/image80.webp)
点击【设置】按钮,进行 Chatflow 设置,先进行【系统交互】设置 → 【附件】的选项设置为"**开启**"且"**必填**"。
![设置附件为开启且必填](/media/image81.webp)
> 其余设置可依据自己的需要自行配置。
### Step 8:试运行
点击【试运行】,先进行【上传附件】,并输入简单的提示词(用文件夹下提供的 Excel 即可)。
![试运行](/media/image82.webp)
### Step 9:查看执行结果
查看执行结果,点击右图蓝色链接可以在线预览报价单。
![执行结果](/media/image83.webp)
### Step 10:在线预览报价单
![在线预览报价单](/media/image84.webp)
至此,本次智能体的开发任务就完成了,接下来进行**发布**。
## 2.2.4.2.2 智能报价智能体发布
### Step 1:点击发布
![点击发布](/media/image85.webp)
### Step 2:确认发布设置
发布设置,设置完成后点击【确认发布】。
![发布设置与确认](/media/image86.webp)
### Step 3:发布后确认
![发布后确认](/media/image87.webp)
### Step 4:发布运行
运行结果参考附录。
![发布运行结果](/media/image88.webp)
+81
View File
@@ -0,0 +1,81 @@
---
title: 1.3.1 如何登录智能体开发平台
---
# 1.3.1 如何登录智能体开发平台
鼎捷 IndepthAI 开发平台分 Web 端和客户端,本节先从 Web 端登录说明。
**Web 端地址**:<https://kai-wis.apps.digiwincloud.com.cn>
## Step 1:进入登录界面
浏览器地址栏输入 <https://kai-wis.apps.digiwincloud.com.cn/> 进入登录界面。根据授课老师提供的账号信息登录。
::: warning 注意
- 非企业用户(如鼎捷员工)通过**个人登录**即可。
- 企业用户需选择**企业用户登录**,使用下方示例账号登录:
- 租户 ID:`202060808`
- Username:`DigiZZxxxx`
- Password:`DigiZZxxxx`
:::
![Web 端登录界面](/media/image6.webp)
## Step 1-1:密码修改提示
若出现右侧提示,则依据提及进行密码修改,点击"**前往鼎捷云修改密码**",若无则正常登录首页进行客户端下载。
![密码修改提示](/media/image7.webp)
## Step 1-2:鼎捷云企业用户登录
跳转到鼎捷云登录界面,选择【企业用户登录】,依次输入 Step 1 的租户 ID、账号、密码。输入完成后点击【登入】。
![鼎捷云企业用户登录](/media/image8.webp)
## Step 1-3:点击立即变更
点击登入后提示需要修改密码信息,点击【**立即前往变更**】。
![立即前往变更](/media/image9.webp)
## Step 1-4:完成密码变更
在弹出的请变更密码对话框中,输入原始密码及新密码后,点击【送出】即可变更密码。密码变更后,回到 <https://kai-wis.apps.digiwincloud.com.cn> 登录界面进行登录,即回到 Step 1。
![完成密码变更](/media/image10.webp)
## Step 2:下载桌面客户端(Web 端首页)
若不提示修改密码则登录到首页,左下角点击【用户头像】→【下载桌面客户端】,下载完成后进行安装。
![用户头像菜单中下载桌面客户端](/media/image11.webp)
## Step 3:通过导航栏下载客户端
或者在左侧导航栏下方点击【客户端】,下载完成后进行安装。(安装过程不在此介绍说明)
![左侧导航栏的客户端入口](/media/image12.webp)
## Step 4:打开客户端
客户端安装完成后,打开客户端,点击【登录】。
![客户端打开后点击登录](/media/image13.webp)
## Step 5:参考 Step 1 登录客户端
参考 Step 1 进行登录。
![客户端登录界面](/media/image14.webp)
## Step 6:允许登录弹框
出现弹框提示,选择【允许】后自动登录客户端并打开。
![点击允许后自动登录](/media/image15.webp)
登录成功后自动打开客户端并进入首页:
![客户端首页](/media/image16.webp)
+11
View File
@@ -0,0 +1,11 @@
---
title: 1.3.3 前置文档数据准备
---
# 1.3.3 智能体开发前置文档数据准备
在开始开发智能体前,需要提前准备好对应的**业务文档**与**基础数据**,保障后续开发流程顺畅推进。
1. **梳理待开发智能体对应的业务规则文档**——明确业务的处理流程、判断标准、异常场景处理逻辑等核心内容,帮助后续完成智能体的技能编排与流程配置。
2. **整理智能体要用到的领域知识文档**——包括业务规范、常见问题库、产品资料等内容,后续可直接导入知识管理模块构建智能体的知识库。
3. **提前准备好测试用的业务样本数据**——用于开发完成后的智能体功能验证与效果评测,确保开发完成的智能体符合预期的业务使用要求。
+58
View File
@@ -0,0 +1,58 @@
---
title: 1.3.2 界面关键功能简介
---
# 1.3.2 智能体开发界面关键功能简介
## 开发中心
开发中心提供智能体开发及 Skill 开发管理,同时支持云端与地端的智能体和 Skill 管理。
平台目前支持多种类型的智能体,包括**自主推理智能体**、**会话流智能体**以及**工作流智能体**。不同类型的智能体适用于不同复杂度的应用场景,从基础问答到复杂业务流程自动化均可实现。用户可以通过平台提供的应用模板或创建功能快速构建智能体。通常只需完成模型选择、提示词配置、知识库绑定以及流程设计等步骤,即可生成并发布智能体应用。支持**单节点调试**、**全流程试运行**,**节点异常处理**策略(默认值、异常分支)可灵活配置,保障流程运行稳定。
IndepthAI 针对性推出 Skill 能力模块,核心价值在于打破一次性交付的路径依赖,推动智能体建设转向资产化复用的新模式。
Skill 模块实现了标准化的封装机制,将提示词策略、工具调用逻辑与行业业务规则统一封装,规范输入输出格式、参数配置与调用标准,让不同场景的智能体可以直接调用成熟能力,**避免从零开始搭建**。模块覆盖 Skill 从开发、发布到订阅、授权的全流程管理,同时支持版本迭代,满足业务持续演进的需求。
该能力可广泛应用于多类制造业务场景,支撑标准化表单自动生成、工业报表多维度解读、生产业务规则合规校验,也可直接封装行业通用流程组件实现跨项目复用。目前 Skill 模块已推出可用版本,支持基础的创建与运行功能并持续迭代。
![开发中心](/media/image17.webp)
## 知识管理
随着生成式 AI 技术迅猛发展,企业数智化转型迈向深水区,非结构化数据已成为企业核心知识资产的重要载体,但如何对其**高效挖掘**、**精准交互**及**安全管控**,成为行业普遍面临的难题。基于此,依托鼎捷雅典娜 AI 数智平台,凭借在 AI 大模型与自然语言处理技术上的深厚积淀,以多维度技术创新构建企业知识交互新范式,通过文档解析引擎、智能分片、图谱自动构建、长短期记忆沉淀及思维链推理等核心能力,联动知识与图谱检索形成协同效应,高效支撑多模态、多场景问答需求。
![知识管理](/media/image18.webp)
## 资源中心
IndepthAI 构建了完善的资源库体系,包括**插件**、**词库**、**交互模板**以及 **MCP** 等能力模块,支持智能体在不同业务场景中的灵活扩展。通过插件机制可以对接企业内部系统或第三方服务,通过词库管理提升模型对行业术语和专业知识的理解能力,而交互模板则为常见业务场景提供标准化的交互模式。这种可扩展的能力体系不仅提高了应用构建效率,也使平台能够**持续适应企业不断变化的业务需求**。
资源中心展示当前租户下所有资源数据,包含模型管理、交互模板、插件、数据库、MCP 以及词库模块。需要注意的是,数据库能力提供了个人的资源管理,其他能力为租户级资源管理。用户可查看编辑资源,其中插件和交互模板支持导出。
![资源中心](/media/image19.webp)
::: warning 注意
官方资源不支持编辑修改和导出,仅支持使用。
:::
## 测评中心
智能体开发落地的核心痛点,集中在上线环节的效果不确定性。过往依赖开发人员经验判断的准入模式,往往会带着已知或未知的缺陷上线,引发业务人员体验滑坡,甚至产生不可控的安全风险,抬高项目试错成本。评测能力构建的核心价值,就是打破这种经验依赖,**建立标准化的质量准入体系**,**从根源上降低智能体上线的风险**。
评测能力覆盖两类核心资产的质量验证,支持智能体与沉淀的行业 Skill 开展横向对比测试,明确不同版本、不同方案的效果差异。评测维度覆盖业务落地的核心关切:既包含输出结果的准确性、多轮交互的稳定性,也涵盖企业最关注的内容安全性,还能验证工具调用、业务执行环节的效果偏差,形成完整的质量评估体系。配套模拟试运行与全链路日志分析能力,可帮助开发团队快速定位短板,支撑上线前的持续优化,保障智能体稳定交付。
这套能力适配四类核心业务场景:智能体上线前的标准验收、版本更新后的效果回归验证、提示词迭代过程中的效果对比,以及高风险场景的前置安全检查,多维度筑牢智能体上线的质量防线。
![测评中心](/media/image20.webp)
## 运维管理
运维管理分为产品上架、产品授权、租户自定义以及运行日志模块。
- **产品上架**:主要用于将商用 Agent 发布至鼎捷 OM 系统。
- **产品授权**:主要用于将租户下的 Agent 授权于具体用户使用。
- **租户自定义**:主要用于对租户下可以 Agent 做二次开发,将 Agent 根据租户实际使用场景进行自定义配置。
- **运行日志**:主要用于存储当前租户下 Agent 的运行日志。
![运维管理](/media/image21.webp)
+23
View File
@@ -0,0 +1,23 @@
---
title: 1.1-1.2 平台简介与架构概览
---
# 智能体架构介绍
## 1.1 鼎捷雅典娜 Agent Builder (IndepthAI 3.0) 简介
人工智能正深度渗透制造业各类核心业务中,但行业普遍面临 AI 应用从"能回答"到"能办事"的转型瓶颈。IndepthAI 企业智能体开发与运行平台,是一款专为制造业打造的工业级智能体平台,致力于帮助企业打破 AI 与业务场景的壁垒,实现 AI 应用的**可治理**、**可运营**,真正让 AI 成为企业业务提效的核心引擎。
IndepthAI 作为鼎捷面向制造业打造的工业级智能体平台,有别于通用平台的仅输出工具的交付模式,IndepthAI 提供智能体从**开发**、**运行**、**评测**到**发布**、**治理**的一体化平台能力,构建模型、知识、工具、流程一体化的智能体运行环境,破除企业自行集成的繁琐环节。
## 1.2 智能体开发平台架构概览
IndepthAI 架构自上而下划分为清晰的三个层级,各层权责明确,共同构筑制造业专属的企业智能体能力底座。
1. **用户感知层**(最顶层):直接面向开发人员和终端用户提供交互入口,涵盖专家级智能体开发 IDE,以及全链路运行调试管控前端,满足不同角色的操作需求。
2. **服务能力层**(中间层):整合智能体开发与运行的全品类核心能力。一方面提供两类成熟的智能体服务,适配不同业务场景:面向固定流程场景提供 **Workflow 智能体服务**,支持可视化流程编排;面向**开放任务场景**提供**自主智能体服务**,支持动态任务规划与可控执行。另一方面搭建完善的开发工具矩阵与资源中心,覆盖智能体、Skill、工具、提示词等全品类资产的开发管理,沉淀可复用的行业能力资产,同时提供 **Agent 运行与支撑服务**,保障智能体稳定运行。
3. **关联系统层**(最底层):沉淀企业级智能体落地所需的共性支撑能力,涵盖模型管理、效果评测、运行监控、安全防护、权限管控、运营运维等核心模块,为智能体规模化落地提供坚实的治理保障。
![IndepthAI 智能体开发平台架构图](/media/image5.webp)
这套架构的核心价值,在于将制造业场景经验、连接能力、治理要求全部转化为平台化的可复用能力,彻底避免每个项目从零搭建的低效交付模式,支撑智能体快速落地并稳定运行。
+155
View File
@@ -0,0 +1,155 @@
---
title: 2.2.4.1 自主推理智能体
---
# 2.2.4.1 自主推理智能体
接下来,用自主推理智能体搭建小型阀体外壳智能报价智能体。
## 2.2.4.1.1 自主推理智能体开发与测试
### Step 1:选择推理智能体助手
继续之前会话,在对话框选择输入 `/推理`,选择"**推理智能体助手**"。
![输入 /推理](/media/image49.webp)
### Step 2:创建智能体指令
如右侧图示,创建小型阀体外壳智能报价智能体指令(复制下方文字,斜体字都要复制,填入对话框,注意替换的内容)。
![输入智能体创建指令](/media/image50.webp)
> **创建小型阀体外壳智能报价智能体,引用 auto-parts-quotation-skill-2609300100 技能完成报价,同时引用外挂知识库 报价知识库 提供行业知识、标准规范、报价 SOP、BOM 解析、成本估算等专业指导以及解答报价相关 FAQ。**
::: warning 注意
上方 `auto-parts-quotation-skill-2609300100` 需替换为 **2.2.3 生成的技能名称**。
:::
输出结果:
![智能体创建输出结果](/media/image51.webp)
### Step 3:进入开发配置界面
**Step 3-1**:点击"**打开**",进入自主推理智能体开发配置界面。
![点击打开](/media/image52.webp)
打开自主推理智能体开发配置界面,通过上述画面可以对提示词、对话开场白、开场白预设问题等进行优化:
- **推理配置**:提供模型设定选择
- **Skills**:可以引入不同技能
- **知识库与知识库配置**:可以挂载知识库及知识检索配置
![自主推理智能体开发配置界面](/media/image53.webp)
**Step 3-2**:检查推理配置,确认模型信息。
![检查推理配置](/media/image54.webp)
**Step 3-2**:检查 Skills 是否正确,不正确可以进行调整。
![检查 Skills](/media/image55.webp)
**Step 3-3**:手动添加知识库,点击右侧图示"+"。
![点击"+"添加知识库](/media/image56.webp)
**Step 3-3-1**:选择"报价知识库 / 报价知识手册"。
![选择报价知识库](/media/image57.webp)
**Step 3-3-2**:所选"报价知识库"已添加,可以开启**图谱召回**。测试的时候,可以依据问答效果调整 **TopK 及最小匹配度**等参数。
![开启图谱召回](/media/image58.webp)
**Step 3-3-4**:系统交互,分别开启**多轮对话**及**附件**(附件选择可选)。
![开启多轮对话与附件](/media/image59.webp)
**Step 3-4**:此时,可以将开场白、开场白预设问题重新生成及对提示词进行优化。
![优化开场白与提示词](/media/image60.webp)
> **开场白文案**:您好,我是小型阀体外壳智能报价智能体。我的核心能力基于询价 Excel 利用技能自动核算成本并生成 HTML 报价单;提供行业知识、标准规范、报价 SOP、BOM 解析、成本估算等专业指导及解答报价相关。
### Step 4:进入调试预览
点击"**调试**",进入调试预览画面。
![点击调试](/media/image61.webp)
### Step 5:调试测试
按序操作:
1. 上传附件示例 Excel 文件;
2. 输入提示词(如:请解析附件询价 excel 并生成报价);
3. 点击【发送】按钮。
![调试测试操作](/media/image62.webp)
运行结果:
![调试运行结果](/media/image63.webp)
## 2.2.4.1.2 自主推理智能体发布
### Step 1:发布前建议修改智能体名称
点击编辑按钮。
![点击编辑按钮](/media/image64.webp)
### Step 2:对智能体进行重命名
命名规则建议:在名称后面添加"**年月日 + 账号流水号**"。
::: tip 注意
本示例未修改名称,此处仅供修改名称参考。
:::
![重命名智能体](/media/image65.webp)
### Step 3:点击发布
点击"**发布**",进入发布界面。
![点击发布](/media/image66.webp)
### Step 4:确认发布
点击"**确认发布**",进行发布。
![确认发布](/media/image67.webp)
### Step 5:发布成功
![发布成功](/media/image68.webp)
### Step 6:在 Web 端查看
发布成功后,登录 Web 端 <https://kai-wis.apps.digiwincloud.com.cn>,进入【开发中心】,点击发布的智能体。
![开发中心中查看已发布智能体](/media/image69.webp)
### Step 7:进入智能体运行界面
进入发布的智能体,分别按照图示操作,进入智能体运行界面。
![进入智能体运行界面](/media/image70.webp)
### Step 7-1:发布后测试
按照图示操作进行发布后测试。
![发布后测试](/media/image71.webp)
> 运行结果可参考**附录 1 与附录 2**。
### Step 6-2:咨询行业知识
发布后测试,这边还可以进行报价相关的行业标准、工艺知识、成本估算方法、BOM 解析、报价 SOP 等进行咨询。
![咨询报价相关知识](/media/image72.webp)
+72
View File
@@ -0,0 +1,72 @@
---
title: 2.1 企业智能体示例场景说明
---
# 企业智能体开发实战
## 2.1 企业智能体示例场景说明
本次示例以汽车零部件行业中"小型阀体外壳(Small Valve Body Housing)"的销售过程为典型场景,演示如何在 **Digi Agent Builder 3.0** 中**构建一个面向企业智能报价的智能体**。
> "汽车主机厂及 Tier 1 供应商发来的小型阀体外壳询价规格书格式多样,通常包含 OEM 图纸、RFQ 表格、技术条件书等,企业需投入大量人力解读图纸、提取参数、匹配内部工艺编码后才能报价,**响应周期长**、**人工成本高且易出错**。"
### 业务场景与核心痛点
**小型阀体外壳**广泛应用于变速箱阀体、发动机油路阀体、制动阀体及转向器阀体等系统。常见材质包括 ADC12/A380 铝合金、HT250/QT500 铸铁、A356-T6 铝合金,产品重量 0.3kg~5kg,最大轮廓尺寸通常在 50mm~300mm 之间,关键精度要求如平面度 0.02~0.05mm、孔位度 Φ0.03~0.1mm、壁厚公差 ±0.15mm,表面处理涉及阳极氧化、电泳涂装、钝化、喷砂等。
当前**企业报价流程**为:
1. 客户发送询价包(图纸+技术条件+RFQ 表格)→
2. 报价工程师人工阅读图纸并提取关键尺寸、公差、表面粗糙度、材质要求 →
3. 材料工程师进行材质牌号对照(GB/ASTM/JIS/EN/ISO)→
4. 工艺工程师确认工艺路线(铸造/机加工/表面处理/检测)→
5. 核价专员依据材料市价与工时费率逐项核算成本 →
6. 生成报价单并经审批后输出。
该流程存在以下核心痛点:
| # | 痛点 | 说明 |
|:--|:--|:--|
| 1 | **响应速度慢** | 单份报价处理需 3~5 天,难以满足主机厂"快速定点"模式,订单流失风险高。 |
| 2 | **人力成本高** | 报价工程师需兼具图纸解读、工艺、材料标准等多领域知识,培养周期长达 6~12 个月;报价环节人力成本占总报价成本的约 35%。 |
| 3 | **错误率偏高** | 图纸参数提取准确率约 80%,材质牌号对照错误率约 8%,工艺路线映射偏差率约 12%,因报价偏差导致低价中标亏损或高价丢单的年均损失可达数十万元。 |
| 4 | **知识传承断层** | 资深工程师经验难以沉淀,新人上手周期进一步拉长。 |
| 5 | **数据孤岛** | 图纸、工艺卡、报价单分别存储在 PDM、MES、ERP 等系统中,未形成统一关联。 |
### 智能体可承担的角色
在本场景中,AI 智能体将作为"报价工程师助手",承担以下核心任务:
1. **多格式文档解析**:自动解析 PDF 2D 图纸、STEP/IGES 3D 模型参数表、Excel RFQ 表格、Word 技术条件书,兼容图文混排与表格结构。
2. **关键参数智能提取**:基于 OCR 与多模态视觉理解,自动识别并提取外形尺寸、壁厚、孔径与孔位、平面度/同轴度等形位公差、表面粗糙度、材质牌号、表面处理要求等关键参数。
3. **材质牌号自动对照**:基于企业内部材料牌号对照表,将客户指定牌号自动转换为企业内部等效牌号。
4. **工艺路线智能映射**:根据产品参数(材质、精度、表面要求)自动推荐铸造方式 → 机加工 → 表面处理 → 检测方案。
5. **智能核价**:结合 ERP 等实时数据,核算材料成本、加工工时、表面处理、检测、包装运输、管理费及利润,输出分项成本明细与总报价。
6. **报价单自动生成与人工审核**:按客户模板自动生成 Excel/PDF 报价单,并提供可视化审核界面,支持人工确认与修正,修正结果可反馈优化模型。
### 期望价值与成功标准
通过构建该智能体,企业期望实现:
1. **报价响应时间**:从 3~5 天缩短至 30 分钟以内。
2. **关键参数提取准确率**:达到 98% 以上,材质牌号对照准确率达到 99.5% 以上,工艺路线映射准确率达到 95% 以上。
3. **核价精度误差**:控制在 ±3% 以内。
4. 降低对资深报价工程师的依赖,使普通销售人员经 1 天培训即可独立完成基础报价操作。
5. 沉淀报价知识,形成可持续迭代的智能报价能力。
本示例后续章节将以该场景为例,详细介绍在 **Digi Agent Builder 3.0** 中完成需求建模、方案构建、技能编排、模型配置、系统集成及持续优化的完整开发步骤。
### 开发规则说明
主要涉及开发过程中相关命名规则,防止发布技能或智能体的时候有冲突。
涉及到命名的统一加后缀,格式:**年月日 + 账号后四位流水码**。
假设日期为 2026/09/28,当前账号:`DigiTrainee0001`
- **技能命名示例**:`auto-parts-quotation-skill-2609280001`
- **智能体命名示例**:`小型阀体外壳智能报价-2609280001`
## 2.2 企业智能体开发详细步骤
开发示例的目标在于实现该场景的最小可行产品,即构建一条端到端的智能报价流水线:智能体接收客户提交的 Excel 格式询价单后,自动完成结构化解析、客户信息校验、材料规格对照、成本核算及目标价格比对等环节,随后生成 HTML 格式的报价单草稿。报价结果将写入客户关系管理系统,使得自动化环节耗时压缩至分钟级别,整体流程(不包含人工审核)控制在 30 分钟以内。
+97
View File
@@ -0,0 +1,97 @@
---
title: 2.2.3 报价流程编排技能开发
---
# 2.2.3 报价流程编排技能开发
## Step 1:创建 Skill 技能
继续当前会话,对话框输入 `/Skill`,选择"**Skill 工程助手**"来创建技能。
![输入 /Skill](/media/image32.webp)
选择完成后如图:
![选择 Skill 工程助手后](/media/image33.webp)
## Step 2:输入技能开发要求
在右侧对话框中输入要求(先看下方注意事项,复制右侧文字,斜体字都要复制,填入对话框),然后点击**发送**按钮,进入会话页面,AI 开始基于要求进行技能开发,等待开发完成(预计 10~20 分钟)。
![输入技能开发要求](/media/image34.webp)
> **基于设计方案及当前文件夹下的内容,开发一个技能 Skill 来实现小型阀体外壳智能报价(方案中涉及的 MCP 服务已注册到平台资源目录中)。**
>
> **注意:将技能名称命名 auto-parts-quotation-skill-2609290001**
::: warning 注意
右侧技能名称命名 `-2609290**001**` 需换成对应的 **yyMMdd + 用户名后面四位流水号**(两位年 + 两位月 + 两位日 + 四位流水)。
:::
## Step 3:查看开发结果
大概 10~20 分钟后,技能开发完成(如图),可以点击【SKILL.md】进入技能目录。
![技能开发完成](/media/image35.webp)
此时,技能需要进行**本地测试**后,再进行发布。
![点击 SKILL.md 进入技能目录](/media/image36.webp)
## Step 4:测试 Skill 技能
继续在对话框中添加 Excel 附件"上传附件示例.xlsx",输入提示词"**请测试 skill**",观察执行结果。
![测试 Skill 技能](/media/image37.webp)
若有异常或者错误会自动修正,并测试通过输出结果。测试完成后,可以去发布了。
![测试执行结果](/media/image38.webp)
::: tip 注意
这边有可能会进行交互,即有些内容需要开发确认后再执行。
:::
## Step 5:试运行技能
在测试完毕后直接点击"**试运行**"按钮。
![点击试运行](/media/image39.webp)
1. 上传附件示例 Excel 文件;
2. 输入提示词(如:请解析附件询价 excel 并生成报价);
3. 点击【发送】按钮。
![试运行输入](/media/image40.webp)
试运行结果:
![试运行结果](/media/image41.webp)
## Step 6:发布技能
**Option 1**:在测试及试运行完毕后直接点击"**发布**"按钮。
**Option 2**:从【开发中心】→【SKILL 开发】进入,找到刚才开发好的 Skill,点击打开后,再按照 Option 1 操作。
![发布入口](/media/image42.webp)
![从 SKILL 开发进入](/media/image43.webp)
**Step 6-2**:发布技能,在 Skill 技能内容的右上角点击【发布】按钮。
![右上角发布按钮](/media/image36.webp)
**Step 6-2**:在出现的发布配置界面中,按照右图进行设定,设定完成,点击【确认】。
![发布配置界面](/media/image44.webp)
**Step 6-2**:点击【上传覆盖】,技能进行发布。
![上传覆盖与发布中](/media/image45.webp) ![发布继续](/media/image46.webp)
**Step 6**:确认技能发布是否成功;进入【开发中心】→【SKILL 开发】,检查是否有"已发布"的字样。
![SKILL 开发列表 1](/media/image47.webp) ![SKILL 开发列表 2](/media/image48.webp)
至此,Skill 技能已经开发完成,下面进入报价智能体搭建,大家可以选择 **2.2.4.1 自主推理智能体**或者 **2.2.4.2 会话流智能体**。
+45
View File
@@ -0,0 +1,45 @@
---
title: 2.2.1 工作区环境准备
---
# 2.2.1 工作区环境准备
## Step 1:获取登录账号 / 密码
账号密码由授课老师提供,并根据授课老师的指导进行操作。
账号示例:`DigiTraineexxxx`
拿到账号后先参考「**1.3.1 如何登录智能体开发平台**」完成相关操作,再展开后续内容。
## Step 2:准备 hands-on 资料
将授课老师提供的 hands-on 资料 zip 文件保存到电脑上,解压后把文件夹重命名为 **"汽车零部件智能报价_xxxx"**,并确认文件夹下内容(如右图展示)。
![hands-on 资料文件夹结构](/media/image22.webp)
::: tip 注意事项
1. **文件夹命名格式**:汽车零部件智能报价 + 账号后四位流水码(鼎捷员工使用 5 位工号)。
2. `references/询价单测试用例` 可以用于后面智能体测试。
3. 本项目所需要的相关 ERP 及 CRM 数据服务已完成云端 MCP 注册。
:::
::: warning 版本说明
- `……-win.zip` 适配 Windows 电脑
- `……-mac.zip` 适配 Mac 电脑
:::
## Step 3:下载 hands-on 资料包
直接下载智能体开发资料包:
<div class="downloads">
| 平台 | 下载链接 | 说明 |
|:--|:--|:--|
| 🍎 macOS | [**hands-on-mac.zip**](/hands-on-mac.zip) | 适用于 Apple Silicon / Intel Mac |
| 🪟 Windows | [**hands-on-win.zip**](/hands-on-win.zip) | 适用于 Windows 10 / 11 |
</div>
确认完成后,现在可以开始进行智能体开发了。
+40
View File
@@ -0,0 +1,40 @@
---
layout: home
hero:
name: Digi Agent Builder 3.0
text: 智能体开发示例指导书
tagline: 鼎捷雅典娜 IndepthAI · 面向制造业的工业级智能体开发与运行平台,覆盖开发、运行、评测、发布、治理一体化能力
actions:
- theme: brand
text: 开始学习
link: /guide/
- theme: alt
text: 直接进入开发实战
link: /guide/scenario
features:
- icon: 🏗️
title: 智能体架构介绍
details: 用户感知层、服务能力层、关联系统层三层架构,明确平台能力底座与开发环境准备流程。
- icon: 🚗
title: 企业智能体开发实战
details: 以汽车零部件「小型阀体外壳」智能报价为典型场景,演示从需求建模到智能体发布的完整开发链路。
- icon: 🧩
title: Skill 技能编排
details: 将提示词策略、工具调用逻辑与行业业务规则标准化封装,支持开发、测试、发布、订阅与版本迭代。
- icon: 🚀
title: 发布与运行
details: 自主推理智能体与会话流智能体两条搭建路径,含试运行验证与发布后测试的完整操作指引。
---
## 关于本指导书
本指导书面向 Digi Agent Builder 3.0(IndepthAI 3.0)的智能体开发者,围绕**架构介绍**与**开发实战**两大部分展开:
1. **智能体架构介绍**——介绍平台定位、三层架构、开发环境准备(登录、界面功能、前置数据准备)。
2. **企业智能体开发实战**——以汽车零部件行业中「小型阀体外壳」的销售报价场景为例,完整演示工作区准备、项目搭建、技能编排、智能体搭建与发布的全流程。
::: tip 学习建议
建议按左侧目录顺序学习。第二章的开发步骤需要在 IndepthAI 客户端与 Web 端分别完成操作,请提前准备好账号、hands-on 资料与测试用询价单。
:::
Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

Binary file not shown.
Binary file not shown.
Binary file not shown.

After

Width:  |  Height:  |  Size: 4.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 100 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 79 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 85 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 139 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 104 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 73 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 79 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 84 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 81 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 155 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 103 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 98 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 73 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 37 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 61 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 85 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Some files were not shown because too many files have changed in this diff Show More