Skip to content

Commit e9173ff

Browse files
🌐 Initial translations for PR #784
Auto-generated translations for documentation changes in PR #784. Last-Processed-Commit: 0c74e87 Original-PR: #784 Languages: Chinese (zh), Japanese (ja) 🤖 Generated with GitHub Actions
1 parent 651e734 commit e9173ff

19 files changed

Lines changed: 134 additions & 114 deletions

ja/develop-plugin/dev-guides-and-walkthroughs/agent-strategy-plugin.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: エージェント戦略プラグイン
3+
description: Function Callingエージェント戦略をゼロから構築する—LLMにツールを与えて自律的に現在時刻を取得させる方法を示す実践例
34
---
45

56
<Note> ⚠️ このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/develop-plugin/dev-guides-and-walkthroughs/agent-strategy-plugin) を参照してください。</Note>
@@ -1049,7 +1050,7 @@ class BasicAgentAgentStrategy(AgentStrategy):
10491050
プラグインの宣言ファイルと実装コードを完成させた後、プラグインディレクトリで`python -m main`を実行して再起動します。次に、プラグインが正しく動作することを確認します。Difyはリモートデバッグを提供しています。**プラグイン管理**に移動して、デバッグキーとリモートサーバーアドレスを取得してください。
10501051
10511052
<Frame>
1052-
![](https://assets-docs.dify.ai/2024/12/053415ef127f1f4d6dd85dd3ae79626a.png)
1053+
![プラグインの宣言ファイルと実装コードを完成させた後、python -m mainを実行](https://assets-docs.dify.ai/2024/12/053415ef127f1f4d6dd85dd3ae79626a.png)
10531054
</Frame>
10541055
10551056
プラグインプロジェクトに戻り、`.env.example`を`.env`にコピーし、関連するリモートサーバーとデバッグキー情報を挿入します。
@@ -1082,7 +1083,7 @@ python -m main
10821083
dify plugin package ./basic_agent/
10831084
```
10841085
1085-
現在のフォルダに`google.difypkg`()という名前のファイルが表示されます。これが最終的なプラグインパッケージです。
1086+
現在のフォルダに`basic_agent.difypkg`(プラグイン名と一致)という名前のファイルが表示されます。これが最終的なプラグインパッケージです。
10861087
10871088
**おめでとうございます!** エージェント戦略プラグインの開発、テスト、パッケージングが完了しました。
10881089

ja/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider.mdx

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -423,8 +423,7 @@ Dify は、開発中にプラグインをテストできるリモートデバッ
423423

424424
```dotenv
425425
INSTALL_METHOD=remote
426-
REMOTE_INSTALL_HOST=<your-dify-domain-or-ip>
427-
REMOTE_INSTALL_PORT=5003
426+
REMOTE_INSTALL_URL=<your-dify-host>:5003
428427
REMOTE_INSTALL_KEY=****-****-****-****-****
429428
```
430429

ja/develop-plugin/dev-guides-and-walkthroughs/datasource-plugin.mdx

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
2-
title: "データソースプラグイン"
2+
title: データソースプラグイン
3+
description: Dify 1.9.0以降のデータソースプラグインを構築し、ナレッジパイプラインにドキュメントを供給—アーキテクチャ、コードサンプル、デバッグ手順
34
---
45

56
<Note> ⚠️ このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/develop-plugin/dev-guides-and-walkthroughs/datasource-plugin) を参照してください。</Note>
@@ -20,7 +21,7 @@ title: "データソースプラグイン"
2021
Difyは3種類のデータソースプラグインをサポートしています:Webクローラー、オンラインドキュメント、オンラインドライブ。プラグインコードを実装する際、プラグインの機能を提供するクラスは特定のデータソースクラスを継承する必要があります。3種類のプラグインタイプはそれぞれ異なる親クラスに対応しています。
2122

2223
<Info>
23-
親クラスを継承してプラグイン機能を実装する方法については、[ツールプラグイン:ツールコードの準備](/ja/develop-plugin/dev-guides-and-walkthroughs/tool-plugin#4-ツールコードの準備)を参照してください。
24+
親クラスを継承してプラグイン機能を実装する方法については、[ツールプラグイン:ツールコードの準備](/ja/develop-plugin/dev-guides-and-walkthroughs/tool-plugin#4-prepare-tool-code)を参照してください。
2425
</Info>
2526

2627
各データソースプラグインタイプは複数のデータソースをサポートしています。例えば:
@@ -112,7 +113,7 @@ datasources:
112113
```
113114

114115
<Info>
115-
プロバイダーYAMLファイルの作成について詳しくは、[ツールプラグイン:サードパーティサービス認証情報の完成](/ja/develop-plugin/dev-guides-and-walkthroughs/tool-plugin#2-サードパーティサービス認証情報の完成)を参照してください。
116+
プロバイダーYAMLファイルの作成について詳しくは、[ツールプラグイン:サードパーティサービス認証情報の完成](/ja/develop-plugin/dev-guides-and-walkthroughs/tool-plugin#2-complete-third-party-service-credentials)を参照してください。
116117
</Info>
117118

118119
<Info>

ja/develop-plugin/dev-guides-and-walkthroughs/develop-flomo-plugin.mdx

Lines changed: 53 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -37,13 +37,11 @@ standard_title: 10-Minute Guide to Building Dify Plugins
3737
```
3838
</Tab>
3939
<Tab title="Linux">
40-
[Dify GitHubリリースページ](https://github.com/langgenius/dify-plugin-daemon/releases)から最新のDify CLIを取得してください
41-
40+
[Dify Plugin Daemonリリースページ](https://github.com/langgenius/dify-plugin-daemon/releases)から最新のバイナリをダウンロードしてください。x86_64の場合は`dify-plugin-linux-amd64`を、ARMの場合は`dify-plugin-linux-arm64`を選択してください。
41+
4242
```bash
43-
# Download appropriate version
4443
chmod +x dify-plugin-linux-amd64
45-
mv dify-plugin-linux-amd64 dify
46-
sudo mv dify /usr/local/bin/
44+
sudo mv dify-plugin-linux-amd64 /usr/local/bin/dify
4745
```
4846
</Tab>
4947
</Tabs>
@@ -102,8 +100,8 @@ resource:
102100

103101
plugins:
104102
tools:
105-
- flomo.yaml
106-
103+
- provider/flomo.yaml
104+
107105
meta:
108106
version: 0.0.1
109107
arch:
@@ -117,7 +115,9 @@ meta:
117115
118116
## ステップ3:ツール定義の作成
119117
120-
ツールインターフェースを定義する`flomo.yaml`ファイルを作成します:
118+
ツールプラグインは2つのYAMLファイルを使用します:認証情報を宣言しツールをリストする**プロバイダー**ファイルと、呼び出し可能なツールごとに1つの**ツール**ファイルです。完全なスキーマについては[一般仕様](/ja/develop-plugin/features-and-specs/plugin-types/general-specifications)を参照してください。
119+
120+
`provider/flomo.yaml`を作成します:
121121

122122
```yaml
123123
identity:
@@ -126,32 +126,61 @@ identity:
126126
label:
127127
en_US: Flomo Note
128128
zh_Hans: Flomo 浮墨笔记
129-
description:
130-
human:
129+
description:
131130
en_US: Add notes to your Flomo account directly from Dify.
132-
zh_Hans: 直接从Dify添加笔记到您的Flomo账户。
133-
llm: >
134-
A tool that allows users to save notes to Flomo. Use this tool when users want to save important information from the conversation. The tool accepts a 'content' parameter that contains the text to be saved as a note.
135-
credential_schema:
131+
zh_Hans: 直接从 Dify 添加笔记到您的 Flomo 账户。
132+
icon: icon.png
133+
credentials_for_provider:
136134
api_url:
137-
type: string
135+
type: secret-input
138136
required: true
139137
label:
140138
en_US: API URL
141139
zh_Hans: API URL
142-
human_description:
140+
placeholder:
141+
en_US: https://flomoapp.com/iwh/{token}/{secret}/
142+
help:
143143
en_US: Flomo API URL from your Flomo account settings.
144-
zh_Hans: 从您的Flomo账户设置中获取的API URL。
145-
tool_schema:
146-
content:
144+
zh_Hans: 从您的 Flomo 账户设置中获取的 API URL。
145+
tools:
146+
- tools/flomo.yaml
147+
extra:
148+
python:
149+
source: provider/flomo.py
150+
```
151+
152+
`tools/flomo.yaml`を作成します:
153+
154+
```yaml
155+
identity:
156+
name: flomo
157+
author: yourname
158+
label:
159+
en_US: Save to Flomo
160+
zh_Hans: 保存到 Flomo
161+
description:
162+
human:
163+
en_US: Save the conversation content as a Flomo note.
164+
zh_Hans: 将对话内容保存为 Flomo 笔记。
165+
llm: >
166+
Saves content to the user's Flomo account. Use this tool when the user
167+
asks to save, capture, or remember the current message. Takes a single
168+
`content` parameter containing the text to save.
169+
parameters:
170+
- name: content
147171
type: string
148172
required: true
149173
label:
150-
en_US: Note Content
174+
en_US: Note content
151175
zh_Hans: 笔记内容
152176
human_description:
153177
en_US: Content to save as a note in Flomo.
154-
zh_Hans: 要保存为Flomo笔记的内容。
178+
zh_Hans: 要保存为 Flomo 笔记的内容。
179+
llm_description: The text to save as a Flomo note.
180+
form: llm
181+
extra:
182+
python:
183+
source: tools/flomo.py
155184
```
156185
157186
## ステップ4:コアユーティリティ関数の実装
@@ -264,12 +293,11 @@ class FlomoTool(Tool):
264293
`.env`ファイルをDify環境の詳細で編集します:
265294
```
266295
INSTALL_METHOD=remote
267-
REMOTE_INSTALL_HOST=debug-plugin.dify.dev
268-
REMOTE_INSTALL_PORT=5003
296+
REMOTE_INSTALL_URL=debug-plugin.dify.dev:5003
269297
REMOTE_INSTALL_KEY=your_debug_key
270298
```
271-
272-
デバッグキーとホストはDifyダッシュボードで確認できます:右上のプラグインアイコンをクリックし、デバッグアイコンをクリックします。ポップアップウィンドウで「APIキー」と「ホストアドレスをコピーしてください。
299+
300+
デバッグURLとキーはDifyダッシュボードで確認できます:右上の**プラグイン**アイコンをクリックし、デバッグアイコンをクリックします。**APIキー****ホストアドレス**をコピーしてください(ホストにはすでにポートが含まれています)
273301
</Step>
274302

275303
<Step title="依存関係のインストールと実行">

ja/develop-plugin/dev-guides-and-walkthroughs/develop-md-exporter.mdx

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -456,8 +456,7 @@ plugin = PluginRunner(
456456
Dify環境の詳細を設定します:
457457
```
458458
INSTALL_METHOD=remote
459-
REMOTE_INSTALL_HOST=debug-plugin.dify.dev
460-
REMOTE_INSTALL_PORT=5003
459+
REMOTE_INSTALL_URL=debug-plugin.dify.dev:5003
461460
REMOTE_INSTALL_KEY=your_debug_key
462461
```
463462
</Step>

ja/develop-plugin/dev-guides-and-walkthroughs/develop-multimodal-data-processing-tool.mdx

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,25 @@
11
---
22
title: ナレッジパイプラインでマルチモーダルデータを処理するツールプラグインの構築
3+
description: ナレッジベースノードがマルチモーダル出力をテキストと一緒に埋め込めるように、画像、音声、または動画を出力するツールプラグインを設定する
34
---
45

56
<Note> ⚠️ このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/develop-plugin/dev-guides-and-walkthroughs/develop-multimodal-data-processing-tool) を参照してください。</Note>
67

78
ナレッジパイプラインでは、ナレッジベースノードは2種類のマルチモーダルデータ形式の入力をサポートしています:`multimodal-Parent-Child``multimodal-General`
89

9-
マルチモーダルデータ処理用のツールプラグインを開発する際、プラグインの出力するマルチモーダルデータ(テキスト、画像、音声、動画など)がナレッジベースノードで正しく認識・ベクトル化されるためには、以下の設定が必要です:
10+
マルチモーダルデータ処理用のツールプラグインを開発する際、プラグインの出力するマルチモーダルデータ(テキスト、画像、音声、動画など)がナレッジベースノードで正しく認識・埋め込みされるためには、以下の設定が必要です:
1011

11-
- **ツールコード内で**APIを呼び出してファイルオブジェクト `files` をアップロード・構築します
12+
- **ツールコードファイル内で**ツールセッションインターフェースを呼び出してファイルをアップロードし、`files` オブジェクトを構築します
1213

13-
- **ツールプロバイダーのYAML**ファイルで`output_schema``multimodal-Parent-Child` または `multimodal-General` として宣言します。
14+
- **ツールプロバイダーのYAMLファイル**`output_schema``multimodal-Parent-Child` または `multimodal-General` として宣言します。
1415

15-
## ファイルオブジェクトのアップロードと構築
16+
## ファイルのアップロードとファイルオブジェクトの構築
1617

17-
マルチモーダルデータ(画像など)を処理する際は、まずDifyのツールセッションインターフェースを通じてファイルをアップロードし、ファイルのメタデータを取得する必要があります。
18+
マルチモーダルデータ(画像など)を処理する際は、まずDifyのツールセッションツールを使用してファイルをアップロードし、ファイルのメタデータを取得する必要があります。
1819

19-
以下にDify公式プラグインDify Extractorを例として、ファイルのアップロードとファイルオブジェクトの構築方法を示します
20+
以下の例では、Dify公式プラグイン **Dify Extractor** を使用して、ファイルのアップロードと `files` オブジェクトの構築方法を示します
2021

2122
```python
22-
2323
# Upload the file using the tool session
2424
file_res = self._tool.session.file.upload(
2525
file_name, # filename
@@ -30,8 +30,7 @@ file_res = self._tool.session.file.upload(
3030
# Generate a Markdown image reference using the file preview URL
3131
image_url = f"![image]({file_res.preview_url})"
3232
```
33-
34-
アップロードインターフェースは、ファイルの基本情報を含む `UploadFileResponse` オブジェクトを返します:
33+
アップロードインターフェースは、ファイル情報を含む `UploadFileResponse` オブジェクトを返します。その構造は以下の通りです:
3534

3635
```python
3736
from enum import Enum
@@ -62,10 +61,10 @@ image_url = f"![image]({file_res.preview_url})"
6261
preview_url: str | None = None
6362
```
6463

65-
その構造に基づき、ファイル情報(`name``size``extension``mime_type` など)をマルチモーダル出力構造の `files` フィールドにマッピングできます。
64+
ファイル情報(`name``size``extension``mime_type` など)をマルチモーダル出力構造の `files` フィールドにマッピングできます。
6665

6766
<CodeGroup>
68-
```yaml multimodal_parent_child_structure highlight={22-62} expandable
67+
```yaml multimodal_parent_child_structure highlight={22-62} expandable
6968
{
7069
"$id": "https://dify.ai/schemas/v1/multimodal_parent_child_structure.json",
7170
"$schema": "http://json-schema.org/draft-07/schema#",
@@ -146,7 +145,7 @@ image_url = f"![image]({file_res.preview_url})"
146145
}
147146
```
148147

149-
```yaml multimodal_general_structure highlight={18-56} expandable
148+
```yaml multimodal_general_structure highlight={18-56} expandable
150149
{
151150
"$id": "https://dify.ai/schemas/v1/multimodal_general_structure.json",
152151
"$schema": "http://json-schema.org/draft-07/schema#",
@@ -233,7 +232,7 @@ output_schema:
233232
# $ref: "https://dify.ai/schemas/v1/multimodal_general_structure.json"
234233
```
235234

236-
`multimodal-Parent-Child` の例として、完全なYAMLファイルの設定は以下の通りです
235+
`multimodal-Parent-Child` の例として、完全なYAML設定は以下の通りです
237236

238237
```yaml expandable
239238
identity:

ja/develop-plugin/dev-guides-and-walkthroughs/tool-oauth.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: "ツールプラグインにOAuthサポートを追加する"
3+
description: 手動でのAPIキー入力をOAuth認可フローに置き換えることで、ユーザーがワンクリックでサードパーティサービスへのアクセスを許可できるようにします
34
---
45

56
<Note> ⚠️ このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/develop-plugin/dev-guides-and-walkthroughs/tool-oauth) を参照してください。</Note>
@@ -341,10 +342,10 @@ OAuthとAPI_KEY認証の両方をサポートするプラグインの場合、`s
341342

342343
### 4. 正しいバージョンを指定する
343344

344-
以前のバージョンのプラグインSDKとDifyはOAuth認証をサポートしていません。そのため、プラグインSDKのバージョンを以下に設定する必要があります
345+
OAuthには最新のSDKとDifyバージョンが必要です。`requirements.txt`でプラグインSDKを固定します
345346

346347
```
347-
dify_plugin>=0.4.2,<0.5.0.
348+
dify_plugin>=0.5.0
348349
```
349350
350351
`manifest.yaml`に、最小Difyバージョンを追加します:

ja/develop-plugin/dev-guides-and-walkthroughs/trigger-plugin.mdx

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,13 @@
11
---
22
title: "トリガープラグイン"
3+
description: "サードパーティのイベント(Webhook、ポーリング)をワークフロー開始シグナルに変換する Dify 1.10.0 以降のトリガープラグインを構築する"
34
---
45

56
<Note> ⚠️ このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/develop-plugin/dev-guides-and-walkthroughs/trigger-plugin) を参照してください。</Note>
67

78
## トリガープラグインとは?
89

9-
トリガーは Dify v1.10.0 で新しいタイプの開始ノードとして導入されました。コード、ツール、ナレッジベース検索などの機能ノードとは異なり、トリガーの目的は**サードパーティのイベントを Dify が認識して処理できる入力形式に変換すること**です。
10+
トリガーは Dify v1.10.0 で新しいタイプの開始ノードとして導入されました。コード、ツール、ナレッジ検索などの機能ノードとは異なり、トリガーの目的は**サードパーティのイベントを Dify が認識して処理できる入力形式に変換すること**です。
1011

1112
<Frame>
1213
![トリガープラグインの紹介](/images/develop-plugin/dev-guide/trigger-plugin-intro.png)

ja/develop-plugin/features-and-specs/advanced-development/customizable-model.mdx

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ dimensions:
77
standard_title: Customizable Model
88
language: ja
99
title: カスタムモデルの統合
10-
description: このドキュメントでは、Xinferenceモデルを例として、カスタムモデルをDifyに統合する方法を詳しく説明します。モデルプロバイダーファイルの作成、モデルタイプに基づくコードの記述、モデル呼び出しロジックの実装、例外処理、デバッグ、公開までの完全なプロセスをカバーしています。特に、LLM呼び出し、トークン計算、認証情報の検証、パラメータ生成などのコアメソッドの実装を詳しく説明します。
10+
description: このドキュメントでは、Xinferenceモデルを例として、カスタムモデルをDifyに統合する方法を詳しく説明します。モデルプロバイダーファイルの作成、モデルタイプに基づくコードの記述、モデル呼び出しロジックの実装、例外処理、デバッグ、公開までの完全なプロセスをカバーしています。特に、LLM呼び出し、token計算、認証情報の検証、パラメータ生成などのコアメソッドの実装を詳しく説明します。
1111
---
1212

1313
<Note> ⚠️ このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/develop-plugin/features-and-specs/advanced-development/customizable-model) を参照してください。</Note>
@@ -183,9 +183,9 @@ def _handle_sync_response(self, **kwargs) -> LLMResult:
183183
return LLMResult(**response)
184184
```
185185

186-
* **入力トークンの事前計算**
186+
* **入力tokenの事前計算**
187187

188-
モデルがトークンカウントインターフェースを提供していない場合は、単に0を返します:
188+
モデルがtokenカウントインターフェースを提供していない場合は、単に0を返します:
189189

190190
```python
191191
def get_num_tokens(
@@ -265,9 +265,7 @@ def get_customizable_model_schema(self, model: str, credentials: dict) -> AIMode
265265
)
266266
)
267267
268-
"""
269-
some NOT IMPORTANT code here
270-
"""
268+
# ... additional ParameterRule entries omitted for brevity ...
271269
272270
entity = AIModelEntity(
273271
model=model,

0 commit comments

Comments
 (0)