1、發(fā)布為公開 Web 站點(diǎn)

使用 Dify 創(chuàng)建 AI 應(yīng)用的一個(gè)好處在于，你可以在幾分鐘內(nèi)就發(fā)布一個(gè)可供用戶使用的 Web 應(yīng)用，該應(yīng)用將根據(jù)你的 Prompt 編排工作。
如果你使用的是自部署的開源版，該應(yīng)用將運(yùn)行在你的服務(wù)器上
如果你使用的是云服務(wù)，該應(yīng)用將托管至 Udify.app

1.1、發(fā)布 AI 站點(diǎn)

在應(yīng)用概覽頁中，你可以找到關(guān)于AI 站點(diǎn)（WebApp）的卡片。只需開啟 WebApp 的訪問，就可以得到一個(gè)可分享可分享給用戶的鏈接了。

我們對(duì)以下兩種應(yīng)用均提供了一個(gè)漂亮的 WebApp 界面：
文本生成型（前往預(yù)覽）
對(duì)話型（前往預(yù)覽）

1.2、設(shè)置你的 AI 站點(diǎn)

點(diǎn)擊 WebApp 卡片上的設(shè)置按鈕，可以為 AI 站點(diǎn)配置一些選項(xiàng)。它們都會(huì)被最終用戶所見：
圖標(biāo)
名稱
應(yīng)用描述
界面語言
版權(quán)信息
隱私政策鏈接

1.3、嵌入你的 AI 站點(diǎn)

Dify 支持將你的 AI 應(yīng)用嵌入到你的業(yè)務(wù)網(wǎng)站中，你可以使用該能力在幾分鐘內(nèi)制作具有業(yè)務(wù)數(shù)據(jù)的官網(wǎng) AI 客服、業(yè)務(wù)知識(shí)問答等應(yīng)用。點(diǎn)擊 WebApp 卡片上的嵌入按鈕，復(fù)制嵌入代碼，粘貼到你網(wǎng)站的目標(biāo)位置。
iframe 標(biāo)簽方式
將 iframe 代碼復(fù)制到你網(wǎng)站用于顯示 AI 應(yīng)用的標(biāo)簽中，如

例如，將 script 代碼粘貼到官網(wǎng)的 處，你將得到一個(gè)官網(wǎng) AI 機(jī)器人：

1.0、Web 應(yīng)用的設(shè)置

Web 應(yīng)用是給應(yīng)用使用者用的。應(yīng)用開發(fā)者在 Dify 創(chuàng)建一個(gè)應(yīng)用，就會(huì)獲得一個(gè)對(duì)應(yīng)的 Web 應(yīng)用。Web 應(yīng)用的使用者無需登陸，即可使用。Web 應(yīng)用已適配不同尺寸的設(shè)備：PC，平板和手機(jī)。
Web 應(yīng)用的內(nèi)容和應(yīng)用發(fā)布的配置一致。當(dāng)修改了應(yīng)用的配置，并在應(yīng)用的提示詞編排頁點(diǎn) “發(fā)布” 按鈕發(fā)布后，Web 應(yīng)用的內(nèi)容也會(huì)根據(jù)當(dāng)前應(yīng)用的配置做更新。
我們可以在應(yīng)用概覽頁開啟和關(guān)閉對(duì) Web 應(yīng)用的訪問，以及修改 Web 應(yīng)用的站點(diǎn)信息：
圖標(biāo)
名稱
應(yīng)用描述
界面語言
版權(quán)信息
隱私政策鏈接
Web 應(yīng)用的功能表現(xiàn)取決于開發(fā)者在編排應(yīng)用時(shí)是否開啟該功能，例如：
對(duì)話開場白
對(duì)話前填寫的變量
下一步問題建議
語音轉(zhuǎn)文字
引用和歸屬
更多類似的答案（文本型應(yīng)用）
…
在下面的章節(jié)，我們會(huì)分別介紹 Web 應(yīng)用的兩種類型：
文本生成型
對(duì)話型

