全面掌握Dify 1.0：初心者必學的AI應用快速入門指南

Author:

本篇文章聚焦全面掌握 Dify 1.0 的實戰要點，特別為初學者打造的快速入門指南。你將從雲端版著手：註冊與登入、熟悉工作區與模板、設定模型與 API 金鑰、選擇嵌入與知識庫的初步配置，以及建立第一個 Chat Assistant 的工作流程。文章同時比較雲端與本機社群版的差異，讓你在短時間內搭建可運作的 AI 應用，免去高深技術門檻即可上手。

這份內容的魅力在於真實的實作經驗。跟著 Uncle Kevin‌ 的步驟，你會發現成敗的關鍵在於流程的清晰與設定到位：先完成雲端設定、再穩固模型與 API 金鑰，接著選取預設系統模型與嵌入模型，並善用免費額度進行測試。文中也示範怎麼在 OpenAI、Voyage 等提供者間切換、為何選用 4O Mini 作為初期測試的平衡點，讓新手能穩定建立第一個對話機器人與基礎工作流程。

文章目錄

雲端版與本機社群版的選擇與安裝實務建議

就實務經驗而言，初心者最建議先從雲端版開始，因為上手快、介面與工作流程穩定且有預設模板與免費額度，能快速看到成效。雲端版的「Get Started」會導向 cloud.dify.ai，登入方式提供 Google 與 GitHub 兩種。首次登入通常是空白畫面，接著可以在工作區 (Workspace) 設定與儲存設定、使用「Explore」查看模板、或直接在工作區建立新的應用。若日後需要更多客製與自有資料，才再轉向本機的社群版，以避免雲端的使用限制。

版本 優點 缺點/限制 適用對象
雲端版 快速上手、模板與工作區整合、免費 credits、無需自建硬體 免費方案有工作流程數量限制、需依賴雲端資源、付費後才解鎖更多功能 初學者、想快速驗證概念、不想自行維護伺服器者
社群版（本機） 完全掌控、無 10 ⁢個工作流程上限、資料與隱私掌握在本機、可自訂整合 安裝與維護相對複雜、需自備運算資源、需要自行管理更新與安全性 需要長期部署、企業內部或高階用戶、偏好本機資料存取者

若要在雲端版進行設定，常見的工作流是先建立系統與模型設定，再逐步引入嵌入與檢索模組。你可以在「Settings」中設定「模型提供者」與各模型的授權金額與金鑰，像是 OpenAI 的模型通常會提供免費試用積分， Anthropic 的 ​Claude 適合程式編寫，但可能需要額外授權。若要長時間使用，建議先完成 API 金鑰的取得與驗證，並在「API 金鑰」頁面複製金鑰後貼回 Dify，確保儲存時金鑰會被驗證有效。為提高穩定性，還可以啟用“多模型比對(Debug with Multiple Models)”在同一問題上同時比較不同模型的回應。

在設定系統模型與知識庫時，建議的實務做法是：先把預設系統模型設好，讓後續設計工作流程時可以自動套用；若預算允許，選用 4O Mini 作為一般推理模型，因其成本低、速度快，適合測試與日常使用。嵌入（Embedding）與檢索（rerank）部分可先採用 OpenAI Embedding 3 Large 與 Voyage 的 Rerank 3（若可用）以提升準確度；語音部分可使用 Whisper 作為語音轉文字與文字轉語音的一環，並根據需要調整 TTS 模型的語言與分辨率。最後，若你選擇使用⁤ Voyage 作為嵌入與 Rerank 的提供者，需在 Voyage⁤ 註冊、取得 API Key，並把密鑰貼回 Dify 的對應欄位，金鑰驗證成功後就可啟用。

