我们将使用 Dify 平台,从零开始创建一个属于你的 AI 聊天机器人 —— 就像编程世界的 “Hello World” 一样简单,但又足够真实、可运行、可发布。

你将学会:
✅ 如何创建一个问答型聊天机器人
✅ 如何编写并优化 Prompt 提示词
✅ 如何设置对话逻辑与上下文
✅ 如何测试、调试并发布为 Web 嵌入组件

无需代码基础,只需 10 分钟,就能让 AI 替你回答问题!


一、准备工作

在开始前,请确保你已完成以下步骤:

  • ✅ 已部署 Dify(本地 Docker 或使用 Dify Cloud
  • ✅ 已登录 Dify 控制台
  • ✅ 已配置至少一个模型(如 OpenAI、通义千问等)

💡 推荐新手使用 Dify Cloud(SaaS 版),免部署,注册即用。


二、创建你的第一个聊天机器人

🧭 第一步:新建应用

  1. 登录 Dify 控制台
  2. 点击 “创建应用”
  3. 选择应用类型:👉 Chatbot(聊天机器人)
  4. 输入应用名称:例如 Hello World 助手
  5. 点击“创建”

🎉 恭喜!你的第一个 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 嵌入(最常用)

  1. 点击顶部菜单的 “发布”
  2. 选择 “Web App”
  3. 配置界面样式:
    • Logo(可选上传)
    • 主题颜色(如蓝色、红色)
    • 欢迎语:“你好,我是 HelloBot,有什么可以帮您?”
  4. 点击 “发布”

发布成功后,你会得到一个嵌入代码:

<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

  1. 进入“API 集成”页面
  2. 获取 API Key 和应用 ID
  3. 使用如下请求调用:
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)

  1. 创建一个知识库,上传 faq.txt 文件:
    Q: 你叫什么名字?
    A: 我叫 HelloBot。
    
    Q: 你是谁开发的?
    A: 是我主人用 Dify 创建的~
    
  2. 在 Prompt 中添加:
    参考以下知识库内容回答问题:
    
    <context>
    {{retrieved_content}}
    </context>
    

✅ 现在它就能准确回答特定问题了!


✅ 改造成 Agent(让它能做事)

启用 Agent 模式,并添加一个“工具”:

  • 工具名称:获取当前时间
  • 描述:“用于查询当前时间”

然后问它:“现在几点了?”——它会自动调用 API 并返回真实时间!


✅ 总结:你刚刚完成了什么?

通过本文,你已经成功:

  • 🛠️ 创建了一个基于 Dify 的聊天机器人
  • ✍️ 编写了有效的 Prompt 提示词
  • 🔁 测试并优化了对话逻辑
  • 🌐 将其发布为 Web 嵌入组件或 API 服务

这不仅是“Hello World”,更是你迈向 AI 原生应用开发 的第一步!

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