Skip to content

Commit aa0c2bc

Browse files
🌐 Sync PR #784 translations: docs: revamp develop-plugin section (#785)
* 🌐 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 * 🔄 Update translations for commit 626b116 Auto-generated translations for changes in commit 626b116. Last-Processed-Commit: 626b116 Original-PR: #784 Languages: Chinese (zh), Japanese (ja) 🤖 Generated with GitHub Actions * 🔄 Update translations for commit 30b5781 Auto-generated translations for changes in commit 30b5781. Last-Processed-Commit: 30b5781 Original-PR: #784 Languages: Chinese (zh), Japanese (ja) 🤖 Generated with GitHub Actions * 🔄 Update translations for commit 7bdfeb6 Auto-generated translations for changes in commit 7bdfeb6. Last-Processed-Commit: 7bdfeb6 Original-PR: #784 Languages: Chinese (zh), Japanese (ja) 🤖 Generated with GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent f06cf8d commit aa0c2bc

36 files changed

Lines changed: 688 additions & 549 deletions

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

Lines changed: 18 additions & 17 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>
@@ -8,7 +9,7 @@ title: エージェント戦略プラグイン
89

910
以下では、現在時刻を自動的に取得するための**Function Calling**をサポートするプラグインの開発方法を説明します。
1011

11-
### 前提条件
12+
## 前提条件
1213

1314
- Difyプラグインスキャフォールディングツール
1415
- Python環境(バージョン 3.12)
@@ -21,7 +22,7 @@ title: エージェント戦略プラグイン
2122

2223
---
2324

24-
### 1. プラグインテンプレートの初期化
25+
## 1. プラグインテンプレートの初期化
2526

2627
以下のコマンドを実行して、エージェントプラグインの開発テンプレートを作成します:
2728

