如何使用 Dify：快速構建 AI 應用程式和代理的實用指南
如果您曾經希望可以構建一個可供生產環境使用的 AI 聊天機器人、一個檢索增強型 QA 系統或一個自動化代理，而無需處理複雜的程式碼，那麼 Dify 就是為您而生的。它將可視化工作流程構建器、提示管理、RAG（檢索增強生成）和工具整合到一個簡化的平台中。在本以解決方案為導向的實用指南中，您將準確地了解如何使用 Dify，從首次登入到部署完善的 AI 應用程式。
值得注意的是：Dify 將自己定位為領先的代理式 AI 開發平台，具有拖放式工作流程和應用程式範本，可顯著加快實現價值的時間。如果您喜歡動手操作的演練，那麼有一些可靠的初學者友善型教學課程，展示了聊天應用程式和資料集支援的助手的端到端構建，以及社群策劃的指南，以掌握 HTTP 節點和 JSON 處理等核心模組。對於結構化的演示專案體驗，還提供逐步教學課程。
在本指南中，我們將涵蓋：
- 構建您的第一個應用程式（聊天機器人和 RAG 助手）
我們還將融入實用技巧、常見陷阱和節省時間的模式，以便您可以更有信心地更快地交付。
什麼是 Dify 以及為什麼要使用它？
Dify 是一個低程式碼/無程式碼平台，用於通過可視化畫布組合 AI 應用程式，具有內建的提示編排、狀態處理、RAG 和代理功能。它顯著減少了基礎工作，並可以幫助您：
- 整合工具（網路搜尋、API、資料庫），而無需自定義膠水程式碼
Dify 的可視化工作流程和應用程式範本使其對於需要快速原型設計並發展到生產環境的團隊特別有吸引力。第三方教學課程和演示可以幫助您快速從零開始到運作中的應用程式，並且它通常用於具有資料檢索的代理模式。當您準備好評估和擴展時，還可以使用可觀察性整合。
快速入門：帳戶、模型和金鑰
- 選擇雲端（最快），或者如果您需要完全控制，請稍後準備自行託管。
- 在「設定」中，連接到您喜歡的 LLM（例如，OpenAI、Anthropic 等）。
- 安全地新增 API 金鑰。使用小提示進行測試以確認連線。
- 建立一個新的應用程式或工作流程。清楚地命名它（例如，「客戶支援 RAG」或「潛在客戶資格認定代理」）。
- 決定您的第一個可交付成果：聊天應用程式、內部工具或代理。
提示：從基準模型開始以進行快速迭代，然後稍後換入進階模型。
在幾分鐘內構建您的第一個聊天應用程式
以下是一種構建有用的聊天助手的簡單方法。
- 在應用程式庫中，選擇一個「聊天」範本。這提供了開箱即用的訊息傳遞基礎。
- 定義角色、語氣、界限和輸出格式。範例：
「您是一位簡潔、友善的產品助理。始終引用來源，使用項目符號列出步驟，如果使用者的請求含糊不清，請提出一個澄清問題。」
從做中學是最快的，影片演練可以幫助您視覺化每次點擊。
將其變成 RAG 助手（知識感知聊天）
RAG 讓您的助手可以使用您的私人文件、常見問題解答或 Wiki 內容來回答。
- 上傳 PDF、markdown 或連接到資料來源。
- 選擇嵌入模型和分塊大小。較大的區塊保留上下文；較小的區塊提高了粒度。從 400–800 個權杖開始。
- 選擇前 k 個結果（例如，4–8）、相關性閾值和可選的重新排名。
- 新增篩選器（例如，按標籤或文件類型）以提高精確度。
- 使用工作流程畫布或應用程式的 RAG 切換來將檢索到的上下文注入到提示中。在最終答案範本中包括引文。
如果您使用像 Milvus 這樣的向量資料庫，那麼有整合 Dify 以建立穩健的 RAG 管道的逐步演練。
可視化工作流程：自動化多步驟邏輯
Dify 的畫布讓您可以鏈接步驟、分支邏輯和呼叫工具。
常見模組：
- HTTP 節點：呼叫外部 API（搜尋、CRM、內部服務）。
範例：網路研究助手
- 偵測意圖 → 如果「研究」，則呼叫 HTTP 節點進行搜尋 → 使用 LLM 總結結果 → 返回帶有來源的項目符號調查結果。
有關如何連接 HTTP 節點和解析 JSON 回應的具體方法，社群教學課程很有幫助。
代理：使用工具的多步驟推理
Dify 中的代理結合了規劃、工具選擇和迭代推理來完成目標。
何時使用代理：
- 任務需要多步驟計畫（「研究 → 比較 → 總結」）。
- 助手必須呼叫工具：網路搜尋、資料庫、計算器、內部 API。
建立一個代理：
如果您的用例需要準確的網路資料檢索，您可以將 Dify 與專門的資料外掛程式配對，以增強代理功能。
連接器和工具：引入您的堆疊
Dify 通過連接器和 HTTP 節點與外部服務整合：
- CRM 和幫助服務台（例如，Salesforce、Zendesk）
最佳實踐：
Dify 中的提示工程
使提示模組化且可測試：
- 使用變數來表示使用者輸入、檢索到的上下文和工具輸出。
- 使用 JSON 或項目符號列表標準化輸出格式，以便進行下游解析。
- 提供逐步評分標準（例如，「以編號步驟思考」）以減少錯誤。
迭代迴圈：
可觀察性、測試和最佳化
當您從原型轉為試驗時，可觀察性和追蹤非常重要。您可以新增追蹤以查看權杖使用量、延遲和逐步決策，以偵錯和提高品質。
啟動前的主要檢查：
部署到使用者
Dify 支援多個部署路徑：
營運技巧：
團隊協作和治理
隨著您的應用程式增長：
接下來嘗試的進階模式
- 使用嚴格的 JSON 架構進行函數呼叫以產生結構化輸出
- 混合搜尋 (BM25 + 嵌入) 以獲得更好的召回率
疑難排解：常見陷阱和修復
- 調整分塊、新增元資料篩選器、嘗試重新排名、調整前 k 個。
- 加強系統約束、始終引用來源、首選 RAG 和驗證步驟。
順便說一句：加速內容工作流程
如果您的目標是內容構思、草擬和研究綜合，值得注意的是，使用 Dify 構建的助手可以與 Sider.AI 等生產力工具很好地搭配使用，以進行日常寫作和總結。Sider 可以與您的瀏覽器並排運行，以幫助您快速草擬、翻譯和分析內容；當與 Dify 驅動的 RAG 後端結合使用時，您可以獲得準確的領域上下文和流暢的編寫體驗 (https://sider.ai/)。 主要要點
- 代理功能強大，但防護措施和預算可確保它們的可靠性。
其他資源
- 用於構建 AI 應用程式的初學者友善型影片教學課程。
常見問題
Q1：Dify 用於做什麼？
Dify 是一個使用可視化工作流程、提示編排和 RAG 構建 AI 應用程式和代理的平台。它可以幫助團隊快速建立聊天機器人、知識助手和自動化。
Q2：如何在 Dify 中建立 RAG 聊天機器人？
建立一個資料集，配置嵌入和檢索，然後通過工作流程將檢索到的上下文注入到您的提示中。測試前 k 個、區塊大小和重新排名以優化準確性。
Q3：Dify 可以連接到我的 API 和工具嗎？
可以。使用 HTTP 節點和連接器來呼叫網路服務、資料庫和搜尋 API。將回應保留在 JSON 中，並定義明確的工具描述，以便代理正確使用它們。
Q4：如何阻止我的代理迴圈？
減少最大步驟、新增終止條件並收緊工具指示。可觀察性和追蹤有助於識別迴圈發生的位置，以便您可以調整提示和工具邏輯。
Q5：評估我的 Dify 工作流程的最佳方法是什麼？
建立一個測試集，執行批量評估，並檢查追蹤以了解延遲和成本。追蹤幻覺，強制執行結構化輸出，並使用範例迭代提示。