實務安裝與選擇的要點整理如下：

  • 雲端版適用情境：想快速體驗、探索模板、避免本機維護的人；遇到 10 個工作流程的限制時，再考慮升級或轉向社群版。
  • 社群版適用情境：需要長期部署、資料隱私與本機控制、無雲端工作量上限；安裝與運維需具備技術能力與資源。
  • 關鍵設定流程（雲端版/社群版共通概念）：取得 API 金鑰、設定系統模型、選擇 Embedding 與 Rerank 提供者、完成保存與驗證。
  • 常見步驟與技巧：使用 OpenAI 作為嵌入與文字生成基礎、若要更高精度可搭配 voyage‌ 3；設定開場對話與提示管理，以提升首次互動品質；測試時可使用 Debug 模式比較多模型回應。​
  • 時區與語言：介面與工作區語言可切換，時區建議設為 Taipei (+08:00)，以避免跨時區在知識庫查詢時出現混亂。

從工作區與模板到建立第一個對話機器人的快速實作攻略

快速上手的核心在於理解雲端版與本地社群版的差異、掌握工作區的角色，以及善用模板快速搭建對話機器人。以下以雲端版為例，提供一步到位的實作路徑與要點，讓你不踩坑、快速落地。

  • 雲端環境與登入：前往 cloud.dify.ai，使用 Google 或 GitHub 帳號登入，首次登入畫面為全新空白介面。
  • 工作區與模板：介面預設在工作區（Workspace），可在左側創建空白應用或從模板建立；Explore 區域主要放置範本，實際上與工作區的功能基本等同，先熟悉功能再選擇最佳起點。
  • 建立第一個應用：在左側選「Create Blank Application」後，選擇 Chat Assistant，或後續選擇其它類型；先理解Prompt 的設定與模型選擇，再進入對話流程設計。
  • 設定與測試風格：初次使用時，先完成模型與語言環境的基礎設定，之後再細部調整溝通風格、輸出格式與是否啟用多模型比對等高階功能。

為了快速實作，請特別留意以下實作要點：

  • 模型與金鑰設定：在 Settings ‌ 的 Model 區域安裝所需模型；OpenAI 會提供預設 Credits 進行測試，若要長期使用需自行購買 API credits。若要跨模型比較，可啟用 Debug with Multiple Models。
  • API 金鑰取得方式：在 OpenAI 官網點選 Create New Security Key，命名如​ Dify⁣ Demo Create，生成後務必複製並回到 Dify 貼上，保存後才會顯示綠色通過。
  • 系統與嵌入模型的選擇：先設定預設系統模型以利後續工作流自動選取；常見搭配為 4O Mini 作為快／低成本的系統推理模型，若需要推理能力再搭配專用模型；嵌入（Embedding）可選 OpenAI ⁤Large 以提升知識庫檢索精度。
設定項 建議選項
系統預設模型 4O‍ Mini（低成本、快、穩定）
嵌入模型 OpenAI Large
rerank 模型 voyage 3 /‍ 最高精度版本
語音轉文字 Whisper
文字轉語音 openai TTS（標準解像度或 HD 視需求而定）
API 提供者 OpenAI‌ + Voyage（若單一源不足可混用）

若你選用雲端版，還有一個重要限制：未支付情況下工作區可能有工作流程數量與資源的上限；若要無上限使用，建議選擇社群版自行在本機安裝，並熟悉本地資源管理與部署流程。其實作重點是「讓模型與知識來源能即時結合」，以便後續把對話機器人打造成能回應現場需求的工具。

模型供應商與嵌入重排的最佳搭配與設定要點

最佳搭配要點：在 Dify 1.0 的實戰中，建議以 OpenAI ⁣ 為主供應商，搭配 Voyage 作為嵌入與重排的核心；系統模型以 4O Mini 作為預設，能兼顧成本與表現。雲端版有 10 條工作流 的限制；社群版（Community Edition）則可在本機部署、沒有這項限制。開發時最關鍵的三點是：嵌入與重排的搭配、系統模型的預設策略，以及在雲端與本機之間的資源分配。根據實測，OpenAI 的 API 金鑰需注意用量與費用，Voyage ⁤提供的免費代幣與高階嵌入/重排通常能帶來顯著的準確度提升。我的經驗是，從這些設定入手，後續打造具體工作流程會更穩定。

  • 嵌入與重排的核心搭配：嵌入用 Voyage⁤ 3，重排用 Rerank 2，以提升知識庫檢索與排序的精准度。
  • 主供應商與成本考量：以 OpenAI 為主，並可透過 Debug⁣ with Multiple Models 比較另一模型的表現。
  • 系統模型的預設策略：預設為 4O Mini，在測試與日常使用間取得最平衡。
  • 語音與語言支援：需要語音轉文字( STT )與文字轉語音( TTS )時，結合 Whisper 等模型，並依場景選擇標準版或高清版。
  • 支付與授權實務：雲端若需要更多 Credits，需付費；社群版則可在本機使用、無 10 工作流限制。

