系统管理员手册 - AI应用接入管理

本章节指导系统管理员如何接入第三方AI平台的应用，并配置知识库。

支持的AI平台：

已支持：Dify、FastGPT、移动云AI、自定义接口
即将支持：扣子（Coze）、百度千帆、阿里通义、讯飞星火等

系统采用统一的API对接标准，新平台接入周期短，敬请期待。

4.1 AI应用接入概述

iTrainer的AI定位

重要理念：

🔴 iTrainer 不是AI应用开发平台

✅ iTrainer 是AI应用接入和权限管理平台

传统方式：
Dify平台 → 生成分享链接 → 任何人都能访问
问题：无法管理权限，无法追踪使用，无法控制成本

iTrainer方式：
Dify平台 → 在iTrainer中接入 → 精确分配给用户
优势：权限可控，使用可追踪，成本可管理

核心价值：权限管理 ⭐

问题：传统AI平台的局限

Dify、FastGPT、扣子等AI平台：

✅ 强大的AI能力
✅ 可视化应用构建
❌ 只能生成分享链接
❌ 无法精确控制谁能用
❌ 无法追踪谁用了多少次
❌ 无法与业务系统集成

示例场景：

场景：企业有10个AI应用，50个员工

传统方式的问题：
1. 生成10个分享链接
2. 通过QQ群、邮件发给员工
3. 无法控制：
   - 张三只能用"方案生成器"，不能用"合同审核"
   - 李四离职了，但链接仍然有效
   - 王五把链接分享给了外部人员
4. 无法统计：
   - 不知道谁用了多少次
   - 不知道哪个应用最受欢迎
   - 无法控制成本

解决方案：iTrainer的权限管理

iTrainer如何解决：

1. 接入应用
   └─ 在iTrainer中配置Dify应用的API

2. 精确分配
   └─ 销售部：方案生成器、话术优化
   └─ 培训部：课程生成器、PPT助手
   └─ 财务部：合同审核、报表分析

3. 权限控制
   └─ 张三离职 → 禁用账号 → 无法使用任何应用
   └─ 李四调岗 → 调整角色 → 自动调整可用应用

4. 使用追踪
   └─ 记录每次使用
   └─ 统计使用频率
   └─ 分析成本分布

5. 内容管理
   └─ AI生成内容可保存为文档
   └─ 同步到知识库
   └─ 形成企业知识资产

价值总结：

维度	传统方式	iTrainer方式
权限控制	🔴 无法控制	✅ 精确到用户
使用追踪	🔴 无法追踪	✅ 完整记录
成本管理	🔴 无法管理	✅ 可统计分析
内容沉淀	🔴 内容丢失	✅ 保存到知识库
业务整合	🔴 独立系统	✅ 与CRM/任务链整合

支持的AI平台

平台	说明	推荐指数
Dify	国内最流行的AI应用平台	⭐⭐⭐⭐⭐ 强烈推荐
FastGPT	开源AI应用平台	⭐⭐⭐⭐ 推荐
自定义API	任何OpenAI兼容的API	⭐⭐⭐ 需要技术能力

本章节以Dify为例（最常用）

4.2 在Dify平台创建应用

在iTrainer中接入应用前，需要先在Dify平台创建应用。

步骤1：访问Dify平台

方式一：使用Dify云服务

访问：https://cloud.dify.ai
注册账号并登录

方式二：使用自建Dify

访问您企业自建的Dify地址
示例：http://difyedu.mycache.cn
使用企业账号登录

步骤2：创建工作空间（首次使用）

如果是首次使用Dify：

登录后创建工作空间
填写工作空间名称（如：您的公司名）
选择工作空间类型（企业版/个人版）
完成创建

步骤3：创建AI应用

3.1 选择应用类型

点击"创建应用"，Dify提供多种应用类型：

应用类型	说明	适用场景
聊天助手	对话式应用	客服、咨询、问答
文本生成	生成指定格式内容	方案生成、文案创作
Agent	智能代理，可以使用工具	复杂任务、多步骤操作
工作流	可视化流程编排	复杂业务流程

推荐选择：

内容生成类：文本生成
对话交流类：聊天助手
复杂任务类：Agent 或 工作流

示例：创建"销售方案生成器" - 选择"文本生成"

3.2 配置应用基础信息

应用名称：给应用起一个清晰的名称
- ✅ 好的名称：销售方案生成器、客户跟进话术优化、培训课程大纲生成
- ❌ 不好的名称：应用1、测试、AI助手
应用图标：选择或上传图标
- 帮助用户快速识别应用
应用描述：简要说明应用功能
- 示例："根据客户需求，快速生成专业的培训方案"

