Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 0 additions & 17 deletions ja/cloud/use-dify/publish/webapp/workflow-webapp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -144,20 +144,3 @@ Workflow アプリには、ユーザーが出力を整理し再利用するの
<Tip>
「類似生成」は特に、ユーザーが同じトピックに対する異なるアプローチを探索したいコンテンツ生成などのクリエイティブなワークフローでうまく機能します。
</Tip>

## ベストプラクティス

**単一実行アプリの場合**:
- ユーザーが有用な情報を提供するよう導くクリアな入力フォームを設計
- 複雑なパラメータには役立つ説明を含める
- 結果が期待に応えるかユーザーフローをテスト

**バッチ処理アプリの場合**:
- サンプルデータを含む明確な CSV テンプレート例を提供
- 一般的な入力エラーの検証を含める
- 非常に大きなバッチの処理制限を考慮

**結果管理の場合**:
- ユーザーが保持したい価値ある出力を生成するワークフローには保存を有効化
- クリエイティブまたは探索的なワークフローには「類似生成」を使用
- 外部アクセスが必要なユーザーのために結果エクスポートオプションを考慮
17 changes: 0 additions & 17 deletions ja/self-host/use-dify/publish/webapp/workflow-webapp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -144,20 +144,3 @@ Workflow アプリには、ユーザーが出力を整理し再利用するの
<Tip>
「類似生成」は特に、ユーザーが同じトピックに対する異なるアプローチを探索したいコンテンツ生成などのクリエイティブなワークフローでうまく機能します。
</Tip>

## ベストプラクティス

**単一実行アプリの場合**:
- ユーザーが有用な情報を提供するよう導くクリアな入力フォームを設計
- 複雑なパラメータには役立つ説明を含める
- 結果が期待に応えるかユーザーフローをテスト

**バッチ処理アプリの場合**:
- サンプルデータを含む明確な CSV テンプレート例を提供
- 一般的な入力エラーの検証を含める
- 非常に大きなバッチの処理制限を考慮

**結果管理の場合**:
- ユーザーが保持したい価値ある出力を生成するワークフローには保存を有効化
- クリエイティブまたは探索的なワークフローには「類似生成」を使用
- 外部アクセスが必要なユーザーのために結果エクスポートオプションを考慮
87 changes: 48 additions & 39 deletions zh/cloud/use-dify/publish/webapp/embedding-in-websites.mdx
Original file line number Diff line number Diff line change
@@ -1,33 +1,40 @@
---
title: "网站嵌入"
sidebarTitle: "嵌入"
title: 嵌入 Web 应用
sidebarTitle: 嵌入
description: 通过 iframe、聊天气泡组件或自定义集成,将已发布的 Web 应用部署到任何网站
---

> 本文档由 AI 自动翻译。如有任何不准确之处,请参考 [英文原版](/en/cloud/use-dify/publish/webapp/embedding-in-websites)。


将 Dify 应用嵌入到网站中,直接为网站访客提供 AI 能力。无论你想要一个浮动聊天按钮、全屏聊天界面,还是嵌入式小组件,Dify 都提供了适用于任何网站技术的灵活选项。
已发布的 Web 应用可直接嵌入任何网站。这不是另一种发布方式:嵌入的仍是你已创建的同一个 Web 应用,只是呈现在你现有的网站中,而不是作为独立页面。

## 嵌入选项
## Web 应用嵌入的工作方式

在 Dify 中发布应用后,你会获得一个 Web 应用 URL。你可直接分享该 URL,也可通过以下方式将同一个应用嵌入你的网站:

<CardGroup cols={2}>
<Card title="聊天气泡按钮" icon="comment">
浮动聊天按钮,打开你的 AI 助手,非常适合客户支持
<Card title="聊天气泡组件" icon="comment">
Web 应用以浮动按钮呈现,访客点击即可打开完整界面
</Card>
<Card title="Iframe 嵌入" icon="window">
在网页内容中完整嵌入界面,直接访问
Web 应用直接嵌入页面内容,始终可见、随时可用
</Card>
<Card title="自定义集成" icon="code">
使用 JavaScript API 完全控制用户体验
<Card title="JavaScript 控制" icon="code">
高级嵌入方式,可自定义样式和控制行为
</Card>
<Card title="响应式设计" icon="mobile">
所有嵌入都会自动适应不同的屏幕尺寸和设备
同一个 Web 应用自动适配任何展示形式
</Card>
</CardGroup>

## 聊天气泡设置
<Info>
所有嵌入方式使用的都是你已发布的 Web 应用。应用配置的变更会自动应用到所有嵌入位置。
</Info>

## 聊天气泡组件