設定要點與實務要訣包括：先在 OpenAI 取得 API 金鑰並貼回 Dify⁤ 的設定頁，建議點選「Create New Security Key」，命名為「Dify Demo Create」，複製金鑰後立即貼上並儲存。接著在系統設定中指定預設系統模型與嵌入/重排提供者，讓工作流程自動選用正確的模型；若要比較多個模型的回應，開啟 Debug with Multiple Models。嵌入選擇 Voyage 3、重排選擇 Rerank 2，可在知識庫問答與檢索場景中取得更佳精度；其他如‌ STT/TTS 亦可根據需要調整供應商與設定。

快速搭配表（要點一覽）：

組合類型 核心設定要點 優點與注意事項
嵌入/重排核心 嵌入: Voyage 3；重排: Rerank 2 高精度、需註冊 Voyage API Key
主供應商 OpenAI 為主；可搭配多模型對比 成本與穩定性平衡
系統模型 4O Mini ⁤作為預設 成本低、速度快，適合原型開發
語音/語言 whisper STT；TTS⁣ 以 ‌OpenAI 標準/HD 支援語音場景，需視需求選擇

個人經驗分享與風險提示：若以雲端開發，請留意免費 Credits 的上限與 10 條工作流的限制，必要時可考慮轉用社群版以避免此限制；在本機部署的社群版雖然不受這些限制，但需要自行維護環境與安全性。設定好預設模型與嵌入重排之後，日後的工作流設計就能更專注於任務內容與使用者場景，而非頻繁切換模型。若遇到不明白的按鈕或選項，回到影片中的實作步驟與嵌入模型的選擇，通常能快速找出最佳的搭配。

成本控制與效能優化的具體做法與風險提醒

在 Dify 1.0 的架構下，進行成本控制與效能優化時，需先清楚區分 雲端版 與 社群版 的成本與使用限制，並以實作層面的策略落實。雲端版雖提供便捷性，但有 10 條工作流程 ‌的上限，另外還有 空間、註解配額與檔案上傳限制；若選用 社群版，可自行在本地部署，無此上限，且多為免費。若長期使用雲端服務，需留意 API 金額與額度的消耗，並評估自建本地環境的成本與風險。據實測，OpenAI 額度在 200 則訊息就會快速耗盡，且部分高階模型需額外付費；而某些模型提供者的免費額度在註冊初期依然有限。

  • 成本結構清晰化：瞭解雲端上限與社群版自由度，避免因預設設定導致不必要的費用增長。
  • 逐步驗證與控管：先以免費或低成本的模型與嵌入，逐步放大到必要的規模，避免過早投入高成本方案。
  • 本地化部署的長遠考量：若以 社群版自行部署，需評估硬體與維運成本，但可避免雲端的流量與限額風險。

具體做法