@@ -90,14 +91,14 @@ Models:
9091
9192
---
9293
93-
### 2. プラグインの開発
94+
## 2. プラグインの開発
9495
9596
エージェント戦略プラグインの開発は、2つのファイルを中心に行われます:
9697
9798
- **プラグイン宣言**: `strategies/basic_agent.yaml`
9899
- **プラグイン実装**: `strategies/basic_agent.py`
99100
100-
#### 2.1 パラメータの定義
101+
### 2.1 パラメータの定義
101102
102103
エージェントプラグインを構築するには、まず`strategies/basic_agent.yaml`で必要なパラメータを指定します。これらのパラメータは、LLMの呼び出しやツールの使用など、プラグインのコア機能を定義します。
103104
@@ -106,7 +107,7 @@ Models:
106107
1. **model**: 呼び出す大規模言語モデル(例:GPT-4、GPT-4o-mini)。
107108
2. **tools**: プラグインの機能を拡張するツールのリスト。
108109
3. **query**: モデルに送信されるユーザー入力またはプロンプトの内容。
109-
4. **maximum_iterations**: 過度な計算を防ぐための最大反復回数
110+
4. **maximum_iterations**: 過度な計算を防ぐための最大イテレーション数
110111
111112
サンプルコード:
112113
@@ -162,7 +163,7 @@ extra:
162163
![エージェント戦略プラグインの UI](https://assets-docs.dify.ai/2025/01/d011e2eba4c37f07a9564067ba787df8.png)
163164
</Frame>
164165
165-
#### 2.2 パラメータの取得と実行
166+
### 2.2 パラメータの取得と実行
166167
167168
ユーザーがこれらの基本フィールドを入力した後、プラグインは送信されたパラメータを処理する必要があります。`strategies/basic_agent.py`で、エージェント用のパラメータクラスを定義し、ロジック内でこれらのパラメータを取得して適用します。
168169
@@ -188,7 +189,7 @@ class BasicAgentAgentStrategy(AgentStrategy):
188189
params = BasicParams(**parameters)
189190
```
190191
191-
### 3. モデルの呼び出し
192+
## 3. モデルの呼び出し
192193
193194
エージェント戦略プラグインでは、**モデルの呼び出し**がワークフローの中心です。SDKの`session.model.llm.invoke()`を使用して、テキスト生成、対話などを処理し、LLMを効率的に呼び出すことができます。
194195
@@ -223,7 +224,7 @@ def invoke(
223224
![ツール生成のためのリクエストパラメータ](https://assets-docs.dify.ai/2025/01/01e32c2d77150213c7c929b3cceb4dae.png)
224225
</Frame>
225226
226-
### 4. ツールの処理
227+
## 4. ツールの処理
227228
228229
ツールパラメータを指定した後、エージェント戦略プラグインは実際にこれらのツールを呼び出す必要があります。`session.tool.invoke()`を使用してこれらのリクエストを行います。
229230
@@ -267,7 +268,7 @@ for tool_call_id, tool_call_name, tool_call_args in tool_calls:
267268
![ツール呼び出し](https://assets-docs.dify.ai/2025/01/80e5de8acc2b0ed00524e490fd611ff5.png)
268269
</Frame>
269270
270-
### 5. ログの作成
271+
## 5. ログの作成
271272
272273
**エージェント戦略プラグイン**で複雑なタスクを完了するには、複数のステップが必要になることがよくあります。開発者が各ステップの結果を追跡し、意思決定プロセスを分析し、戦略を最適化することは非常に重要です。SDKの`create_log_message`と`finish_log_message`を使用することで、呼び出しの前後のリアルタイムの状態をログに記録し、迅速な問題診断に役立てることができます。
273274
@@ -330,7 +331,7 @@ model_log = self.create_log_message(
330331
yield model_log
331332
```
332333
333-
#### エージェントプラグイン機能のサンプルコード
334+
### エージェントプラグイン機能のサンプルコード
334335
335336
<Tabs>
336337
<Tab title="モデルの呼び出し">
@@ -1044,12 +1045,12 @@ class BasicAgentAgentStrategy(AgentStrategy):
10441045
</Tab>
10451046
</Tabs>
10461047
1047-
### 6. プラグインのデバッグ
1048+
## 6. プラグインのデバッグ
10481049
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`にコピーし、関連するリモートサーバーとデバッグキー情報を挿入します。
@@ -1072,7 +1073,7 @@ python -m main
10721073
![プラグインのブラウズ](https://assets-docs.dify.ai/2025/01/c82ec0202e5bf914b36e06c796398dd6.png)
10731074
</Frame>
10741075
1075-
### プラグインのパッケージング(オプション)
1076+
## プラグインのパッケージング(オプション)
10761077
10771078
すべてが正常に動作したら、以下を実行してプラグインをパッケージングできます:
10781079
@@ -1082,19 +1083,19 @@ python -m main
10821083
dify plugin package ./basic_agent/
10831084
```
10841085
1085-
現在のフォルダに`google.difypkg`()という名前のファイルが表示されます。これが最終的なプラグインパッケージです。
1086+
現在のフォルダに`basic_agent.difypkg`(プラグイン名と一致)という名前のファイルが表示されます。これが最終的なプラグインパッケージです。
10861087
10871088
**おめでとうございます!** エージェント戦略プラグインの開発、テスト、パッケージングが完了しました。
10881089
1089-
### プラグインの公開(オプション)
1090+
## プラグインの公開(オプション)
10901091
10911092
[Difyプラグインリポジトリ](https://github.com/langgenius/dify-plugins)にアップロードできます。その前に、[プラグイン公開ガイドライン](/ja/develop-plugin/publishing/marketplace-listing/release-to-dify-marketplace)を満たしていることを確認してください。承認されると、コードがメインブランチにマージされ、プラグインは自動的に[Dify Marketplace](https://marketplace.dify.ai/)で公開されます。
10921093
10931094
---
10941095
1095-
### さらなる探求
1096+
## さらなる探求
10961097
1097-
複雑なタスクには、複数ラウンドの思考とツール呼び出しが必要になることが多く、通常は**モデル呼び出し → ツール使用**をタスクが終了するか最大反復回数に達するまで繰り返します。このプロセスでは、プロンプトを効果的に管理することが重要です。[完全なFunction Calling実装](https://github.com/langgenius/dify-official-plugins/blob/main/agent-strategies/cot_agent/strategies/function_calling.py)を参照して、モデルが外部ツールを呼び出し、その出力を処理するための標準化されたアプローチを確認してください。
1098+
複雑なタスクには、複数ラウンドの思考とツール呼び出しが必要になることが多く、通常は**モデル呼び出し → ツール使用**をタスクが終了するか最大イテレーション数に達するまで繰り返します。このプロセスでは、プロンプトを効果的に管理することが重要です。[完全なFunction Calling実装](https://github.com/langgenius/dify-official-plugins/blob/main/agent-strategies/cot_agent/strategies/function_calling.py)を参照して、モデルが外部ツールを呼び出し、その出力を処理するための標準化されたアプローチを確認してください。
10981099
10991100
{/*
11001101
Contributing Section

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

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,25 +5,25 @@ dimensions:
55
detail: architecture
66
level: beginner
77
standard_title: Cheatsheet
8-
language: en
9-
title: Dify プラグイン開発チートシート
8+
language: ja
9+
title: チートシート
1010
description: 環境要件、インストール方法、開発プロセス、プラグインのカテゴリとタイプ、一般的なコードスニペット、よくある問題の解決策を含む、Dify プラグイン開発の包括的なリファレンスガイドです。開発者が素早く参照できるように設計されています。
1111
---
1212

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

15-
### 環境要件
15+
## 環境要件
1616

1717
- Python バージョン 3.12
1818
- Dify プラグインスキャフォールドツール (dify-plugin-daemon)
1919

2020
> 詳細: [開発ツールの初期化](/ja/develop-plugin/getting-started/cli)
2121
22-
### Dify プラグイン開発パッケージの取得
22+
## Dify プラグイン開発パッケージの取得
2323

2424
[Dify Plugin CLI](https://github.com/langgenius/dify-plugin-daemon/releases)
2525

26-
#### 各プラットフォームのインストール方法
26+
### 各プラットフォームのインストール方法
2727

2828
**macOS [Brew](https://github.com/langgenius/homebrew-dify) (グローバルインストール)**
2929

@@ -68,13 +68,13 @@ sudo mv dify /usr/local/bin/
6868
dify version
6969
```
7070

71-
### 開発パッケージの実行
71+
## 開発パッケージの実行
7272

7373
ここでは `dify` を例として使用します。ローカルインストール方法を使用している場合は、コマンドを適宜置き換えてください。例: `./dify-plugin-darwin-arm64 plugin init`
7474

75-
### プラグイン開発プロセス
75+
## プラグイン開発プロセス
7676

77-
#### 1. 新しいプラグインの作成
77+
### 1. 新しいプラグインの作成
7878

7979
```bash
8080
./dify plugin init
@@ -84,7 +84,7 @@ dify version
8484

8585
> 詳細: [Dify プラグイン開発: Hello World ガイド](/ja/develop-plugin/dev-guides-and-walkthroughs/tool-plugin)
8686
87-
#### 2. 開発モードで実行
87+
### 2. 開発モードで実行
8888

8989
`.env` ファイルを設定し、プラグインディレクトリで以下のコマンドを実行します:
9090

@@ -94,7 +94,7 @@ python -m main
9494

9595
> 詳細: [プラグインのリモートデバッグ](/ja/develop-plugin/features-and-specs/plugin-types/remote-debug-a-plugin)
9696
97-
#### 3. パッケージングとデプロイ
97+
### 3. パッケージングとデプロイ
9898

9999
プラグインをパッケージ化:
100100

@@ -105,9 +105,9 @@ dify plugin package ./yourapp
105105

106106
> 詳細: [公開の概要](/ja/develop-plugin/publishing/marketplace-listing/release-overview)
107107
108-
### プラグインカテゴリ
108+
## プラグインカテゴリ
109109

110-
#### ツールラベル
110+
### ツールラベル
111111

112112
カテゴリ `tag` [class ToolLabelEnum(Enum)](https://github.com/langgenius/dify-plugin-sdks/blob/main/python/dify_plugin/entities/tool.py)
113113

@@ -131,7 +131,7 @@ class ToolLabelEnum(Enum):
131131
OTHER = "other"
132132
```
133133

134-
### プラグインタイプリファレンス
134+
## プラグインタイプリファレンス
135135

136136
Dify は様々なタイプのプラグイン開発をサポートしています:
137137

@@ -141,10 +141,10 @@ Dify は様々なタイプのプラグイン開発をサポートしています
141141
- **モデルプラグイン**: AI モデルを統合
142142
> 詳細: [モデルプラグイン](/ja/develop-plugin/features-and-specs/plugin-types/model-designing-rules)[新しいモデルのクイック統合](/ja/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider)
143143
144-
- **エージェント戦略プラグイン**エージェントの思考と意思決定戦略をカスタマイズ
144+
- **エージェント戦略プラグイン**Agent の思考と意思決定戦略をカスタマイズ
145145
> 詳細: [エージェント戦略プラグイン](/ja/develop-plugin/features-and-specs/advanced-development/reverse-invocation)
146146
147-
- **拡張プラグイン**: Endpoints や WebAPP など、Dify プラットフォームの機能を拡張
147+
- **拡張プラグイン**: Endpoints や WebApp など、Dify プラットフォームの機能を拡張
148148
> 詳細: [拡張プラグイン](/ja/develop-plugin/dev-guides-and-walkthroughs/endpoint)
149149
150150
- **データソースプラグイン**: ナレッジベースパイプラインのドキュメントデータソースおよび開始点として機能

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

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@ dimensions:
55
detail: standard
66
level: intermediate
77
standard_title: Model Provider Plugin
8-
language: en
8+
language: ja
99
title: モデルプロバイダープラグイン
1010
description: この包括的なガイドでは、モデルプロバイダープラグインの作成について詳細な手順を提供し、プロジェクトの初期化、ディレクトリ構造の編成、モデル構成方法、プロバイダーコードの記述、およびコア API 実装の詳細な例を含むモデル統合の実装について説明します。
1111
---
1212

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

15-
### 前提条件
15+
## 前提条件
1616

1717
* [Dify CLI](/ja/develop-plugin/getting-started/cli)
1818
* 基本的な Python プログラミングスキルとオブジェクト指向プログラミングの理解
@@ -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>

0 commit comments

Comments
 (0)