3.3 选择大模型

Dify支持多种大模型：

模型	特点	适用场景
GPT-4	最强大，成本最高	复杂任务、高质量输出
GPT-3.5-turbo	平衡性能和成本	日常使用
Claude	Anthropic出品，擅长长文本	文档分析、写作
文心一言	国产模型	中文场景

选择建议：

预算充足：GPT-4
日常使用：GPT-3.5-turbo
中文场景：文心一言

3.4 编写Prompt（提示词）

这是应用的核心，决定AI的行为。

Prompt编写原则：

明确角色：告诉AI它是谁
明确任务：告诉AI要做什么
明确输出格式：告诉AI如何输出
提供示例（可选）：给AI参考

示例Prompt：

# 销售方案生成器

## 你的角色
你是一位资深的企业培训方案专家，拥有10年以上的培训行业经验。

## 你的任务
根据客户提供的需求信息，生成一份专业的培训方案。

## 输入信息
- 客户公司：{{company_name}}
- 培训对象：{{target_audience}}
- 培训目标：{{training_goal}}
- 预算范围：{{budget}}
- 时间要求：{{timeline}}

## 输出要求
请按以下结构输出培训方案：

### 一、需求分析
简要分析客户的培训需求和目标

### 二、培训方案
1. 培训主题
2. 培训内容大纲（3-5个模块）
3. 培训方式（线上/线下/混合）
4. 培训周期

### 三、实施计划
具体的时间安排和实施步骤

### 四、预算说明
费用明细和预算分配

### 五、预期效果
培训完成后的预期效果

## 注意事项
- 方案要专业、可落地
- 根据预算合理设计
- 突出培训的价值和效果

Prompt中的变量：

使用格式
这些变量会在应用界面显示为输入框
用户填写后，AI会根据这些变量生成内容

3.5 配置应用参数

模型参数：

参数	说明	推荐值
温度（Temperature）	创造性程度	0.7（内容生成） 0.3（准确回答）
Top P	采样范围	0.9
最大长度	最多生成多少字	2000-4000

其他设置：

开场白：用户打开应用时显示的欢迎语
推荐问题：给用户的提示问题

3.6 测试应用

配置完成后，务必测试：

点击右侧的"预览"按钮
输入测试数据
查看AI生成的内容
根据效果调整Prompt
反复测试直到满意

步骤4：获取API凭证

应用创建并测试通过后，获取API凭证以便在iTrainer中接入。

4.1 进入API访问页面

在Dify应用管理页面
找到刚创建的应用
点击"访问API"或"API管理"

4.2 创建API Key

点击"创建API密钥"
填写密钥名称（如：iTrainer接入）
设置权限（通常选择"完全访问"）
点击"创建"

4.3 记录必要信息

⚠️ 重要：API Key只显示一次，请立即复制保存

需要记录的信息：

信息项	说明	示例
API URL	API地址（必须包含/v1）	https://api.dify.ai/v1 或 http://your-dify.com/v1
API Key	应用密钥（app-开头）	app-xxxxxxxxxxxxxx
应用ID	应用的唯一标识	通常在URL中

区分两种地址：

管理界面地址（人工登录）：http://difyedu.mycache.cn
API地址（程序调用）：http://difyedu.mycache.cn/v1 ← 注意多了 /v1

步骤5：配置知识库（可选）

如果应用需要使用知识库（RAG检索增强）：

5.1 创建知识库

在Dify平台，进入"知识库"模块
点击"创建知识库"
填写知识库名称（如：培训方案库）
选择向量模型（使用默认即可）
完成创建

5.2 上传文档到知识库

进入刚创建的知识库
点击"上传文档"
选择文档文件（支持PDF、Word、TXT等）
等待文档向量化完成
向量化完成后，文档可被检索

5.3 在应用中关联知识库

回到应用配置页面
找到"知识库"配置区域
点击"添加知识库"
选择刚创建的知识库
配置检索参数：
- 检索模式：向量检索（推荐）或混合检索
- Top K：返回最相关的K条结果（推荐3-5）
- 相关度阈值：最低相关度（推荐0.5-0.7）
保存配置

5.4 测试知识库检索

在应用预览界面
输入一个问题，内容应该能在知识库文档中找到答案
查看AI是否正确检索并使用了知识库内容
如果效果不好，调整检索参数

4.3 在系统中接入应用

Dify应用创建完成后，在iTrainer中接入。

访问路径