為達成成本控制與效能優化，請優先在架構與模型選型上做出正確決策，並以實作細節落地：

  • 預設模型與嵌入模型的選擇：系統預設可設為 4O Mini，以成本與速度取得較佳平衡；嵌入方面選用 OpenAI Large 提高知識庫的準確度，或在需要更高精度時再切換至其他提供者的高階嵌入。若你需要更高辨識與排序精度，Voyage 的嵌入模型（如 ​ Voyage‍ 3）會是更穩健的選擇。
  • Rerank 與搜尋能力的取捨：OpenAI 不提供內建的 Rerank，此時建議使用 Voyage 的 Rerank，以提高知識庫檢索與排序的效果；若仍以 OpenAI 為主要 API，則暫時跳過此模組。
  • 成本控管的實務設定：若選用雲端，請設定好 付費方案與使用上限，並評估是否需要購買額度；使用社群版時，資源完全由本地機器承載，需自行監控資源使用。另建議在設定中啟用 ‍ 多模型比較​ (Debug with Multiple Models)，以選擇性價比最高的模型。
  • 語音與文本轉換的定位：語音轉文字可使用 Whisper，需注意實時性與檔案大小；文字轉語音可選 OpenAI 的 TTS⁢ 模型，若追求清晰度可選 HD 版本，否則以標準版即可。
  • 知識庫與知識來源：在​ 知識庫/資料來源區域，先以穩定的嵌入模型建立基礎，再逐步加入更多資料，避免一開始就把所有資料都嵌入導致成本暴增。
  • 實作流程與模板：建立最小可行的工作流程（如 Chat Assistant 或 Text Generation 類型），以模板化的方式快速複製與部署，降低重複性成本。
  • 金鑰與授權管理：在 Settings 中設定 API 金鑰，儘可能使用名為 Dify Demo Create 的金鑰並妥善儲存；若需要長期使用，依官方指引建立穩定的金鑰管控機制，避免金鑰外洩或流量異常。

為了讓使用更順手，以下是兩個常見的實作路徑：

  • 如果你打算快速上手，先建立 Chat Assistant，並設定 系統模型與問答流程；再逐步加入多模組比對與知識庫嵌入。
  • 若你具備本地部署能力，直接安裝 社群版，以避免雲端上限與長期費用，並以 Voyage 為嵌入/排序的首選組合提升效能與穩定性。

風險提醒與緩解策略

在追求成本控制與效能優化同時，需清晰評估與緩解以下風險：

  • 雲端成本與限額風險：雲端版雖方便，但受限於工作流程上限與配額，過度依賴會導致成本飆升與功能受限，建議以社群版或本地部署作為長期解決方案。
  • 模型與服務支援差異：不同提供者的 Rerank、嵌入與語音模組支援不全同，需以 Voyage 等解決方案補足，避免因缺乏某功能而影響工作流。
  • API 費用與用量管理：OpenAI 等 API 的費用易在高頻使用時快速累積，請設定使用上限、監控用量並規劃階段性升級路徑。
  • 資料隱私與安全：上傳知識庫與客戶資料前，評估是否需要本地化處理或加密，降低資料外洩風險與合規風險。
  • 穩定性與維運負擔：本地部署雖可降低雲端依賴，但需承擔自建環境的維護、硬體購置與軟體更新等長期成本與風險。
  • 品質與成本折衷：低成本模型可能在長篇對話或複雜任務上產出不穩定結果，需以分階段測試與模型調整來平衡成本與品質。

實務要點與快速參考

  • 建立 Basic conversation 的聊天助手後，先用穩定的 4O Mini 作為預設模型與設定，後續再逐步增添嵌入與排序功能。
  • 啟用 Debug⁣ with Multiple Models，在成本允許的情況下同時比較多個模型的回應，挑出性價比最高的組合。
  • 若要解析長文內容或多來源知識，先從較小的嵌入集開始，逐步擴充知識庫，避免一次性大量嵌入造成成本過高。
  • 在「API 金鑰」與第三方服務的設定上，遵循基本安全實務，並定期檢視金鑰使用紀錄與訪問控制。

從語音辨識到文字轉換再到語音輸出的落地實務與注意事項

要點如下：在 Dify 1.0‌ 的實作路徑中，三大環節的穩定性與成本管理最為關鍵。對於語音辨識（語音辨識），優先採用高準確性的模型並考慮上傳長音檔的處理效率；對於文字轉換，需留意輸出結構與下游管線的串接；對於語音輸出，選擇適當的音質與語調設定以符合場景需求，並善用標準版與 HD 版之間的取捨。實務上，若要在對話式任務中讓系統具備即時反應與語音回饋，建議建立「語音→文字→文字處理→語音回覆」的穩定工作流程。

  • 語音辨識（Speech-to-Text）：以 Whisper 為核心，適用於上傳音檔的轉寫；注意長錄音的分段與網路延遲，實作上以上傳檔案為主，避免倉促的實時 ⁣mic 錄製影響準確度。
  • 文字轉換（Text processing）：在將轉寫文字送入模型前，考慮是否需要以 JSON 或結構化格式輸出，方便下游工作流自動化處理與知識庫對應。
  • 語音輸出（Text-to-Speech）：針對對話輸出選用標準版或 HD 版；若內容需要自然度與語調差異，建議在必要時切換至高解析度版本；對於腳本轉語音，TTS 是最常見的落地場景。

