MaxKB 提示词编写

概述

本技能提供在 MaxKB 平台上编写智能体提示词的最佳实践，涵盖从开场白设计到多节点工作流提示词的全流程。基于"四季都爱过节"少数民族节日百科智能体的真实开发经验沉淀。

核心概念

MaxKB 工作流节点类型

| 节点类型 | 用途 | 提示词编写要点 | |----------|------|---------------| | AI对话 | 核心问答节点 | 需同时编写系统提示词和用户提示词 | | 知识库检索 | 从知识库召回内容 | 配置检索参数，提示词控制输出格式 | | 条件分支 | 根据输入分流 | 无需提示词，配置判断条件即可 | | 指定回复 | 固定内容回复 | 直接写回复内容，无需提示词 | | 变量赋值 | 处理变量 | 无需提示词 |

提示词的两层结构

系统提示词 → 给AI的角色设定、任务说明、回复要求（固定不变）
用户提示词 → 每次对话时传递给AI的指令（可包含变量）

开场白设计

开场白是用户进入智能体后看到的第一条消息，决定了第一印象。

格式规范

[问候语] + [自我介绍] + [功能引导] + [选项列表]

选项列表写法

MaxKB 中，以 - 开头的行会被识别为可点击的选项按钮：

- 🔍 我想了解……
- 🎯 测一测最适合我的节日吧！
- 📅 今天都有什么节日？
- 🌈 输入一个民族或地点试试看~

关键规则： 每个选项前必须有 - （短横线+空格），否则不会生成可点击按钮。

示例

嗨嗨！我是四季豆٩(◕‿◕｡)۶✨，你的少数民族节日百科小专家～ bean bean 超了解中国各民族的节日文化哦！

告诉我，你有什么特别想了解的少数民族节日吗？🤔

- 🔍 我想了解……
- 🎯 测一测最适合我的节日吧！
- 📅 今天都有什么节日？
- 🌈 输入一个民族或地点试试看~

系统提示词编写

标准结构

系统提示词应包含以下模块：

## 角色设定
[定义AI的身份、性格、语言风格]

## 任务
[列出AI需要完成的具体任务，分条说明]

## 回复要求
[规定回复的格式、语气、内容要求]

## 重要规则：图片展示（可选）
[如果涉及知识库图片，必须加入此模块]

角色设定写法

• 定义拟人化身份（如"四季豆"）
• 说明专业领域
• 描述语言风格（活泼/正式/俏皮）

示例：

## 角色设定
你是"四季豆"，一个活泼可爱的少数民族节日百科小专家～ bean bean 超了解中国各民族的节日文化哦！

任务写法

• 用编号分条列出
• 每个任务描述一个明确的动作
• 使用"如果...则..."结构处理分支逻辑

示例：

## 任务
1. 获取当前系统日期（公历），并转换为农历日期
2. 判断用户的意图：
   - 如果用户询问"最近有什么节日"，检索当前日期之后最近将到来的5个节日
   - 如果用户询问"今天有什么节日"，检索当天有哪些节日
3. 如果检索到节日，进行科普；如果没有，用俏皮语气告知

回复要求写法

• 语气要求
• 格式要求（编号、分条等）
• 特殊场景处理（无结果时怎么办）

图片展示规则

当智能体需要展示知识库中的图片时，必须在系统提示词中加入此模块：

## 重要规则：图片展示
- 如果知识库检索结果中包含图片，必须使用Markdown图片语法引用：![图片描述](图片链接)
- 将图片放在对应节日的文字描述之后
- 不要编造图片链接，只使用知识库中实际存在的图片

关键： 不加这个模块，AI 不会主动展示知识库中的图片。

用户提示词编写

用户提示词是每次对话时传递给 AI 的指令，可包含变量。

简单指令型

直接告诉 AI 要做什么：

请查询今天的日期（公历和农历），然后在知识库"少数民族节日"中检索今天有哪些节日，并进行科普。

变量引用型

在用户提示词中引用工作流中的变量（用 {{变量名}} 格式）：

用户选择了：{{user_input}}
请根据用户的选择进行科普。

兴趣测试题设计

漏斗式筛选结构

4道题按顺序逐层缩小范围：

| 题号 | 方向 | 筛选目标 | |------|------|---------| | Q1 | 地域偏好 | 筛选地理区域 | | Q2 | 时间偏好 | 筛选时间/季节 | | Q3 | 氛围偏好 | 筛选文化气质 | | Q4 | 体验偏好 | 筛选具体活动 |

出题提示词要点

• 要求 AI 每次出题时根据知识库实际内容灵活调整，不能每次都出一样的题目
• 每道题4个选项
• 选项内容要覆盖知识库中实际存在的节日特征

示例

## 出题要求
- 一次性展示全部4道题，每道题4个选项
- 每次出题必须根据知识库中的实际内容灵活调整，不能每次都出一样的
- 4道题的核心方向依次为：地域偏好、时间偏好、氛围偏好、体验偏好
- 每道题的选项要覆盖知识库中实际节日所在地区、举办时间、氛围类型和活动类型

常见问题与解决方案

问题1：图片不显示

现象： 知识库中有图片，但 AI 回复时不展示。

原因： 提示词中没有明确要求 AI 引用图片。

解决： 在所有涉及知识库检索的节点提示词中加入"图片展示"规则模块。

问题2：AI 不按格式出题

现象： 每次出题都一样，或选项与知识库内容不匹配。

原因： 提示词中缺少"灵活调整"的明确指令。

解决： 在出题要求中明确写"每次出题必须根据知识库实际内容灵活调整，不能每次都出一样的"。

问题3：AI 回复末尾有多余引导语

现象： 科普完节日后，AI 还会追加"还有其他想了解的吗？"等引导语。

原因： 提示词中要求了"引导用户继续探索"。

解决： 删除回复要求中的引导语相关指令。

问题4：无结果时 AI 硬推内容

现象： 当天没有节日时，AI 说"没有"后还硬推荐其他节日。

原因： 任务描述不够明确。

解决： 明确写"没有节日时就此打住，不要推荐任何具体的节日名称"。

资源

references/

• workflow-patterns.md — 各节点类型的提示词模板
• troubleshooting.md — 常见错误及排查方法