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
1 change: 1 addition & 0 deletions en/self-host/deploy/configuration/environments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -1510,6 +1510,7 @@ The plugin daemon is a separate service that manages plugin lifecycle (installat
| `PLUGIN_DAEMON_TIMEOUT` | `600.0` | Timeout in seconds for all plugin daemon requests (installation, execution, listing). |
| `PLUGIN_MAX_PACKAGE_SIZE` | `52428800` | Maximum plugin package size in bytes (50 MB). Validated during marketplace downloads. |
| `PLUGIN_MODEL_SCHEMA_CACHE_TTL` | `3600` | How long to cache plugin model schemas in seconds. Reduces repeated lookups. |
| `PLUGIN_MODEL_PROVIDERS_CACHE_ENABLED` | `true` | Whether each tenant's plugin model provider list is cached in Redis at all. Disable when plugins are installed by an external system that can't invalidate this deployment's cache when a tenant's plugins change. |
| `PLUGIN_MODEL_PROVIDERS_CACHE_TTL` | `86400` | How long to cache each tenant's plugin model provider list in Redis, in seconds (24 hours). Dify invalidates this cache when a tenant installs, uninstalls, or upgrades a plugin. |
| `PLUGIN_DIFY_INNER_API_KEY` | (auto-generated) | API key the plugin daemon uses to call back to the Dify API. Must match `DIFY_INNER_API_KEY` in the plugin daemon service config. |
| `INNER_API_KEY_FOR_PLUGIN` | (pre-filled in the env example; replace for production) | The API-service side of the same secret, under its direct name from `docker/envs/core-services/`; in the Compose stack `PLUGIN_DIFY_INNER_API_KEY` feeds both sides.<br/>The API checks it on every plugin callback (model invocation, tool calls, file transfer). On mismatch those calls fail while plugin install keeps working.<br/>Replace the shipped default: it is public in the Dify repo and is the only auth on the plugin callback API. |
Expand Down
4 changes: 2 additions & 2 deletions en/self-host/use-dify/build/new-agent/build.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,11 @@ Community Edition uses file-access controls to limit access to agent and session
If your deployment requires strong isolation or strict security or compliance controls, use separately hardened infrastructure or contact Dify to assess an appropriate Cloud or Enterprise option. For Dify Enterprise, [contact sales](https://share-na2.hsforms.com/14-09ff5HS92Sh4m3f4yrcw40s9fk) to learn more.
</Warning>

<Tip>
<Info>
The new Agent is in beta. It's on by default on Docker Compose, with its runtime bundled in.

For production, replace [`DIFY_AGENT_SERVER_SECRET_KEY`](/en/self-host/deploy/configuration/environments#dify_agent_server_secret_key) and [`DIFY_AGENT_API_TOKEN`](/en/self-host/deploy/configuration/environments#dify_agent_api_token) with your own random values.
</Tip>
</Info>

## Create an Agent

Expand Down
4 changes: 2 additions & 2 deletions en/self-host/use-dify/build/new-agent/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,11 @@ Community Edition uses file-access controls to limit access to agent and session
If your deployment requires strong isolation or strict security or compliance controls, use separately hardened infrastructure or contact Dify to assess an appropriate Cloud or Enterprise option. For Dify Enterprise, [contact sales](https://share-na2.hsforms.com/14-09ff5HS92Sh4m3f4yrcw40s9fk) to learn more.
</Warning>

<Tip>
<Info>
The new Agent is in beta. It's on by default on Docker Compose, with its runtime bundled in.

For production, replace [`DIFY_AGENT_SERVER_SECRET_KEY`](/en/self-host/deploy/configuration/environments#dify_agent_server_secret_key) and [`DIFY_AGENT_API_TOKEN`](/en/self-host/deploy/configuration/environments#dify_agent_api_token) with your own random values.
</Tip>
</Info>

An *Agent* is an AI worker you set up once and then put to work. It's a different kind of agent than the [classic Agent app](/en/self-host/use-dify/build/agent):

Expand Down
16 changes: 6 additions & 10 deletions en/self-host/use-dify/nodes/agent.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,6 @@ title: Agent
description: Run an agent as a step in your workflow, reasoning and using tools to complete a task
---

<Tip>
The new Agent node is in beta. It's on by default on Docker Compose, with its runtime bundled in.

For production, replace [`DIFY_AGENT_SERVER_SECRET_KEY`](/en/self-host/deploy/configuration/environments#dify_agent_server_secret_key) and [`DIFY_AGENT_API_TOKEN`](/en/self-host/deploy/configuration/environments#dify_agent_api_token) with your own random values.
</Tip>

<Tabs>
<Tab title="Classic Agent">
The classic Agent node gives your LLM autonomous control over tools, enabling it to iteratively decide which tools to use and when to use them. Instead of pre-planning every step, the Agent reasons through problems dynamically, calling tools as needed to complete complex tasks.
Expand Down Expand Up @@ -125,6 +119,12 @@ description: Run an agent as a step in your workflow, reasoning and using tools

<Tab title="New Agent">

<Info>
The new Agent node is in beta and available in Workflow apps only. It's on by default on Docker Compose, with its runtime bundled in.

For production, replace [`DIFY_AGENT_SERVER_SECRET_KEY`](/en/self-host/deploy/configuration/environments#dify_agent_server_secret_key) and [`DIFY_AGENT_API_TOKEN`](/en/self-host/deploy/configuration/environments#dify_agent_api_token) with your own random values.
</Info>

<Warning>
**Data Security Notice**

Expand All @@ -137,10 +137,6 @@ description: Run an agent as a step in your workflow, reasoning and using tools

You pick the agent and tell it what to do; it works through the task on its own and hands the results back to the rest of the flow.

<Info>
The new Agent node is available in Workflow apps only.
</Info>

## Choose an Agent

When you add the node, pick who does the work:
Expand Down
1 change: 1 addition & 0 deletions ja/self-host/deploy/configuration/environments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -1500,6 +1500,7 @@ HTTPS を有効化した後、 [共通変数](#共通変数) の URL 変数(
| `PLUGIN_DAEMON_TIMEOUT` | `600.0` | すべてのプラグインデーモンリクエスト(インストール、実行、リスト表示)のタイムアウト(秒)。 |
| `PLUGIN_MAX_PACKAGE_SIZE` | `52428800` | プラグインパッケージの最大サイズ(バイト、50 MB)。マーケットプレイスダウンロード時に検証されます。 |
| `PLUGIN_MODEL_SCHEMA_CACHE_TTL` | `3600` | プラグインモデルスキーマのキャッシュ期間(秒)。繰り返しの参照を削減します。 |
| `PLUGIN_MODEL_PROVIDERS_CACHE_ENABLED` | `true` | 各テナントのプラグインモデルプロバイダー一覧を Redis にキャッシュするかどうか。プラグインを外部システムからインストールしていて、テナントのプラグイン変更時にこのデプロイのキャッシュを無効化できない場合は無効にします。 |
| `PLUGIN_MODEL_PROVIDERS_CACHE_TTL` | `86400` | 各テナントのプラグインモデルプロバイダー一覧を Redis にキャッシュする期間(秒)。デフォルトは 24 時間。テナントがプラグインをインストール、アンインストール、またはアップグレードすると、Dify はこのキャッシュを無効化します。 |
| `PLUGIN_DIFY_INNER_API_KEY` | (自動生成) | プラグインデーモンが Dify API にコールバックする際に使用する API キー。プラグインデーモンサービス設定の `DIFY_INNER_API_KEY` と一致する必要があります。 |
| `INNER_API_KEY_FOR_PLUGIN` | (env サンプルにデフォルト値あり。本番では必ず変更) | 同じシークレットの API サービス側の直接名(`docker/envs/core-services/` 由来)。Compose 構成では `PLUGIN_DIFY_INNER_API_KEY` が両側に反映されます。<br/>API はプラグインからのコールバック(モデル呼び出し、ツール呼び出し、ファイル転送)ごとにこのキーを検証します。不一致だとこれらの呼び出しは失敗しますが、プラグインのインストールは動作します。<br/>デフォルト値は Dify リポジトリで公開されており、コールバック API の唯一の認証手段のため、必ず変更してください。 |
Expand Down
4 changes: 2 additions & 2 deletions ja/self-host/use-dify/build/new-agent/build.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ Community Edition では、同一の Agent を複数のエンドユーザーに
強力な隔離や、厳格なセキュリティおよびコンプライアンス管理を必要とするデプロイでは、別途セキュリティを強化したインフラ環境をご利用いただくか、Cloud / Enterprise プランをご検討ください。Enterprise プランの詳細は、[営業へのお問い合わせ](https://share-na2.hsforms.com/176RpklY3TLeHo6qmuAdRKQ40s9fk) よりご連絡ください。
</Warning>

<Tip>
<Info>
新しい Agent は Community Edition のベータ機能です。ランタイムは Docker Compose デプロイに同梱され、デフォルトで有効です。

本番環境では、[`DIFY_AGENT_SERVER_SECRET_KEY`](/ja/self-host/deploy/configuration/environments#dify_agent_server_secret_key) と [`DIFY_AGENT_API_TOKEN`](/ja/self-host/deploy/configuration/environments#dify_agent_api_token) を独自のランダムな値に置き換えてください。
</Tip>
</Info>

## Agent の作成

Expand Down
4 changes: 2 additions & 2 deletions ja/self-host/use-dify/build/new-agent/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ Community Edition では、同一の Agent を複数のエンドユーザーに
強力な隔離や、厳格なセキュリティおよびコンプライアンス管理を必要とするデプロイでは、別途セキュリティを強化したインフラ環境をご利用いただくか、Cloud / Enterprise プランをご検討ください。Enterprise プランの詳細は、[営業へのお問い合わせ](https://share-na2.hsforms.com/176RpklY3TLeHo6qmuAdRKQ40s9fk) よりご連絡ください。
</Warning>

<Tip>
<Info>
新しい Agent は Community Edition のベータ機能です。ランタイムは Docker Compose デプロイに同梱され、デフォルトで有効です。

本番環境では、[`DIFY_AGENT_SERVER_SECRET_KEY`](/ja/self-host/deploy/configuration/environments#dify_agent_server_secret_key) と [`DIFY_AGENT_API_TOKEN`](/ja/self-host/deploy/configuration/environments#dify_agent_api_token) を独自のランダムな値に置き換えてください。
</Tip>
</Info>

「Agent」は、一度セットアップすれば仕事を任せられる AI ワーカーです。[クラシック Agent アプリ](/ja/self-host/use-dify/build/agent) とは異なる、次の特徴を持つ Agent です:

Expand Down
16 changes: 6 additions & 10 deletions ja/self-host/use-dify/nodes/agent.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,6 @@ description: "ワークフローの 1 ステップとして Agent を実行し

> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/self-host/use-dify/nodes/agent) を参照してください。

<Tip>
新しい Agent ノードはベータ版です。ランタイムは Docker Compose デプロイに同梱され、デフォルトで有効です。

本番環境では、[`DIFY_AGENT_SERVER_SECRET_KEY`](/ja/self-host/deploy/configuration/environments#dify_agent_server_secret_key) と [`DIFY_AGENT_API_TOKEN`](/ja/self-host/deploy/configuration/environments#dify_agent_api_token) を独自のランダムな値に置き換えてください。
</Tip>

<Tabs>
<Tab title="クラシック Agent">
エージェントノードは、LLM にツールの自律的な制御権を与え、どのツールをいつ使用するかを反復的に決定できるようにします。すべてのステップを事前に計画する代わりに、エージェントは問題を動的に推論し、複雑なタスクを完了するために必要に応じてツールを呼び出します。
Expand Down Expand Up @@ -127,6 +121,12 @@ description: "ワークフローの 1 ステップとして Agent を実行し

<Tab title="新しい Agent">

<Info>
新しい Agent ノードはベータ版で、Workflow アプリでのみ使用できます。ランタイムは Docker Compose デプロイに同梱され、デフォルトで有効です。

本番環境では、[`DIFY_AGENT_SERVER_SECRET_KEY`](/ja/self-host/deploy/configuration/environments#dify_agent_server_secret_key) と [`DIFY_AGENT_API_TOKEN`](/ja/self-host/deploy/configuration/environments#dify_agent_api_token) を独自のランダムな値に置き換えてください。
</Info>

<Warning>
**データセキュリティに関する注意**

Expand All @@ -139,10 +139,6 @@ description: "ワークフローの 1 ステップとして Agent を実行し

Agent を選んで、やるべきことを伝えるだけです。Agent は自力でタスクをこなし、結果をフローの続きに返します。

<Info>
新しい Agent ノードは Workflow アプリでのみ使用できます。
</Info>

## Agent の選択

ノードを追加したら、仕事の担い手を選びます:
Expand Down
1 change: 1 addition & 0 deletions zh/self-host/deploy/configuration/environments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -1504,6 +1504,7 @@ API 访问 Agent 后端所用的地址。在 Docker Compose 中保持默认值
| `PLUGIN_DAEMON_TIMEOUT` | `600.0` | 所有插件守护进程请求(安装、执行、列表)的超时时间(秒)。 |
| `PLUGIN_MAX_PACKAGE_SIZE` | `52428800` | 最大插件包大小(字节,50 MB)。在市场下载时验证。 |
| `PLUGIN_MODEL_SCHEMA_CACHE_TTL` | `3600` | 缓存插件模型 Schema 的时间(秒)。减少重复查找。 |
| `PLUGIN_MODEL_PROVIDERS_CACHE_ENABLED` | `true` | 是否在 Redis 中缓存各租户的插件模型供应商列表。当插件由外部系统安装、无法在租户插件变更时使本部署的缓存失效时,应关闭此项。 |
| `PLUGIN_MODEL_PROVIDERS_CACHE_TTL` | `86400` | 在 Redis 中缓存各租户插件模型供应商列表的时长(秒),默认 24 小时。租户安装、卸载或升级插件时,Dify 会使该缓存失效。 |
| `PLUGIN_DIFY_INNER_API_KEY` | (自动生成) | 插件守护进程回调 Dify API 使用的 API key。必须与插件守护进程服务配置中的 `DIFY_INNER_API_KEY` 匹配。 |
| `INNER_API_KEY_FOR_PLUGIN` | (env 示例中已预填;生产环境必须更换) | 同一密钥在 API 服务侧的直接变量名,来自 `docker/envs/core-services/`;Compose 部署中由 `PLUGIN_DIFY_INNER_API_KEY` 同时写入两侧。<br/>API 在每次插件回调(模型调用、工具调用、文件传输)时校验该密钥,两侧不一致时这些调用会失败,但插件安装不受影响。<br/>务必更换预填的默认值:它公开在 Dify 仓库中,而且是插件回调 API 唯一的鉴权手段。 |
Expand Down
4 changes: 2 additions & 2 deletions zh/self-host/use-dify/build/new-agent/build.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ description: 创建 Agent 并塑造它的能力,可逐项手动配置,也可
如果部署场景要求强隔离或严格的安全、合规控制,应采用单独加固的基础设施,或联系 Dify 评估适当的 Cloud 或 Enterprise 方案。Enterprise 方案详情,可 [联系销售](https://share-na2.hsforms.com/1O3Rajx4URXm88UzneXYpCw40s9fk) 咨询。
</Warning>

<Tip>
<Info>
新 Agent 目前处于 Beta 阶段。它在 Docker Compose 部署中默认启用,运行时也已随部署打包。

生产环境使用前,将 [`DIFY_AGENT_SERVER_SECRET_KEY`](/zh/self-host/deploy/configuration/environments#dify_agent_server_secret_key) 和 [`DIFY_AGENT_API_TOKEN`](/zh/self-host/deploy/configuration/environments#dify_agent_api_token) 替换为你自己的随机值。
</Tip>
</Info>

## 创建 Agent

Expand Down
4 changes: 2 additions & 2 deletions zh/self-host/use-dify/build/new-agent/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ description: 构建一次 Agent,既可作为独立应用使用,也可嵌入
如果部署场景要求强隔离或严格的安全、合规控制,应采用单独加固的基础设施,或联系 Dify 评估适当的 Cloud 或 Enterprise 方案。Enterprise 方案详情,可 [联系销售](https://share-na2.hsforms.com/1O3Rajx4URXm88UzneXYpCw40s9fk) 咨询。
</Warning>

<Tip>
<Info>
新 Agent 目前处于 Beta 阶段。它在 Docker Compose 部署中默认启用,运行时也已随部署打包。

生产环境使用前,将 [`DIFY_AGENT_SERVER_SECRET_KEY`](/zh/self-host/deploy/configuration/environments#dify_agent_server_secret_key) 和 [`DIFY_AGENT_API_TOKEN`](/zh/self-host/deploy/configuration/environments#dify_agent_api_token) 替换为你自己的随机值。
</Tip>
</Info>

Agent 是一名 AI 员工:设置一次,之后随时给它派活。它与 [经典 Agent 应用](/zh/self-host/use-dify/build/agent) 是不同类型的 Agent:

Expand Down
16 changes: 6 additions & 10 deletions zh/self-host/use-dify/nodes/agent.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,6 @@ description: 将 Agent 作为工作流中的一步运行,通过推理和调用

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

<Tip>
新 Agent 节点目前处于 Beta 阶段。它在 Docker Compose 部署中默认启用,运行时也已随部署打包。

生产环境使用前,将 [`DIFY_AGENT_SERVER_SECRET_KEY`](/zh/self-host/deploy/configuration/environments#dify_agent_server_secret_key) 和 [`DIFY_AGENT_API_TOKEN`](/zh/self-host/deploy/configuration/environments#dify_agent_api_token) 替换为你自己的随机值。
</Tip>

<Tabs>
<Tab title="经典 Agent">
Agent 节点让你的大型语言模型自主控制工具,使其能够迭代决定使用哪些工具以及何时使用它们。Agent 不是预先规划每一步,而是动态地推理问题,根据需要调用工具来完成复杂任务。
Expand Down Expand Up @@ -127,6 +121,12 @@ description: 将 Agent 作为工作流中的一步运行,通过推理和调用

<Tab title="新 Agent">

<Info>
新 Agent 节点目前处于 Beta 阶段,仅在 Workflow 应用中可用。它在 Docker Compose 部署中默认启用,运行时也已随部署打包。

生产环境使用前,将 [`DIFY_AGENT_SERVER_SECRET_KEY`](/zh/self-host/deploy/configuration/environments#dify_agent_server_secret_key) 和 [`DIFY_AGENT_API_TOKEN`](/zh/self-host/deploy/configuration/environments#dify_agent_api_token) 替换为你自己的随机值。
</Info>

<Warning>
**数据安全提示**

Expand All @@ -139,10 +139,6 @@ description: 将 Agent 作为工作流中的一步运行,通过推理和调用

你选定 Agent 并告诉它要做什么;它自主完成任务,再把结果交还给流程的其余部分。

<Info>
新 Agent 节点仅在 Workflow 应用中可用。
</Info>

## 选择 Agent

添加节点时,先选定由谁来干活:
Expand Down
Loading