浮动聊天按钮是最受欢迎的嵌入方法。它会在你的网站上添加一个可自定义的按钮,点击时打开你的 AI 助手。
聊天气泡将 Web 应用显示为一个浮动按钮。访客点击后,应用以浮层形式打开,无需离开当前页面即可使用 AI 功能。

### 配置选项

Expand Down Expand Up @@ -77,7 +84,7 @@ window.difyChatbotConfig = {

<Steps>
<Step title="获取你的嵌入令牌">
在你的 Dify 应用中,前往 **发布 → 嵌入** 找到你的唯一令牌。
在你的 Dify 应用中,前往 **发布** > **嵌入** 找到唯一令牌。
</Step>
Comment thread
RiskeyL marked this conversation as resolved.
Resolved

<Step title="添加脚本">
Expand All @@ -95,7 +102,7 @@ window.difyChatbotConfig = {

## Iframe 嵌入

为了获得更集成的体验,可以将你的 Dify 应用直接嵌入到网页内容中:
将 Web 应用直接嵌入页面内容,让它成为网站的组成部分:

```html
<iframe
Expand All @@ -106,12 +113,12 @@ window.difyChatbotConfig = {
</iframe>
```

### Iframe 优势
### 为什么使用 Iframe 嵌入

- **直接集成** - 应用作为页面内容的一部分出现
- **完整功能** - 所有应用功能在 iframe 内正常工作
- **响应式设计** - 自动适应容器大小
- **无需 JavaScript** - 简单的 HTML 实现
- **始终可见**:Web 应用直接可用,不必先点击按钮唤出
- **功能完整**:Web 应用的所有功能在 iframe 中表现一致
- **融入页面**:以页面原生内容呈现,而非浮层
- **配置简单**:只需 HTML,无需 JavaScript 配置

### 自定义选项

Expand All @@ -136,40 +143,42 @@ window.difyChatbotConfig = {
</div>
```

## 使用场景和最佳实践
## 选择嵌入方式

<AccordionGroup>
<Accordion title="客户支持">
使用聊天气泡进行即时帮助。将它们放在显著位置,并考虑预填充当前页面或用户账户信息等上下文。
<Accordion title="客户支持应用">
**聊天气泡** 最合适:平时不打扰浏览,需要时随时可用。浮动按钮让访客边浏览边快速获取帮助。
</Accordion>
<Accordion title="潜在客户挖掘">
直接在内容中嵌入线索收集表单。在专门的着陆页上使用 iframe 嵌入以获得更高的参与度。

<Accordion title="表单和 Workflow 应用">
应用是页面主要内容时,选 **Iframe 嵌入**。访客无需额外点击,直接看到并使用应用。
</Accordion>

<Accordion title="产品演示">
通过嵌入式演示展示 AI 功能。让访问者在不离开你网站的情况下试用你的应用。
在着陆页使用 **Iframe 嵌入**,让访客即刻体验你的 AI 能力,从感兴趣到上手没有任何门槛。
</Accordion>
<Accordion title="知识库">
用交互式 AI 助手替换静态 FAQ。用户可以获得个性化答案,而不是搜索文档。

<Accordion title="多页面集成">
希望全站每个页面都能访问同一个应用时,选 **聊天气泡**。一段嵌入代码即可覆盖所有页面。
</Accordion>
</AccordionGroup>

## 故障排除

**聊天按钮未出现:**
- 检查你的令牌是否正确
- 确保嵌入脚本在配置之后加载
- 验证浏览器控制台中没有 JavaScript 错误
**组件未显示**:

- 确认应用令牌与 Dify **发布** > **嵌入** 中显示的一致
- 检查配置是否在嵌入脚本之前加载
- 查看浏览器控制台是否有 JavaScript 错误
Comment thread
RiskeyL marked this conversation as resolved.
Resolved

**Iframe 无法加载**:

**Iframe 无法加载:**
- 确认 iframe URL 包含你正确的应用令牌
- 检查你的网站是否允许 iframe 内容
- 如果你的 Dify 应用需要,确保父页面通过 HTTPS 提供服务
- 确认 Web 应用 URL 中包含正确的令牌
- 确保你的网站允许 iframe 内容(检查 Content Security Policy)
- 你的网站和 Dify 应用都应使用 HTTPS

<Warning>
在不同的浏览器和设备上测试你的嵌入以确保兼容性。某些企业防火墙可能会阻止 iframe 内容。
Web 应用必须先发布才能嵌入。更新应用配置后,需重新发布,变更才会应用到嵌入版本。
</Warning>

你可以使用 CSS 变量或 `containerProps` 选项覆盖默认按钮样式。根据 CSS 特异性应用这些方法以实现你想要的自定义。
Expand Down
6 changes: 3 additions & 3 deletions zh/cloud/use-dify/publish/webapp/web-app-access.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ tag: "ENTERPRISE"

<Note> ⚠️ 本文档由 AI 自动翻译。如有任何不准确之处,请参考 [英文原版](/en/cloud/use-dify/publish/webapp/web-app-access)。</Note>

Web 应用访问控制决定了谁可以使用你发布的应用程序。默认情况下,新应用仅限特定团队成员访问——你可以精确选择谁有权限访问。
Web 应用访问控制决定了谁可以使用你发布的应用程序。默认情况下,新应用仅限特定团队成员访问,由你精确选择谁可以访问。

<Info>
只有工作空间所有者、管理员和编辑者角色才能创建和发布 Web 应用。
Expand All @@ -23,7 +23,7 @@ Dify Enterprise 提供四个访问级别:

### 平台内所有成员

你的 Dify Enterprise 工作空间中的任何成员都可以访问该应用。用户必须使用其工作空间凭据进行身份验证——密码、验证码或 SSO。
你的 Dify Enterprise 工作空间中的任何成员都可以访问该应用。用户必须使用其工作空间凭据(密码、验证码或 SSO)进行身份验证。

成员可以通过直接 URL 或工作空间 Explorer 页面访问应用。

Expand All @@ -36,7 +36,7 @@ Dify Enterprise 提供四个访问级别:
**新应用的默认设置。** 限制访问权限给工作空间内选定的组或个人成员。非常适合部门特定工具或敏感数据应用。

<Warning>
如果没有选择任何组或成员,任何人都无法访问你的应用——包括你自己。
如果没有选择任何组或成员,任何人都无法访问你的应用,包括你自己。
</Warning>

通过组或个人配置访问权限:
Expand Down
17 changes: 0 additions & 17 deletions zh/cloud/use-dify/publish/webapp/workflow-webapp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -143,20 +143,3 @@ Workflow 应用包含全面的结果管理功能,帮助用户整理和重复
<Tip>
"生成类似内容"对于内容生成等创意工作流特别有效,用户希望探索同一主题的不同方法。
</Tip>

## 最佳实践

**对于单次执行应用**:
- 设计清晰的输入表单,指导用户提供有用信息
- 为复杂参数包含有用的描述
- 测试用户流程以确保结果符合预期

**对于批处理应用**:
- 提供清晰的 CSV 模板示例和样本数据
- 包含常见输入错误的验证
- 考虑非常大批次的处理限制

**对于结果管理**:
- 为产生用户想要保留的有价值输出的工作流启用保存
- 对创意或探索性工作流使用"生成类似内容"
- 考虑为需要外部访问的用户提供结果导出选项
87 changes: 48 additions & 39 deletions zh/self-host/use-dify/publish/webapp/embedding-in-websites.mdx
Original file line number Diff line number Diff line change
@@ -1,33 +1,40 @@
---
title: "网站嵌入"
sidebarTitle: "嵌入"
title: 嵌入 Web 应用
sidebarTitle: 嵌入
description: 通过 iframe、聊天气泡组件或自定义集成,将已发布的 Web 应用部署到任何网站
---

> 本文档由 AI 自动翻译。如有任何不准确之处,请参考 [英文原版](/en/self-host/use-dify/publish/webapp/embedding-in-websites)。


将 Dify 应用嵌入到网站中,直接为网站访客提供 AI 能力。无论你想要一个浮动聊天按钮、全屏聊天界面,还是嵌入式小组件,Dify 都提供了适用于任何网站技术的灵活选项。
已发布的 Web 应用可直接嵌入任何网站。这不是另一种发布方式:嵌入的仍是你已创建的同一个 Web 应用,只是呈现在你现有的网站中,而不是作为独立页面。

## 嵌入选项
## Web 应用嵌入的工作方式

在 Dify 中发布应用后,你会获得一个 Web 应用 URL。你可直接分享该 URL,也可通过以下方式将同一个应用嵌入你的网站:

<CardGroup cols={2}>
<Card title="聊天气泡按钮" icon="comment">
浮动聊天按钮,打开你的 AI 助手,非常适合客户支持
<Card title="聊天气泡组件" icon="comment">
Web 应用以浮动按钮呈现,访客点击即可打开完整界面
</Card>
<Card title="Iframe 嵌入" icon="window">
在网页内容中完整嵌入界面,直接访问
Web 应用直接嵌入页面内容,始终可见、随时可用
</Card>
<Card title="自定义集成" icon="code">
使用 JavaScript API 完全控制用户体验
<Card title="JavaScript 控制" icon="code">
高级嵌入方式,可自定义样式和控制行为
</Card>
<Card title="响应式设计" icon="mobile">
所有嵌入都会自动适应不同的屏幕尺寸和设备
同一个 Web 应用自动适配任何展示形式
</Card>
</CardGroup>

## 聊天气泡设置
<Info>
所有嵌入方式使用的都是你已发布的 Web 应用。应用配置的变更会自动应用到所有嵌入位置。
</Info>

## 聊天气泡组件

浮动聊天按钮是最受欢迎的嵌入方法。它会在你的网站上添加一个可自定义的按钮,点击时打开你的 AI 助手。
聊天气泡将 Web 应用显示为一个浮动按钮。访客点击后,应用以浮层形式打开,无需离开当前页面即可使用 AI 功能。

### 配置选项

Expand Down Expand Up @@ -77,7 +84,7 @@ window.difyChatbotConfig = {

<Steps>
<Step title="获取你的嵌入令牌">
在你的 Dify 应用中,前往 **发布 → 嵌入** 找到你的唯一令牌。
在你的 Dify 应用中,前往 **发布** > **嵌入** 找到唯一令牌。
</Step>
Comment thread
RiskeyL marked this conversation as resolved.
Resolved

<Step title="添加脚本">
Expand All @@ -95,7 +102,7 @@ window.difyChatbotConfig = {

## Iframe 嵌入

为了获得更集成的体验,可以将你的 Dify 应用直接嵌入到网页内容中:
将 Web 应用直接嵌入页面内容,让它成为网站的组成部分:

```html
<iframe
Expand All @@ -106,12 +113,12 @@ window.difyChatbotConfig = {
</iframe>
```

### Iframe 优势
### 为什么使用 Iframe 嵌入

- **直接集成** - 应用作为页面内容的一部分出现
- **完整功能** - 所有应用功能在 iframe 内正常工作
- **响应式设计** - 自动适应容器大小
- **无需 JavaScript** - 简单的 HTML 实现
- **始终可见**:Web 应用直接可用,不必先点击按钮唤出
- **功能完整**:Web 应用的所有功能在 iframe 中表现一致
- **融入页面**:以页面原生内容呈现,而非浮层
- **配置简单**:只需 HTML,无需 JavaScript 配置

### 自定义选项

Expand All @@ -136,40 +143,42 @@ window.difyChatbotConfig = {
</div>
```

## 使用场景和最佳实践
## 选择嵌入方式

<AccordionGroup>
<Accordion title="客户支持">
使用聊天气泡进行即时帮助。将它们放在显著位置,并考虑预填充当前页面或用户账户信息等上下文。
<Accordion title="客户支持应用">
**聊天气泡** 最合适:平时不打扰浏览,需要时随时可用。浮动按钮让访客边浏览边快速获取帮助。
</Accordion>
<Accordion title="潜在客户挖掘">
直接在内容中嵌入线索收集表单。在专门的着陆页上使用 iframe 嵌入以获得更高的参与度。

<Accordion title="表单和 Workflow 应用">
应用是页面主要内容时,选 **Iframe 嵌入**。访客无需额外点击,直接看到并使用应用。
</Accordion>

<Accordion title="产品演示">
通过嵌入式演示展示 AI 功能。让访问者在不离开你网站的情况下试用你的应用。
在着陆页使用 **Iframe 嵌入**,让访客即刻体验你的 AI 能力,从感兴趣到上手没有任何门槛。
</Accordion>
<Accordion title="知识库">
用交互式 AI 助手替换静态 FAQ。用户可以获得个性化答案,而不是搜索文档。

<Accordion title="多页面集成">
希望全站每个页面都能访问同一个应用时,选 **聊天气泡**。一段嵌入代码即可覆盖所有页面。
</Accordion>
</AccordionGroup>

## 故障排除

**聊天按钮未出现:**
- 检查你的令牌是否正确
- 确保嵌入脚本在配置之后加载
- 验证浏览器控制台中没有 JavaScript 错误
**组件未显示**:

- 确认应用令牌与 Dify **发布** > **嵌入** 中显示的一致
- 检查配置是否在嵌入脚本之前加载
- 查看浏览器控制台是否有 JavaScript 错误
Comment thread
RiskeyL marked this conversation as resolved.
Resolved

**Iframe 无法加载**:

**Iframe 无法加载:**
- 确认 iframe URL 包含你正确的应用令牌
- 检查你的网站是否允许 iframe 内容
- 如果你的 Dify 应用需要,确保父页面通过 HTTPS 提供服务
- 确认 Web 应用 URL 中包含正确的令牌
- 确保你的网站允许 iframe 内容(检查 Content Security Policy)
- 你的网站和 Dify 应用都应使用 HTTPS

<Warning>
在不同的浏览器和设备上测试你的嵌入以确保兼容性。某些企业防火墙可能会阻止 iframe 内容。
Web 应用必须先发布才能嵌入。更新应用配置后,需重新发布,变更才会应用到嵌入版本。
</Warning>

你可以使用 CSS 变量或 `containerProps` 选项覆盖默认按钮样式。根据 CSS 特异性应用这些方法以实现你想要的自定义。
Expand Down
Loading
Loading