智能体管理 → 应用管理 → 应用列表

前端路由: /agents/app

步骤1：新增应用

进入应用管理页面
点击右上角的 "新增应用" 按钮

步骤2：填写基本信息

必填信息

字段	说明	示例
应用名称	在iTrainer中显示的名称	销售方案生成器
平台类型	选择AI平台	Dify
API地址	Dify的API URL	http://difyedu.mycache.cn/v1
API密钥	从Dify获取的API Key	app-xxxxxxxxxxxxxx

⚠️ 重要提醒：

API地址必须包含 /v1 后缀
API密钥以 app- 开头（Dify应用密钥）
确保没有多余的空格

高级配置

字段	说明	推荐值
平台应用ID	Dify中的应用ID	从Dify URL获取（可选）
应用类型	normal/practice	normal
排序	显示顺序	1、2、3...

步骤3：配置应用特性

勾选应用支持的功能：

特性	说明	建议
☑ 存储聊天记录	是否保存用户的对话历史	重要应用建议勾选
☑ 支持知识库	应用是否使用了Dify知识库	如果在Dify中配置了知识库，必须勾选
☑ 支持保存结果	用户是否可以保存AI生成的内容	内容生成类应用建议勾选

特性说明：

存储聊天记录：

勾选：用户的每次对话都会保存在系统中
不勾选：对话不保存，每次都是新会话
场景：重要的咨询对话建议保存，临时测试可以不保存

支持知识库：

勾选：系统会传递知识库参数给Dify
不勾选：即使Dify中配置了知识库，也不会生效
场景：应用在Dify中配置了知识库时必须勾选

支持保存结果：

勾选：用户可以把AI生成的内容保存为文档
不勾选：只能查看内容，无法保存
场景：方案生成、文案创作等建议勾选

步骤4：获取应用参数（重要）⭐

点击 "获取参数" 按钮：

功能说明：

系统自动连接Dify，获取应用的输入参数配置
这些参数会在用户使用应用时显示为输入表单
Dify应用支持自动获取，FastGPT暂不支持

示例：

Dify应用的Prompt中定义了：
- {{company_name}} - 客户公司
- {{training_goal}} - 培训目标
- {{budget}} - 预算范围

点击"获取参数"后：
系统自动识别这3个参数，并配置为输入框
用户使用时会看到：
  - 客户公司：[输入框]
  - 培训目标：[输入框]
  - 预算范围：[输入框]

步骤5：配置开场白和推荐问题（可选）

开场白：

用户打开应用时显示的欢迎语
示例："你好！我是销售方案生成助手，请告诉我客户的培训需求，我会为你生成专业的方案。"

推荐问题：

给用户的提示问题
帮助用户快速开始
示例：
- "如何为企业设计一套新员工培训方案？"
- "针对销售团队的技能提升培训应该包含哪些内容？"

步骤6：保存应用

检查所有配置是否正确
点击 "确定" 保存
应用创建成功

步骤7：测试应用连接

保存后，建议立即测试：

在应用列表中找到刚创建的应用
点击 "测试连接" 按钮
系统会尝试调用Dify API
查看测试结果：
- ✅ 连接成功：配置正确
- ❌ 连接失败：检查API地址和密钥

常见错误：

错误信息	原因	解决方法
Connection refused	API地址错误	检查地址是否包含/v1
Invalid API Key	API密钥错误	重新从Dify复制密钥
Timeout	网络问题	检查网络连接
404 Not Found	应用不存在	检查应用ID是否正确

4.4 配置应用参数

应用接入后，可以进一步配置参数和显示方式。

应用参数管理

访问方式：

在应用列表中，点击应用的 "参数配置" 按钮

参数类型

系统支持多种参数类型：

类型	说明	显示方式
text	单行文本	输入框
textarea	多行文本	文本域
select	单选	下拉框
number	数字	数字输入框
date	日期	日期选择器

手动添加参数（如果自动获取失败）

如果"获取参数"功能失败，可以手动添加：

点击 "添加参数" 按钮
填写参数信息：

字段	说明	示例
参数名	参数的key（与Dify中的变量名一致）	company_name
显示名称	用户看到的标签	客户公司
参数类型	选择类型	text
是否必填	用户必须填写	是
默认值	预填充的值	（可选）
提示文字	输入框的placeholder	请输入客户公司名称

保存参数

参数排序

调整参数在用户界面的显示顺序：

在参数列表中拖动参数
或点击"上移""下移"按钮
保存排序

参数示例

示例应用："培训方案生成器"