在 Dify 1.0 的環境設定中，先把預設系統模型設好再進行工作流程設計。對於成本與速度的平衡，建議以 4O Mini 作為預設系統模型，因為它的價格友善、回應快速且表現尚可；如需進行推理或更複雜的任務，才再切換到更高階的模型。若要在知識庫與知識檢索層面提升準確度，則可搭配不同的 Embedding 與‌ Rerank 模型。

在實作過程中，關鍵的落地設定包括：先以 OpenAI 的模型作為起步，但要留意 API 授權與計費，雲端版在未付費情況下會有限制（如僅能建構多達 10 條工作流程、空間、註解與檔案上傳等配額），若要長期使用或無上限，建議使用 社群版自行安裝。本地安裝為開源版本，可避免雲端限額，且避免連線成本；若以雲端結構實作，請評估 API 金額與頻次，並透過 OpenAI 與 Voyage 等提供商搭配以取得最佳性價比。

步驟 建議設定 說明
模型提供商與 API 金鑰 OpenAI（創建 API 金鑰）、voyage（創建 API 金鑰） OpenAI 提供通用語言模型與 TTS；Voyage 提供 Embedding 與 Rerank。創建金鑰時務必複製並妥善保存，避免遺失。
預設系統模型 4O Mini（預設）、需要推理時再選擇更高階模型 4O ‍Mini 具成本效益與速度，適合作為初期測試的預設系統模型。
Embedding 與⁣ Rerank Embedding：Voyage 3 或 OpenAI Large；Rerank：Voyage 的高階版本 Embedding 提升語義相似度的準確性；Rerank 提高排序品質，OpenAI 目前不提供 Rerank。
語音辨識與語音輸出 語音辨識：Whisper；語音輸出：OpenAI TTS（標準版，必要時選 HD） Whisper 提供穩定的 STT；TTS 需根據場景選擇解析度與語調。
雲端 vs 社群版 雲端：限制較多但設定快速；社群版：免費、無工作流程數限制，需本機運行 依需求選擇；社群版適合長期開發與離線部署。

進階要點摘要：在知識庫與語境管理方面，若你要讓機器人能以多模組方式回應，需透過「Agent」與「Workflow」來串接資料源與外部工具，這樣就能實現例如網路查詢、上傳影像分析等功能。若要在現場教學中快速驗證，建議先以 Chat Assistant 設定基本對話角色，並逐步加入文字處理與知識庫對應的流程；再以語音轉寫與轉語音的實務操作驗證整體流暢度與回應時間。

常見問答

🧭 雲端版與社群版有何差異，該如何快速上手？

雲端版與社群版在入口、限制與成本上有明顯差異。雲端版讓你直接在 cloud.dify.ai 登入使用，預設在工作區裡，且有 10 條工作流程的上限與雲端資源限制，若要更高容量可以支付取得更多積分與功能；也可在設定中選擇訂閱雲端服務以提升使用上限。社群版則是開源、免費，需自行在本機安裝（如 Docker 或自行部署），不受雲端工作流程數的限制，適合想要在本地掌控資源的使用者。開始上手時，雲端版適合先熟悉介面與流程，之後再根據需求決定是否轉為本機部署。

🔑 如何在 ​Dify 1.0 中設定 OpenAI ⁤API 金鑰與管理成本？

在 settings 中輸入並保存 API Key，系統會驗證金鑰有效性。金鑰生成需到 OpenAI 網站「Create New security Key」，命名後直接複製金鑰貼回 Dify 再儲存。使用時，OpenAI 的訊息使用會有成本，測試期間的免費配額有限，諸如 200 條訊息通常很快用完，因此要長期使用就需要購買 API credits。除了 openai，還可以透過 Voyage 等提供者取得 Embedding/Rerank/其他模型的金鑰，並在系統設定中切換使用。

