五:创建你的第一个 AI 应用:Hello World 聊天机器人(Dify 零基础入门)
🛠️ 创建了一个基于 Dify 的聊天机器人✍️ 编写了有效的 Prompt 提示词🔁 测试并优化了对话逻辑🌐 将其发布为 Web 嵌入组件或 API 服务这不仅是“Hello World”,更是你迈向AI 原生应用开发的第一步!
我们将使用 Dify 平台,从零开始创建一个属于你的 AI 聊天机器人 —— 就像编程世界的 “Hello World” 一样简单,但又足够真实、可运行、可发布。
你将学会:
✅ 如何创建一个问答型聊天机器人
✅ 如何编写并优化 Prompt 提示词
✅ 如何设置对话逻辑与上下文
✅ 如何测试、调试并发布为 Web 嵌入组件
无需代码基础,只需 10 分钟,就能让 AI 替你回答问题!
一、准备工作
在开始前,请确保你已完成以下步骤:
- ✅ 已部署 Dify(本地 Docker 或使用 Dify Cloud)
- ✅ 已登录 Dify 控制台
- ✅ 已配置至少一个模型(如 OpenAI、通义千问等)
💡 推荐新手使用 Dify Cloud(SaaS 版),免部署,注册即用。
二、创建你的第一个聊天机器人
🧭 第一步:新建应用
- 登录 Dify 控制台
- 点击 “创建应用”
- 选择应用类型:👉 Chatbot(聊天机器人)
- 输入应用名称:例如
Hello World 助手
- 点击“创建”
🎉 恭喜!你的第一个 AI 应用已诞生!
三、配置 Prompt 提示词(让机器人“有性格”)
Prompt 是 AI 的“大脑指令”。我们需要告诉它:“你是谁”、“你要做什么”、“怎么回答问题”。
🔧 编辑系统提示词(System Prompt)
在“Prompt 编排”页面,找到 “系统提示词” 区域,输入以下内容:
你是一个友好、简洁的 AI 助手,名叫 HelloBot。
你的任务是帮助用户解答关于本应用的基本问题。
请用中文回复,语气亲切,每条回答控制在 50 字以内。
如果不知道答案,可以说:“这个问题我还不清楚呢~”
✅ 这段提示词定义了机器人的:
- 角色(AI 助手)
- 名字(HelloBot)
- 回答风格(简洁、友好)
- 安全兜底(未知问题不瞎编)
📥 添加用户输入变量(可选)
如果你想让机器人个性化回应,可以添加变量。
例如,在提示词中加入:
欢迎 {{user_name}} 来到 Hello World 助手!有什么我可以帮你的吗?
然后在前端调用时传入 user_name
参数即可实现个性化问候。
四、调整对话逻辑与上下文
Dify 默认已启用多轮对话支持,但我们还需要做一些微调。
⚙️ 配置对话设置
选项 | 推荐设置 | 说明 |
---|---|---|
对话历史长度 | 保留最近 5 轮 | 防止上下文过长导致性能下降 |
上下文窗口大小 | 自动(默认) | Dify 会根据模型自动截断 |
启用敏感词过滤 | ✅ 开启 | 防止不当内容输出 |
💡 小技巧:可以在“调试”模式下查看实际传给 LLM 的上下文内容,确保没有泄露敏感信息。
五、测试与调试机器人
▶️ 进入“调试”模式
点击右上角的 “调试” 按钮,进入实时交互界面。
你可以尝试输入以下问题:
- “你好呀”
- “你是谁?”
- “你会写诗吗?”
- “今天天气怎么样?”
观察 AI 的回复是否符合预期。
🐞 常见问题与优化建议
问题 | 原因 | 解决方案 |
---|---|---|
回答太长 | temperature 太高或 Prompt 不够约束 | 降低 temperature(建议 0.7) |
不记得上下文 | 历史未正确传递 | 检查“对话历史”是否开启 |
回答偏离主题 | Prompt 缺乏引导 | 加强角色设定和输出限制 |
✅ 提示:每次修改 Prompt 后都要重新测试,直到满意为止。
六、发布你的 AI 应用
现在你的机器人已经准备好了,接下来让它“走出去”!
📲 发布方式一:Web 嵌入(最常用)
- 点击顶部菜单的 “发布”
- 选择 “Web App”
- 配置界面样式:
- Logo(可选上传)
- 主题颜色(如蓝色、红色)
- 欢迎语:“你好,我是 HelloBot,有什么可以帮您?”
- 点击 “发布”
发布成功后,你会得到一个嵌入代码:
<script src="https://cloud.dify.ai/embed.js?app=xxxxx"></script>
🧩 嵌入到网页中
将上述代码粘贴到你的网站 HTML 中,例如:
<!DOCTYPE html>
<html>
<head>
<title>我的网站</title>
</head>
<body>
<h1>欢迎访问我的主页</h1>
<p>右边是我用 Dify 创建的 AI 助手:</p>
<!-- Dify 聊天机器人嵌入 -->
<script src="https://cloud.dify.ai/embed.js?app=xxxxx"></script>
</body>
</html>
保存后打开网页,你会看到一个漂浮的聊天窗口自动加载!
🌐 发布方式二:API 接口(供程序调用)
如果你希望在 App、小程序或后端服务中调用这个机器人,可以选择发布为 API。
- 进入“API 集成”页面
- 获取 API Key 和应用 ID
- 使用如下请求调用:
curl -X POST https://api.dify.ai/v1/chat-messages \
-H "Authorization: Bearer {API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"inputs": {},
"query": "你好,你会做什么?",
"response_mode": "blocking"
}'
🔁
response_mode
可选:
blocking
:同步返回结果streaming
:流式输出(适合网页实时显示)
七、进阶建议:让它更聪明一点
完成基础版后,你可以继续升级你的机器人:
✅ 加个知识库(RAG)
- 创建一个知识库,上传
faq.txt
文件:Q: 你叫什么名字? A: 我叫 HelloBot。 Q: 你是谁开发的? A: 是我主人用 Dify 创建的~
- 在 Prompt 中添加:
参考以下知识库内容回答问题: <context> {{retrieved_content}} </context>
✅ 现在它就能准确回答特定问题了!
✅ 改造成 Agent(让它能做事)
启用 Agent 模式,并添加一个“工具”:
- 工具名称:获取当前时间
- 描述:“用于查询当前时间”
然后问它:“现在几点了?”——它会自动调用 API 并返回真实时间!
✅ 总结:你刚刚完成了什么?
通过本文,你已经成功:
- 🛠️ 创建了一个基于 Dify 的聊天机器人
- ✍️ 编写了有效的 Prompt 提示词
- 🔁 测试并优化了对话逻辑
- 🌐 将其发布为 Web 嵌入组件或 API 服务
这不仅是“Hello World”,更是你迈向 AI 原生应用开发 的第一步!
更多推荐
所有评论(0)