langgenius/dify-docs-archived
1
0
Fork 0
mirror of https://github.com/langgenius/dify-docs-archived.git synced 2026-07-01 20:35:52 -04:00
Code Issues 39 Packages Projects Releases Wiki Activity

delete and modify files (#718)

Browse Source
This commit is contained in:
Hanqing Zhao
2025-04-15 14:27:48 +08:00
committed by GitHub
parent 5cc8af50c3
commit e8edcceecf
9 changed files with 16 additions and 318 deletions
Download Patch File Download Diff File Expand all files Collapse all files
jp/guides/application-orchestrate/agent.md
+9 -9
View File
@@ -1,10 +1,10 @@
# エージェント
### 定義
## 定義
エージェントアシスタントは、大規模言語モデルの推論能力を活用し、複雑な人間のタスクを自律的に目標設定、タスク分解、ツールの呼び出し、プロセスのイテレーションを行い、人間の介入なしでタスクを完了することができます。
### エージェントアシスタントの使い方
## エージェントアシスタントの使い方
迅速に使い始めるために、「探索」でエージェントアシスタントのアプリケーションテンプレートを見つけて自分のワークスペースに追加するか、それを基にカスタマイズすることができます。新しいDifyスタジオでは、ゼロから自分専用のエージェントアシスタントを編成し、財務報告書の分析、レポートの作成、ロゴデザイン、旅行計画などのタスクを完了する手助けをすることができます。
@@ -18,11 +18,11 @@
<figure><img src="../../.gitbook/assets/jp-agent-3.png" alt=""><figcaption><p>エージェントアシスタントの指示プロンプトを編成</p></figcaption></figure>
### アシスタントに必要なツールを追加
## アシスタントに必要なツールを追加
「コンテキスト」では、エージェントアシスタントが参照できるナレッジベースツールを追加できます。これにより、外部の背景知識を取得することができます。
「ツール」では、使用する必要があるツールを追加できます。ツールはLLMの能力を拡張し、例えばネット検索、科学計算、画像の作成などが可能になります。これにより、LLMは外部世界と接続する能力を持つようになります。Difyは2種類のツールタイプを提供しています：**ファーストパーティツール**と**カスタムツール**です。
「ツール」では、使用する必要があるツールを追加できます。ツールはLLMの能力を拡張し、例えばネット検索、科学計算、画像の作成などが可能になります。これにより、LLMは外部世界と接続する能力を持つようになります。Difyは2種類のツールタイプを提供しています：**ファーストパーティツールとカスタムツール**です。
Difyエコシステムが提供するファーストパーティ内蔵ツールを直接使用するか、カスタムAPIツール（現在はOpenAPI / SwaggerおよびOpenAIプラグイン規格をサポート）を簡単にインポートすることができます。
@@ -34,7 +34,7 @@ Difyエコシステムが提供するファーストパーティ内蔵ツール
![](../../.gitbook/assets/agent-dalle3.png)
### エージェントの設定
## エージェントの設定
DifyではエージェントアシスタントにFunction Calling（関数呼び出し）とReActの2つの推論モードを提供しています。関数呼び出しをサポートするモデルシリーズ（例：gpt-3.5/gpt-4）はより良い、安定したパフォーマンスを持っています。関数呼び出しをサポートしていないモデルシリーズには、ReAct推論フレームワークで類似の効果を実現しています。
@@ -44,7 +44,7 @@ DifyではエージェントアシスタントにFunction Calling（関数呼び
<figure><img src="../../.gitbook/assets/jp-agent-6.png" alt=""><figcaption><p>ReAct モード</p></figcaption></figure>
### 会話のオープニング設定
## 会話のオープニング設定
エージェントアシスタントの会話オープニングとオープニング質問を設定できます。設定された会話オープニングは、ユーザーが初めて対話を開始する際に、アシスタントが完了できるタスクや提案される質問の例を表示します。
@@ -52,18 +52,18 @@ DifyではエージェントアシスタントにFunction Calling（関数呼び
### ファイルのアップロード
Claude 3.5 Sonnet (https://docs.anthropic.com/en/docs/build-with-claude/pdf-support) や Gemini 1.5 Pro (https://ai.google.dev/api/files) など、一部のLLMはファイル処理に標準対応しています。各LLMのウェブサイトで、ファイルのアップロード機能について詳しくご確認ください。
[Claude 3.5 Sonnet](https://docs.anthropic.com/en/docs/build-with-claude/pdf-support) や [Gemini 1.5 Pro](https://ai.google.dev/api/files) など、一部のLLMはファイル処理に標準対応しています。各LLMのウェブサイトで、ファイルのアップロード機能について詳しくご確認ください。
ファイルの読み込みに対応したLLMを選択し、「Document」を有効にしてください。これにより、チャットボットは複雑な設定なしでファイルの内容を理解し、利用できるようになります。
![](https://assets-docs.dify.ai/2024/11/9f0b7a3c67b58c0bd7926501284cbb7d.png)
### デバッグとプレビュー
## デバッグとプレビュー
エージェントアシスタントの編成が完了したら、アプリとして公開する前にデバッグとプレビューを行い、アシスタントのタスク完了効果を確認できます。
<figure><img src="../../.gitbook/assets/jp-agent-8.png" alt=""><figcaption><p>デバッグとプレビュー</p></figcaption></figure>
### アプリの公開
## アプリの公開
<figure><img src="../../.gitbook/assets/jp-agent-9.png" alt=""><figcaption><p>アプリをWebアプリとして公開</p></figcaption></figure>
jp/workshop/README.md
View File
jp/workspace/app.md
-21
View File
@@ -1,21 +0,0 @@
# 発見
## テンプレートアプリケーションの使用
**探索 > 発見** では、いくつかの一般的なテンプレートアプリケーションを提供しています。これらのアプリケーションは、翻訳、ライティング、プログラミング、アシスタントなどをカバーしています。
<figure><img src="../explore/images/explore-app.jpg" alt=""><figcaption></figcaption></figure>
テンプレートアプリケーションを使用したい場合は、テンプレート上の「ワークスペースに追加」ボタンをクリックしてください。これで左側のワークスペースでそのアプリケーションを使用することができます。
<figure><img src="../explore/images/creat-customize-app.jpg" alt=""><figcaption></figcaption></figure>
新しいアプリケーションを作成するためにテンプレートを修正したい場合は、テンプレート上の「カスタマイズ」ボタンをクリックしてください。
## ワークスペース
ワークスペースはアプリケーションのナビゲーションです。ワークスペースでアプリケーションをクリックすると、そのアプリケーションを直接使用することができます。
<figure><img src="../explore/images/workspace.jpg" alt=""><figcaption></figcaption></figure>
ワークスペースには、あなた自身のアプリケーションや他のチームメンバーがワークスペースに追加したアプリケーションが含まれています。
zh_CN/features/ai-plugins/based-on-frontend-templates.md
-39
View File
@@ -1,39 +0,0 @@
# 基于 WebApp 模板
如果开发人员从零开始开发新产品，或者处于产品原型设计阶段，你可以使用Dify快速启动人工智能网站。同时，Dify希望开发者能够完全自由地创造出不同形式的前端应用。为此，我们提供:
* **SDK** 用于快速访问各种语言的dify API
* **WebApp Template** 用于为每种类型的应用程序搭建WebApp开发脚手架
根据麻省理工学院的许可，WebApp模板是开源的。你可以自由地修改和部署它们以实现dify的所有功能，或者作为实现你自己的应用程序的参考代码.
你可以在GitHub上找到这些模板:
* [Conversational app](https://github.com/langgenius/webapp-conversation)
* [Text generation app](https://github.com/langgenius/webapp-text-generator)
使用WebApp模板的最快捷方式是通过github点击 "**Use this template**" , 这相当于派生一个新的存储库. 然后你需要配置dify应用ID和API密钥, 比如:
```javascript
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模板都提供了一个包含部署说明的自述文件。通常，WebApp模板包含一个轻量级的后端服务，以确保开发者的API密钥不会直接暴露给用户.
这些WebApp模板可以帮助你快速构建AI应用的原型，并使用dify的所有功能。如果你在此基础上开发自己的应用程序或新模板，请随时与我们分享.
zh_CN/features/datasets/maintain-dataset-via-api.md
-145
View File
@@ -1,145 +0,0 @@
# 维护 Knowledge API
> 身份验证、调用方法和应用服务API保持一致。区别在于知识API令牌可以对所有知识库进行操作.
### 使用 Knowledge API 的好处
* 同步你的数据系统以分散Knowledge以创建强大的工作流.
* 提供知识列表和文档列表API以及详细查询接口, 目的是为了便于生成自己的数据管理页.
* 为了简化你的同步进程，支持纯文本和 文件上传 / 更新文档 以及批量新增和修改.
* 提高Dify软件和服务的可见性，缩短手动处理文档和同步的时间.
### 如何使用
请转到知识页面，你可以在左侧导航中切换到API页面。在此页面上，你可以查看dify提供的API文档并管理用于访问Knowledge API的凭据.
<figure><img src="../../.gitbook/assets/dataset-api-token.png" alt=""><figcaption><p>Knowledge API Document</p></figcaption></figure>
## **创建空的 Knowledge**
**`POST /datasets`**
{% hint style="warning" %}
仅用于创建空知识库
{% endhint %}
```
curl --location --request POST 'https://api.dify.ai/v1/datasets' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data-raw '{"name": "name"}'
```
#### **Knowledge 列表**
```
curl --location --request GET 'https://api.dify.ai/v1/datasets?page=1&limit=20' \
--header 'Authorization: Bearer {api_key}'
```
#### **文本创建文档**
```
curl --location --request POST '<https://api.dify.ai/v1/datasets/<uuid:dataset_id>/document/create_by_text>' \\
--header 'Authorization: Bearer {api_key}' \\
--header 'Content-Type: application/json' \\
--data-raw '{
"name": "Dify",
"text": "Dify means Do it for you...",
"indexing_technique": "high_quality",
"process_rule": {
"rules": {
"pre_processing_rules": [{
"id": "remove_extra_spaces",
"enabled": true
}, {
"id": "remove_urls_emails",
"enabled": true
}],
"segmentation": {
"separator": "###",
"max_tokens": 500
}
},
"mode": "custom"
}
}'
```
#### **文件创建文档**
```
curl --location POST 'https://api.dify.ai/v1/datasets/{dataset_id}/document/create_by_file' \
--header 'Authorization: Bearer {api_key}' \
--form 'data="{
"name": "Dify",
"indexing_technique": "high_quality",
"process_rule": {
"rules": {
"pre_processing_rules": [{
"id": "remove_extra_spaces",
"enabled": true
}, {
"id": "remove_urls_emails",
"enabled": true
}],
"segmentation": {
"separator": "###",
"max_tokens": 500
}
},
"mode": "custom"
}
}";
type=text/plain' \
--form 'file=@"/path/to/file"'
```
#### **获取文档嵌入状态**
```
curl --location --request GET 'https://api.dify.ai/v1/datasets/{dataset_id}/documents/{batch}/indexing-status' \
--header 'Authorization: Bearer {api_key}'
```
#### **删除文档**
```
curl --location --request GET 'https://api.dify.ai/v1/datasets/{dataset_id}/documents' \
--header 'Authorization: Bearer {api_key}'
```
#### **添加新的片段**
```
curl --location 'https://api.dify.ai/v1/datasets/{dataset_id}/documents/{document_id}/segments' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{"segments": [{"content": "1","answer": "1","keywords": ["a"]}]}'
```
#### 删除文档分段
```
curl --location --request DELETE 'https://api.dify.ai/v1/datasets/{dataset_id}/documents/{document_id}/segments/{segment_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json'
```
### 报错信息
- `document_indexing`，表示文档正处于索引过程中
- `provider_not_initialize`， 表示未配置嵌入模型
- `not_found`，文档不存在
- `dataset_name_duplicate` ，重复命名
- `provider_quota_exceeded`，配额已超出最大限制
- `dataset_not_initialized`，未进行初始化
- `unsupported_file_type`，不支持的文件类型
- 现支持的文件类型如下：txt, markdown, md, pdf, html, htm, xlsx, docx, csv
- `too_many_files`，表示文件数量太大，暂时只支持单文件上传
- `file_too_large`，表示文件太大，仅支持15M以下的文件
zh_CN/features/datasets/sync-from-notion.md
-74
View File
@@ -1,74 +0,0 @@
# 概念同步
Dify的概念支持从概念导入并设置 **同步** 以便在概念更新后自动同步数据以进行更新.
### 鉴权
1. 当创建知识库时, 选择数据源, 点击 **从概念同步--转到连接**, 并根据提示完成授权验证.
2. 你也可以: 点击 **设置--数据源--添加数据源**, 点击概念来源 **连接** 以完成鉴权.
<figure><img src="../../.gitbook/assets/notion-connect.png" alt=""><figcaption><p>概念链接</p></figcaption></figure>
### 导入数据
完成鉴权操作后, 前往构建知识库页面, 点击 **概念同步**, 选择要导入的所需授权页面.
### 分段清洗
接下来, 选择你的 **分段设置** 和 **索引方法**, **保存并处理**. 等待dify数据处理, 通常此步骤需要在LLM提供程序中使用令牌. 不仅支持导入普通页面类型，还可以汇总保存数据库类型下的页面属性.
_**便笺:当前不支持导入图像和文件。表数据将转换为文本.**_
### 同步概念数据
如果你的概念内容已被修改，你可以直接在dify知识文档列表页面上单击[同步]按钮，一键同步数据(请注意，每次单击都会同步当前内容)。此步骤需要使用令牌.
<figure><img src="../../.gitbook/assets/sync-notion-data.png" alt=""><figcaption><p>同步概念数据</p></figcaption></figure>
### (社区版) 概念集成配置指南
集成分为两种方式: **内部集成** 和 **公共集成** . 它可以按需在dify中配置.
有关这两种集成方法的具体区别，请参阅 [概念正式说明](https://developers.notion.com/docs/authorization).
#### 1. **使用内部集成**
创建你的集成页面 [集成设置](https://www.notion.so/my-integrations) . 默认状态下, 所有集成都从内部集成开始; 内部集成将与你选择的工作空间相关联, 因此，你需要是工作区所有者才能创建集成.
**具体操作步骤:**
点击 " **New integration** " 按钮, 即默认为内部(不能修改), 选择关联的空间, 输入名称并上传logo, 点击"**提交**" 成功创建集成.
<figure><img src="../../.gitbook/assets/image (4).png" alt=""><figcaption></figcaption></figure>
一旦创建了集成, 你可以根据需要更新其设置。 **性能** 此选项卡，然后再单击 "**显示**" 按钮后 **密钥** 复制你的密钥.
<figure><img src="../../.gitbook/assets/image (1) (1) (1) (1) (1).png" alt=""><figcaption></figcaption></figure>
将其复制并返回到dify源代码 , 在 **.env** 文件与配置相关的环境变量中，环境变量如下:
**NOTION\_INTEGRATION\_TYPE** = 内部 或 **NOTION\_INTEGRATION\_TYPE** = 公用
**NOTION\_INTERNAL\_SECRET**= 你的内部密钥
#### 2. **使用公共集成**
**你需要将内部集成升级为公共集成** , 导航到集成分发页面，并切换开关以显示集成.
要将开关切换到公共设置，你需要 **在组织信息中填写其他信息**, 包括你的公司名称, 网址, 和重定向目标路径, 然后点击 "提交" 按钮.
<figure><img src="../../.gitbook/assets/image (2) (1) (1).png" alt=""><figcaption></figcaption></figure>
在你公共集成成功后， 在你的[集成设置页面](https://www.notion.so/my-integrations), 你将能够在[密钥]选项卡中访问集成的密钥.
<figure><img src="../../.gitbook/assets/image (3) (1) (1).png" alt=""><figcaption></figcaption></figure>
返回到dify源代码,在 **.env** 与文件配置相关的环境变量中, 环境变量如下:
**NOTION\_INTEGRATION\_TYPE**=公共
**NOTION\_CLIENT\_SECRET**=你的客户端密钥
**NOTION\_CLIENT\_ID**=你的客户端id
配置完成后，你将能够使用知识部分中的概念数据导入和同步功能.
zh_CN/guides/application-orchestrate/agent.md
+7 -7
View File
@@ -1,10 +1,10 @@
# Agent
### 定义
## 定义
智能助手（Agent Assistant），利用大语言模型的推理能力，能够自主对复杂的人类任务进行目标规划、任务拆解、工具调用、过程迭代，并在没有人类干预的情况下完成任务。
### 如何使用智能助手
## 如何使用智能助手
为了方便快速上手使用，你可以在“探索”中找到智能助手的应用模板，添加到自己的工作区，或者在此基础上进行自定义。在全新的 Dify 工作室中，你也可以从零编排一个专属于你自己的智能助手，帮助你完成财务报表分析、撰写报告、Logo 设计、旅程规划等任务。
@@ -18,7 +18,7 @@
<figure><img src="../../.gitbook/assets/image (99).png" alt=""><figcaption><p>编排智能助手的指令提示词</p></figcaption></figure>
### 添加助手需要的工具
## 添加助手需要的工具
在“上下文”中，你可以添加智能助手可以用于查询的知识库工具，这将帮助它获取外部背景知识。
@@ -34,7 +34,7 @@
![](../../.gitbook/assets/zh-agent-dalle3.png)
### 配置 Agent
## 配置 Agent
在 Dify 上为智能助手提供了 Function calling（函数调用）和 ReAct 两种推理模式。已支持 Function Call 的模型系列如 gpt-3.5/gpt-4 拥有效果更佳、更稳定的表现，尚未支持 Function calling 的模型系列，我们支持了 ReAct 推理框架实现类似的效果。
@@ -44,7 +44,7 @@
<figure><img src="../../.gitbook/assets/image (110).png" alt=""><figcaption><p>ReAct 模式</p></figcaption></figure>
### 配置对话开场白
## 配置对话开场白
你可以为智能助手配置一套会话开场白和开场问题，配置的对话开场白将在每次用户初次对话中展示助手可以完成什么样的任务，以及可以提出的问题示例。
@@ -58,12 +58,12 @@
![](https://assets-docs.dify.ai/2024/11/9f0b7a3c67b58c0bd7926501284cbb7d.png)
### 调试与预览
## 调试与预览
编排完智能助手之后，你可以在发布成应用之前进行调试与预览，查看助手的任务完成效果。
<figure><img src="../../.gitbook/assets/image (104).png" alt=""><figcaption><p>调试与预览</p></figcaption></figure>
### 应用发布
## 应用发布
<figure><img src="../../.gitbook/assets/image (105).png" alt=""><figcaption><p>应用发布为 Webapp</p></figcaption></figure>
zh_CN/plugins/quick-start/develop-plugins/tool-cha-jian.md
-2
View File
@@ -1,2 +0,0 @@
# Tool 插件
zh_CN/workspace/app.md
-21
View File
@@ -1,21 +0,0 @@
# 发现
## 模板应用
在 **探索 > 发现** 中, 我们提供了一些常用的模板应用。这些应用涵盖翻译、写作、编程和助手。
<figure><img src="../explore/images/explore-app.jpg" alt=""><figcaption></figcaption></figure>
如果你想使用模板应用，点击模板上的“添加到工作区”按钮。便可以在左侧的工作区中使用该应用。
<figure><img src="../explore/images/creat-customize-app.jpg" alt=""><figcaption></figcaption></figure>
如果你要修改模板以创建新应用程序，请单击模板上的“自定义”按钮。
## 工作区
工作区是应用程序的导航。在工作区中点击一个应用，便可直接使用该应用。
<figure><img src="../explore/images/workspace.jpg" alt=""><figcaption></figcaption></figure>
工作区中的应用包括：你自己的应用和其他团队添加到工作区的应用。