灵珠平台学习手册
来源:灵珠平台文档中心(https://rokid.yuque.com/ub8h5n/hth52o)
共53篇文档,持续更新中
最后更新:2026-05-14
目录
- 第一章:平台概述
- 1.1 什么是灵珠平台
- 1.2 平台架构
- 第二章:开发智能体
- 2.1 智能体基础设置
- 2.2 为智能体添加技能
- 2.3 为智能体添加知识
- 2.4 为智能体添加记忆
- 2.5 提升智能体对话体验
- 2.6 搭建智能体实践案例
- 2.7 三方智能体导入
- 第三章:开发工作流
- 3.1 搭建工作流
- 3.2 基础节点
- 3.3 业务逻辑节点
- 3.4 输入和输出节点
- 第四章:数据库节点
- 4.1 知识和数据节点
- 4.2 组件节点
- 第五章:资源
- 附录
第一章:平台概述
1.1 什么是灵珠平台
📝 待补充内容(需重新登录读取)
1.2 平台架构
📝 待补充内容(需重新登录读取)
第二章:开发智能体
2.1 智能体基础设置
📝 待补充内容(需重新登录读取)
2.2 为智能体添加技能
📝 待补充内容(需重新登录读取)
2.3 为智能体添加知识
✅ 已读 — 核心内容如下:
知识库两大核心能力
| 能力 | 说明 |
|---|---|
| 数据管理与存储 | 支持从本地文档上传或自定义创建数据,上传后可自动切分为内容片段存储,支持自定义分片规则(分段标识符、字符长度等) |
| 增强检索 | 提供多种检索方式(全文检索等)对内容片段进行检索和召回 |
作用:解决大模型幻觉、专业领域知识不足的问题,提升大模型回复的准确率
添加知识库步骤
- 登录灵珠开发平台
- 页面顶部选择目标工作空间,左侧导航栏单击「项目开发」
- 创建智能体或选择已创建的智能体
- 在编排页面的知识区域,选择灵珠知识库,单击 + 图标添加知识库
⚠️ 限制:单个智能体最多可绑定 150个知识库
召回配置项详解
| 配置项 | 选项 | 说明 |
|---|---|---|
| 调用方式 | 自动调用 | 每轮对话都调用知识库,使用召回内容辅助生成回复 |
| 按需调用 | 智能体根据提示词自行判断是否调用;需在人设与回复逻辑区域明确填写期望调用哪个知识库 | |
| 搜索策略 | 混合 | 结合全文检索和语义检索优势,综合排序 |
| 语义 | 理解词与词、句与句之间的关系,适合语义关联和跨语言查询 | |
| 全文 | 基于关键词检索,适合专有名词、缩写词、ID等 | |
| 最大召回数量 | 数值 | 从检索结果中返回多少个内容片段给大模型使用 |
| 最小匹配度 | 数值 | 低于设定值的内容不会被返回(可过滤低相关度结果) |
| 查询改写 | 开启/关闭 | 在多轮对话中,根据对话历史对用户Query进行优化重构 |
| 结果重排 | 开启/关闭 | Embedding召回结果交由Rerank模型重新排序,将最相关文档排在前面 |
召回失败排查
- 检查知识库名称、描述是否与Query相匹配
- 检查提示词是否合理,是否明确表达了调用知识库的意图
- 如遇召回问题,可切换为自动调用模式提高召回效率
2.4 为智能体添加记忆
📝 待补充内容(需重新登录读取)
2.5 提升智能体对话体验
📝 待补充内容(需重新登录读取)
2.6 搭建智能体实践案例
📝 待补充内容(需重新登录读取)
2.7 三方智能体导入
📝 待补充内容(需重新登录读取)
第三章:开发工作流
3.1 搭建工作流
📝 待补充内容(需重新登录读取)
3.2 基础节点
📝 待补充内容(需重新登录读取)
3.3 业务逻辑节点
📝 待补充内容(需重新登录读取)
3.4 输入和输出节点
📝 待补充内容(需重新登录读取)
第四章:数据库节点
4.1 知识和数据节点
📝 待补充内容(需重新登录读取)
4.2 组件节点
📝 待补充内容(需重新登录读取)
第五章:资源
📝 待补充内容(需重新登录读取)
附录
文档清单(53篇)
| 序号 | 分类 | 文档名称 | 状态 |
|---|---|---|---|
| 1 | 平台概述 | 什么是灵珠平台 | ⏳ |
| 2 | 平台概述 | 平台架构 | ⏳ |
| 3 | 开发智能体 | 智能体基础设置 | ⏳ |
| 4 | 开发智能体 | 为智能体添加技能 | ⏳ |
| 5 | 开发智能体 | 为智能体添加知识 | ✅ |
| 6 | 开发智能体 | 为智能体添加记忆 | ⏳ |
| 7 | 开发智能体 | 提升智能体对话体验 | ⏳ |
| 8 | 开发智能体 | 搭建智能体实践案例 | ⏳ |
| 9 | 开发智能体 | 三方智能体导入 | ⏳ |
| 10 | 开发工作流 | 搭建工作流 | ⏳ |
| 11 | 开发工作流 | 基础节点 | ⏳ |
| 12 | 开发工作流 | 业务逻辑节点 | ⏳ |
| 13 | 开发工作流 | 输入和输出节点 | ⏳ |
| 14 | 数据库节点 | 知识和数据节点 | ⏳ |
| 15 | 数据库节点 | 组件节点 | ⏳ |
| ... | 资源 | (待填充) | ⏳ |
快速入门路径
- 了解平台 → 什么是灵珠平台 → 平台架构
- 创建智能体 → 智能体基础设置 → 为智能体添加技能 → 为智能体添加知识 → 为智能体添加记忆
- 进阶技能 → 提升智能体对话体验 → 搭建智能体实践案例
- 工作流开发 → 搭建工作流 → 基础节点 → 业务逻辑节点 → 输入和输出节点
- 数据集成 → 知识和数据节点 → 组件节点
📌 注意:手册中大量内容因 Yuque 登录 session 过期无法读取,状态为「⏳ 待补充」的内容需要重新登录文档中心后补充。