2、文本生成型應(yīng)用

文本生成類應(yīng)用是一種根據(jù)用戶提供的提示，自動(dòng)生成高質(zhì)量文本的應(yīng)用。它可以生成各種類型的文本，例如文章摘要、翻譯等。
文本生成型應(yīng)用支持如下功能：
運(yùn)行一次。
批量運(yùn)行。
保存運(yùn)行結(jié)果。
生成更多類似結(jié)果。
下面我們分別來介紹。

2.1、運(yùn)行一次

輸入查詢內(nèi)容，點(diǎn)擊運(yùn)行按鈕，右側(cè)會(huì)生成結(jié)果，如下圖所示：

在生成的結(jié)果部分，點(diǎn) “復(fù)制” 按鈕可以將內(nèi)容復(fù)制到剪貼板。點(diǎn) “保存” 按鈕可以保存內(nèi)容?？梢栽?“已保存” 選項(xiàng)卡中看到保存過的內(nèi)容。也可以對(duì)生成的內(nèi)容點(diǎn) “贊” 和 “踩”。

2.2、批量運(yùn)行

有時(shí)，我們需要運(yùn)行一個(gè)應(yīng)用很多次。比如：有個(gè) Web 應(yīng)用可以根據(jù)主題來生成文章?，F(xiàn)在要生成 100 篇不同主題的文章。那么這個(gè)任務(wù)要做 100 次，很麻煩。而且，必須等一個(gè)任務(wù)完成才能開始下一個(gè)任務(wù)。
上面的場景，用批量運(yùn)行功能，操作便利(把主題錄入一個(gè) csv 文件，只需執(zhí)行一次)，也節(jié)約了生成的時(shí)間(多個(gè)任務(wù)同時(shí)運(yùn)行)。使用方式如下：

第 1 步 進(jìn)入批量運(yùn)行頁面

點(diǎn)擊 “批量運(yùn)行” 選項(xiàng)卡，則會(huì)進(jìn)入批量運(yùn)行頁面。

第 2 步 下載模版并填寫內(nèi)容

第 3 步 上傳文件并運(yùn)行

如果需要導(dǎo)出生成的內(nèi)容，可以點(diǎn)右上角的下載 “按鈕” 來導(dǎo)出為 csv 文件。
注意: 上傳的的 csv 文件的編碼必須是 Unicode 的編碼。否則會(huì)運(yùn)行結(jié)果失敗。解決方案：用 Excel，WPS 等導(dǎo)出為 csv 文件時(shí)，編碼選擇 Unicode。

2.3、保存運(yùn)行結(jié)果

點(diǎn)擊生成結(jié)果下面的 “保存” 按鈕，可以保存運(yùn)行結(jié)果。在 “已保存” 選項(xiàng)卡中，可以看到所有已保存的內(nèi)容。

2.4、生成更多類似結(jié)果

如果在應(yīng)用編排時(shí)開啟了 “更多類似” 的功能。在 Web 應(yīng)用中可以點(diǎn)擊 “更多類似” 的按鈕來生成和當(dāng)前結(jié)果相似的內(nèi)容。如下圖所示：

3、對(duì)話型應(yīng)用

對(duì)話型應(yīng)用采用一問一答模式與用戶持續(xù)對(duì)話。對(duì)話型應(yīng)用支持以下能力（請(qǐng)確認(rèn)應(yīng)用編排時(shí)有開啟以下功能）：
對(duì)話前填寫的變量。
對(duì)話的創(chuàng)建、置頂、刪除。
對(duì)話開場白。
下一步問題建議。
語音轉(zhuǎn)文字。
引用和歸屬

3.1、對(duì)話前填寫的變量

如你在應(yīng)用編排時(shí)有設(shè)置變量的填寫要求，則在對(duì)話前需要按提示填寫信息才可進(jìn)入對(duì)話窗口：

填寫必要內(nèi)容，點(diǎn)擊 “開始對(duì)話” 按鈕，開始聊天。