参数1：
- 参数名：company_name
- 显示名称：客户公司
- 类型：text
- 必填：是
- 提示：请输入客户公司名称

参数2：
- 参数名：training_goal
- 显示名称：培训目标
- 类型：textarea
- 必填：是
- 提示：描述客户希望通过培训达成的目标

参数3：
- 参数名：budget
- 显示名称：预算范围
- 类型：select
- 必填：是
- 选项：5万以下、5-10万、10-20万、20万以上

参数4：
- 参数名：timeline
- 显示名称：时间要求
- 类型：date
- 必填：否
- 提示：希望何时完成培训

用户使用时会看到一个表单，包含这4个输入项。

4.5 知识库配置

知识库配置分为两部分：系统级配置和应用级配置。

系统级配置（已在第2章完成）

回顾：系统设置中的知识库API配置

配置项：
- kb_api_url：Dify知识库API地址
- kb_api_key：Dataset API Key

重要提示：创建知识库后配置锁定

如果还未配置，请先完成第2章的配置。

创建知识库

在iTrainer中创建知识库（对应Dify的Dataset）。

访问路径：

智能体管理 → 知识库管理 → 知识库列表

前端路由: /agents/dataset

步骤1：新增知识库

进入知识库管理页面
点击 "新增知识库" 按钮

步骤2：填写知识库信息

字段	说明	示例
知识库名称	显示名称	培训方案知识库
知识库描述	简要说明	存储历史培训方案和案例
向量模型	使用默认	text-embedding-ada-002

步骤3：创建知识库

点击 "确定" 创建。

⚠️ 重要提醒：

第一次创建知识库成功后，系统设置中的 kb_api_url 和 kb_api_key 将被锁定
请确保这两个配置是正确的

同步文档到知识库

创建知识库后，可以将文档同步到知识库进行向量化。

方式一：从文档管理同步

访问：文档管理 → 文档列表
选择要同步的文档
点击 "同步到知识库" 按钮
选择目标知识库
确认同步

方式二：在知识库中上传

访问：智能体管理 → 知识库管理
进入知识库详情
点击 "上传文档"
选择文件
等待上传和向量化

支持的文档格式：

PDF：.pdf
Word：.doc, .docx
文本：.txt, .md
Excel：.xls, .xlsx（转换为文本）

向量化过程

文档上传后，系统自动执行向量化：

1. 文档上传到iTrainer
   ↓
2. iTrainer调用Dify API
   ↓
3. Dify提取文档内容
   ↓
4. Dify调用向量模型（如OpenAI Embedding）
   ↓
5. 生成文档的向量表示
   ↓
6. 存储到向量数据库
   ↓
7. 向量化完成，可被检索

向量化时间：

小文档（几页）：几秒钟
大文档（几十页）：几分钟
可以在知识库详情中查看进度

关联应用到知识库

应用创建时如果勾选了"支持知识库"，可以关联知识库。

关联方式：

方式一：在Dify中关联（推荐）

登录Dify管理界面
编辑应用配置
在"知识库"区域添加知识库
保存

这样iTrainer调用应用时，Dify会自动检索知识库。

方式二：在iTrainer中关联

访问：智能体管理 → 应用管理
编辑应用
在"关联知识库"区域选择知识库
保存

知识库权限管理

控制谁可以访问知识库：

访问路径：

智能体管理 → 知识库管理 → 知识库详情 → 权限管理

权限设置：

点击 "添加权限" 按钮
选择授权对象：
- 部门：授权给整个部门
- 用户：授权给特定用户
设置操作权限：
- 只读：只能查看和使用
- 编辑：可以上传文档
- 删除：可以删除文档
保存

默认权限：

创建者：拥有全部权限
其他人：无权限（需要授权）

知识库维护

文档管理

查看文档列表：

进入知识库详情
查看已向量化的文档

删除文档：

选择文档
点击"删除"
确认删除
文档的向量数据也会被删除

重新向量化

如果文档内容更新：

删除旧文档
重新上传新版本
系统重新向量化

RAG检索增强原理

什么是RAG：

RAG（Retrieval-Augmented Generation）= 检索增强生成

传统方式：
用户提问 → AI直接回答（只依赖模型训练数据）

RAG方式：
用户提问
  ↓
1. 在知识库中检索相关文档（向量相似度计算）
  ↓
2. 找到最相关的3-5段内容
  ↓
3. 将检索内容 + 用户问题 一起发给AI
  ↓
4. AI基于检索内容生成回答
  ↓
5. 回答更准确、更有依据

RAG的优势：

