1️⃣ Dify 崭新功能速览：先不说细节直接给你一较大堆噪声

嗨， 朋友们，今天我带你们一起“跑”一次 Dify 的最崭新版本更崭新。别急，我先把代码块塞进去，然后再缓慢缓慢拆解，一阵见血。。

docker compose version

看到没？这就是最基础的检查命令，别忘了。

1️⃣① 拉取源码

要么直接 clone 下面当前这个链接：

git clone https:///langgenius/cd dify

如果想指定版本， 用 tag 看看：

git checkout v1.9.1-fix1

注意：这里有一个较小误区，很更多人以为只要上传文档就能自动回答。实际情况是文档分段质量决定 RAG 效果，我算是看透了。。

1️⃣② 安装 Docker

安装命令：

curl -fsSL https:// | sudo bash
sudo apt install -y docker-compose-plugin

启动 Docker：

sudo systemctl enable docker && sudo systemctl start docker

2️⃣ 崭新增 Agent与 Workflow 的演化

Dify 最近正式开放 Agent Beta， 让模型能够自主规划步骤、调用工具。以前只能手写 Prompt， 当前能够在工作岗位流里加一个 “调用外部 API” 节点，就能实现自动查询订单、生成安抚话术等。

Workflow 的 UI 也做了细微优化：节点之间当前能够拖到任意位置，而不是只能按层级排列。

2️⃣① 怎样在 Workflow 中采用条件分支？

2️⃣② Workflow 节点示例代码片段

图啥呢？ HTTP 申请节点: URL = "{{APIBASEURL}}/query" Method = GET Headers = {"Authorization":"Bearer {{APIKEY}}"} Body = {"q":"{{userinput}}"}

text 如果返回状态码 != 200 则： 打印错误日志并跳转到 error 节点 " " " "，我懂了。

3️⃣ 知识库上传 & 检索崭新技巧

要我说... Dify 的知识库能力是核心卖点之一，但它对文档格式要求很较高。上传前记住先做以下处理：

• 拆分文件：各个章节不要较高于500行，否则向量检索会失效。
• 清除更多余空格和换行符，保持文本整洁。
• 给文件加上统一前缀， 举个例子 “faq_”，方便后期检索。
•  
•  

3️⃣① 文档分段提议

    **十分沉关键**：不要让同一篇文章出现两个彻底相同的标题，否则检索时会混淆。 **要**把全部标题统一成 H1 或 H2，只保留一次。

• - 分段较长度提议控制在 800 字以内；
• - 各个段落加一句摘要或关键词；
• - 对于外部链接，要保留原始 URL，以便追溯来源。

  注：上述全部示例均为演示之用，请勿直接照搬到生产周边环境中采用！否则有可能引起系统崩溃、 数据丢失或更严沉重的问题——比如你不较小心删掉了数据库表哦~ 😱😱😱 ---

  PS：如果你正在尝试部署 Dify 并且遇到了“页面打不开”或“API 服务异常”的问题，能够先检查容器状态： bash docker compose ps docker compose logs -f api # 查看 API 日志 docker compose logs -f web # 查看 Web 日志 然后根据日志信息逐步排查。 --- ## 🚀 较小结 - **Agent Beta** 已经上线， 支持更多模型、更多工具调用； - **Workflow UI** 更友良好，可拖拽任意位置； - **知识库上传** 要注意分段、清理格式和统一前缀； - **Docker Compose** 是最推荐部署方式，操作简洁但也要注意备份与日志查看； - **日志追踪** 是排查问题的十分沉关键手段，记住打开 `DEBUG` 模式。