移動(dòng)到 AI 的回答上，可以復(fù)制會(huì)話內(nèi)容，給回答 “贊” 和 “踩”。

3.2、對(duì)話的創(chuàng)建、置頂和刪除

點(diǎn)擊 “新對(duì)話” 按鈕開始一個(gè)新的對(duì)話。移動(dòng)到一個(gè)會(huì)話上，可以對(duì)會(huì)話進(jìn)行 “置頂” 和 “刪除” 操作。

3.3、對(duì)話開場白

若在應(yīng)用編排時(shí)開啟了「對(duì)話開場白」功能，則在創(chuàng)建一個(gè)新對(duì)話時(shí) AI 應(yīng)用會(huì)自動(dòng)發(fā)起第一句對(duì)話：

3.4、下一步問題建議

若在應(yīng)用編排時(shí)開啟了「下一步問題建議」功能，則在對(duì)話后系統(tǒng)自動(dòng)生成 3 個(gè)相關(guān)問題建議：

3.5、語音轉(zhuǎn)文字

若在應(yīng)用編排時(shí)開啟了「語音轉(zhuǎn)文字」功能，則在 Web 應(yīng)用端的輸入框看到語音輸入的圖標(biāo)，點(diǎn)擊圖標(biāo)即可語音輸入轉(zhuǎn)成文字：
請(qǐng)注意確保你使用的設(shè)備環(huán)境已經(jīng)授權(quán)使用麥克風(fēng)。

3.6、引用和歸屬

若在應(yīng)用編排時(shí)開啟了「引用和歸屬」功能，則對(duì)話返回時(shí)，會(huì)自動(dòng)展示引用的數(shù)據(jù)集文檔來源。

4、基于 APIs 開發(fā)

Dify 基于“后端即服務(wù)”理念為所有應(yīng)用提供了 API，為 AI 應(yīng)用開發(fā)者帶來了諸多便利。通過這一理念，開發(fā)者可以直接在前端應(yīng)用中獲取大型語言模型的強(qiáng)大能力，而無需關(guān)注復(fù)雜的后端架構(gòu)和部署過程。

4.1、使用 Dify API 的好處

讓前端應(yīng)用直接安全地調(diào)用 LLM 能力，省去后端服務(wù)的開發(fā)過程
在可視化的界面中設(shè)計(jì)應(yīng)用，并在所有客戶端中實(shí)時(shí)生效
對(duì) LLM 供應(yīng)商的基礎(chǔ)能力進(jìn)行了良好封裝
隨時(shí)切換 LLM 供應(yīng)商，并對(duì) LLM 的密鑰進(jìn)行集中管理
在可視化的界面中運(yùn)營你的應(yīng)用，例如分析日志、標(biāo)注及觀察用戶活躍
持續(xù)為應(yīng)用提供更多工具能力、插件能力和數(shù)據(jù)集

4.2、如何使用

選擇一個(gè)應(yīng)用，在應(yīng)用（Apps）左側(cè)導(dǎo)航中可以找到訪問 API（API Access）。在該頁面中你可以查看 Dify 提供的 API 文檔，并管理可訪問 API 的憑據(jù)。

例如你是一個(gè)咨詢公司的開發(fā)部分，你可以基于公司的私有數(shù)據(jù)庫提供 AI 能力給終端用戶或開發(fā)者，但開發(fā)者無法掌握你的數(shù)據(jù)和 AI 邏輯設(shè)計(jì)，從而使得服務(wù)可以安全、可持續(xù)的交付并滿足商業(yè)目的。
在最佳實(shí)踐中，API 密鑰應(yīng)通過后端調(diào)用，而不是直接以明文暴露在前端代碼或請(qǐng)求中，這樣可以防止你的應(yīng)用被濫用或攻擊。

你可以為一個(gè)應(yīng)用創(chuàng)建多個(gè)訪問憑據(jù)，以實(shí)現(xiàn)交付給不同的用戶或開發(fā)者。這意味著 API 的使用者雖然使用了應(yīng)用開發(fā)者提供的 AI 能力，但背后的 Promp 工程、數(shù)據(jù)集和工具能力是經(jīng)封裝的。