✅ 回答基于企业自己的知识库
✅ 内容更准确、更专业
✅ 可以引用具体来源
✅ 知识库更新，AI回答也更新

示例：

场景：培训方案生成器关联了"培训方案知识库"

用户提问："为一家500人的制造企业设计安全生产培训"

RAG流程：
1. 在知识库中检索"安全生产培训"相关文档
2. 找到3份历史方案：
   - 某汽车厂安全培训方案
   - 某化工厂安全培训方案
   - 安全生产法规培训案例
3. 将这3份方案的相关内容提供给AI
4. AI参考这些案例，生成新方案
5. 生成的方案质量更高，更符合实际

结果：生成的方案更专业，包含行业最佳实践

本章小结

本章介绍了AI应用接入管理的完整流程：

核心流程回顾

1. 在Dify平台创建应用
   ├─ 选择应用类型
   ├─ 编写Prompt
   ├─ 配置参数
   ├─ 测试应用
   └─ 获取API凭证

2. 在iTrainer中接入应用
   ├─ 填写API地址和密钥
   ├─ 配置应用特性
   ├─ 获取参数
   └─ 测试连接

3. 配置知识库（可选）
   ├─ 创建知识库
   ├─ 上传文档
   ├─ 向量化
   └─ 关联到应用

关键要点

✅ iTrainer不是AI开发平台：是AI应用接入和权限管理平台 ✅ 核心价值是权限管理：精确控制谁能用哪些应用 ✅ 支持使用追踪：记录每次使用，分析成本 ✅ 内容可沉淀：AI生成内容保存到知识库 ✅ RAG检索增强：基于企业知识库生成更准确的内容

配置检查清单

完成本章配置后，请确认：

[ ] 已在Dify平台创建至少1个应用
[ ] 已获取Dify的API地址和密钥
[ ] 已在iTrainer中成功接入应用
[ ] 应用测试连接成功
[ ] 应用参数配置正确
[ ] 如使用知识库，已完成知识库配置
[ ] 已测试应用能正常调用
[ ] 理解了iTrainer的权限管理价值
[ ] 理解了RAG检索增强原理

下一步

完成AI应用接入后，请继续：

第5章：应用分配管理 - 将应用分配给用户使用

本章完成！ 您已经掌握了 iTrainer 的AI应用接入方法。

系统管理员手册 - AI应用接入管理 ​

4.1 AI应用接入概述 ​

iTrainer的AI定位 ​

核心价值：权限管理 ⭐ ​

问题：传统AI平台的局限 ​

解决方案：iTrainer的权限管理 ​

支持的AI平台 ​

4.2 在Dify平台创建应用 ​

步骤1：访问Dify平台 ​

步骤2：创建工作空间（首次使用） ​

步骤3：创建AI应用 ​

3.1 选择应用类型 ​

3.2 配置应用基础信息 ​

3.3 选择大模型 ​

3.4 编写Prompt（提示词） ​

3.5 配置应用参数 ​

3.6 测试应用 ​

步骤4：获取API凭证 ​

4.1 进入API访问页面 ​

4.2 创建API Key ​

4.3 记录必要信息 ​

步骤5：配置知识库（可选） ​

5.1 创建知识库 ​

5.2 上传文档到知识库 ​

5.3 在应用中关联知识库 ​

5.4 测试知识库检索 ​

4.3 在系统中接入应用 ​

访问路径 ​

步骤1：新增应用 ​

步骤2：填写基本信息 ​

必填信息 ​

高级配置 ​

步骤3：配置应用特性 ​

步骤4：获取应用参数（重要）⭐ ​

步骤5：配置开场白和推荐问题（可选） ​

步骤6：保存应用 ​

步骤7：测试应用连接 ​

4.4 配置应用参数 ​

应用参数管理 ​

参数类型 ​

手动添加参数（如果自动获取失败） ​

参数排序 ​

参数示例 ​

4.5 知识库配置 ​

系统级配置（已在第2章完成） ​

创建知识库 ​

步骤1：新增知识库 ​

步骤2：填写知识库信息 ​

步骤3：创建知识库 ​

同步文档到知识库 ​

方式一：从文档管理同步 ​

方式二：在知识库中上传 ​

向量化过程 ​

关联应用到知识库 ​

方式一：在Dify中关联（推荐） ​

方式二：在iTrainer中关联 ​

知识库权限管理 ​

知识库维护 ​

文档管理 ​

重新向量化 ​

RAG检索增强原理 ​

本章小结 ​

核心流程回顾 ​

关键要点 ​

配置检查清单 ​

下一步 ​