🤖 Chat‌ Assistant 與 Agent 的差異，以及如何快速建立基本的對話機器人？

Chat Assistant 主要提供一個預設的對話角色與提示，讓模型扮演特定角色進行對話；Agent 則是更智慧的代理，能呼叫工具（如網路搜尋、上傳圖片分析等），以完成更複雜任務。快速建立基本聊天機器人可依以下步驟：建立 Blank Application，選擇 Chat Assistant 並命名為 Basic Conversation；在左側設定提示、變數與情境，右上選擇模型並開始對話。可調整 Properties（如溫度約 0.7⁣ 以平衡創新與穩定性），若需要比對不同模型可啟用 debug with Multiple Models；也可設定開場對話與追問等 Management 功能。開啟 4O Mini 作為預設系統模型可在成本與效能間取得不錯的平衡。需要時也可設定語音轉文字/文字轉語音等語音相關功能，增強互動體驗。

結論

Dify 1.0 的核心價值在於把複雜的 AI 工具與流程整理成易於上手的雲端與社群版本，讓初心者也能快速建立實用的對話式 AI 應用。透過本段教學，你將取得以下關鍵資訊增益與實作要點，立即落地可用：

-​ 版本與定位差異：雲端版與社群版的功能與限制差異，雲端有 10 條工作流程等限制，而社群版可自由部署於本機，免除雲端計費與配額限制。
– 入口與介面結構：從 cloud.dify.ai 開始，使用 Google 登入，熟悉工作區（Workspace）、探索（Explore）與模板的工作方式，理解如何直接從工作區建立或匯入應用。
– 模型與供應商配置：在模型供應商區塊逐一安裝模型（如 OpenAI、Anthropic、Voyage），並理解免費額度、API 金鑰與授權流程；建立 ⁣API 金鑰、確認金鑰有效性，並理解不同模型的適用場景與成本差異。
– 系統模型與嵌入設定：設定預設系統模型以簡化工作流設計，選擇⁣ 4O Mini 作為低成本高效能的推理模型；嵌入模型可透過 Voyage 提升準確度（Embedding 3 Large 等級）。理解 Rerank、語音轉文字（STT）與語音轉文字的實際用途與限制。
– 多模型與工作流協同：可同時比較多個模型的回應、並以工作流逐步產出結果；了解如何把知識庫、資料來源與嵌入結合，支撐更精準的回答與檢索。
– 對話與代理人（Agent）的差異：Chat Assistant 主要設為角色與對話風格；Agent⁣ 能呼叫工具、執行網路搜尋或資料分析等外部任務，為高度自動化的工作流提供強大功能；Text Generation 則偏向資料輸出而非長對話。
– 資料與商業設定：雲端平台的支付選項、資料上傳與知識庫管理、語言與時區設定，以及如何在需要時選擇附加功能與提升 Credits 的方式。

為了讓你快速起手，本站也提供多條有用的資源與行動呼籲：
– 想更深度掌握實作，參與 Hahow 的募資課程，填寫問卷即可享受早鳥折扣：https://forms.gle/dXaeh9LUFUgAxEp78
– 成為本頻道會員，獲得專屬福利：https://www.youtube.com/channel/UClPN2rjY4im2LC9vG3Y8vkg/join
– 推薦共享帳號平台FlixSeek，透過邀請鏈結購買時輸入折扣碼「kevin」即可享有 95 折：https://www.flixseek.net/?code=pg-kt；影片說明與使用說明：https://youtu.be/bqRz1e1Ke2I
– 想要支援創作，請我喝杯咖啡補充創作能量：https://buymeacoffee.com/kevintsai
-‍ Dify 雲端版入口：https://cloud.dify.ai

結尾邀請你現在就動手：先到雲端設定好基礎的模型供應商與 API 金鑰，體驗 Chat assistant 的預設對話與開啟式話題；如果你偏好本機部署與自訂化，社群版的自由度也同樣強大且免費使用。掌握這些要素，你就能以最少的成本、最短的時間，設計出符合需求的 AI 導演級工作流與應用場景。

Categories: 人工智能, 初學者指南, 技術教程
Tags: , ,