4.3、文本生成型應(yīng)用

可用于生成高質(zhì)量文本的應(yīng)用，例如生成文章、摘要、翻譯等，通過調(diào)用 completion-messages 接口，發(fā)送用戶輸入得到生成文本結(jié)果。用于生成文本的模型參數(shù)和提示詞模版取決于開發(fā)者在 Dify 提示詞編排頁的設(shè)置。
你可以在應(yīng)用 -> 訪問 API 中找到該應(yīng)用的 API 文檔與范例請(qǐng)求。
例如，創(chuàng)建文本補(bǔ)全信息的 API 的調(diào)用示例：

curl --location --request POST 'https://api.dify.ai/v1/completion-messages' \
--header 'Authorization: Bearer ENTER-YOUR-SECRET-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{"inputs": {},"response_mode": "streaming","user": "abc-123"
}'

4.4、對(duì)話型應(yīng)用

可用于大部分場景的對(duì)話型應(yīng)用，采用一問一答模式與用戶持續(xù)對(duì)話。要開始一個(gè)對(duì)話請(qǐng)調(diào)用 chat-messages 接口，通過繼續(xù)傳入返回的 conversation_id 可持續(xù)保持該會(huì)話。
你可以在應(yīng)用 -> 訪問 API 中找到該應(yīng)用的 API 文檔與范例請(qǐng)求。
例如，發(fā)送對(duì)話信息的 API的調(diào)用示例：

curl --location --request POST 'https://api.dify.ai/v1/chat-messages' \
--header 'Authorization: Bearer ENTER-YOUR-SECRET-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{"inputs": {},"query": "eh","response_mode": "streaming","conversation_id": "1c7e55fb-1ba2-4e10-81b5-30addcea2276""user": "abc-123"
}'

5、基于前端組件再開發(fā)

如果開發(fā)者是從頭開發(fā)新產(chǎn)品或者在產(chǎn)品原型設(shè)計(jì)階段，你可以使用 Dify 快速發(fā)布 AI 站點(diǎn)。與此同時(shí)，Dify 希望開發(fā)者能夠充分自由的創(chuàng)造不同形式的前端應(yīng)用，為此我們提供了：

• SDK，用于在各種語言中快速接入 Dify API
• WebApp Template，每種類型應(yīng)用的 WebApp 開發(fā)腳手架

WebApp Template 是基于 MIT 協(xié)議開源的，你可以充分自由的修改并部署他們，以實(shí)現(xiàn) Dify 的所有能力?；蛘咦鳛槟銓?shí)現(xiàn)自己 App 的一份參考代碼。
你可以在 GitHub 中找到這些 Template：

• 對(duì)話型應(yīng)用
• 文本生成型應(yīng)用

使用 WebApp 模版最快的方法就是在 GitHub 中點(diǎn)擊「使用這個(gè)模版」，它相當(dāng)于 Fork 了一個(gè)新的倉庫。隨后你需要配置 Dify 的 App ID 和 API Key，類似這樣：

export const APP_ID = ''
export const API_KEY = ''

More config in config/index.ts:

export const APP_INFO: AppInfo = {"title": 'Chat APP',"description": '',"copyright": '',"privacy_policy": '',"default_language": 'zh-Hans'
}export const isShowPrompt = true
export const promptTemplate = ''

每一種 WebApp 模版都提供了 README 文件，內(nèi)含部署方式的說明。通常，WebApp 模版都包含了一個(gè)輕后端服務(wù)，這是為了確保開發(fā)者的 API KEY 不會(huì)直接暴露給用戶。
這些 WebApp 模版能夠幫助你快速搭建起 AI 應(yīng)用原型，并使用 Dify 的所有能力。如果你基于它們開發(fā)了自己的應(yīng)用或新的模版，歡迎你與我們分享。