Skip to content

Commit c8a06a0

Browse files
RiskeyLclaude
andcommitted
docs: update self-host docs for Integrations navigation redesign
Align self-host documentation with the 1.15.0 navigation optimization: - Regroup docs.json: new Integrations section (Model Provider, Tools, Custom Endpoint); Workspace shrunk to admin-only pages - Reframe plugins.mdx as Integrations Overview with hub type list, permissions, and EE callout - Merge standalone MCP page into tools.mdx MCP Tool tab; delete build/mcp.mdx (en/zh/ja) - Rename all Settings > Model Provider nav paths to Integrations > Model Provider; Default Model Settings to Default Models; API Extension to Custom Endpoint; Logs & Annotations split into separate Logs and Annotations - Update trigger overview and webhook-trigger: Plugin Trigger to Integration Trigger; enable/disable moved to Monitoring > Triggers - Soften concept-level "plugin" references to "integration" across workspace, knowledge, and build pages - Update glossary and writing guides for new terminology - Fix broken bold markers in self-host zh/ja files (same repo-wide fix as prior commit, for files that also had content changes) Excludes the plugin-trigger.mdx en rewrite (pending review). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 22e55a5 commit c8a06a0

120 files changed

Lines changed: 664 additions & 1096 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.claude/skills/dify-docs-guides/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,7 @@ This is a team effort. The user brings documentation expertise and user empathy;
5353
- For existing features: verify against the `main` branch of the Dify codebase. The user will provide the codebase path or it will be configured as an additional working directory.
5454
- For new features: the user may specify a development branch. Code may be in flux—when behavior is ambiguous, ask rather than assume.
5555
- Trust the codebase over existing documentation. Existing docs may be outdated or inaccurate.
56+
- **When rewriting an existing page, re-verify every claim you carry over** (permissions, defaults, option lists, navigation paths, behavior). Treat the original page as unverified and confirm each fact against the code before keeping it. The most common failure mode is faithfully reproducing an outdated section.
5657
- **Code presence ≠ working feature.** A code path existing does not guarantee the feature functions end to end. When behavior is inferred from code analysis rather than observed in the running product, flag it as unverified and ask the user to test before documenting it as fact.
5758

5859
## Environment Variables in User Guides

docs.json

Lines changed: 42 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -541,7 +541,6 @@
541541
]
542542
},
543543
"en/self-host/use-dify/build/shortcut-key",
544-
"en/self-host/use-dify/build/mcp",
545544
"en/self-host/use-dify/build/version-control",
546545
"en/self-host/use-dify/build/workflow-collaboration",
547546
{
@@ -673,25 +672,32 @@
673672
"icon": "book"
674673
},
675674
{
676-
"group": "Workspace",
675+
"group": "Integrations",
676+
"icon": "plug",
677677
"expanded": false,
678678
"pages": [
679-
"en/self-host/use-dify/workspace/readme",
680-
"en/self-host/use-dify/workspace/model-providers",
681679
"en/self-host/use-dify/workspace/plugins",
680+
"en/self-host/use-dify/workspace/model-providers",
682681
"en/self-host/use-dify/workspace/tools",
683-
"en/self-host/use-dify/workspace/app-management",
684-
"en/self-host/use-dify/workspace/team-members-management",
685-
"en/self-host/use-dify/workspace/personal-account-management",
686682
{
687-
"group": "API Extension",
683+
"group": "Custom Endpoint",
688684
"pages": [
689685
"en/self-host/use-dify/workspace/api-extension/api-extension",
690686
"en/self-host/use-dify/workspace/api-extension/external-data-tool-api-extension",
691687
"en/self-host/use-dify/workspace/api-extension/moderation-api-extension",
692688
"en/self-host/use-dify/workspace/api-extension/cloudflare-worker"
693689
]
694690
}
691+
]
692+
},
693+
{
694+
"group": "Workspace",
695+
"expanded": false,
696+
"pages": [
697+
"en/self-host/use-dify/workspace/readme",
698+
"en/self-host/use-dify/workspace/app-management",
699+
"en/self-host/use-dify/workspace/team-members-management",
700+
"en/self-host/use-dify/workspace/personal-account-management"
695701
],
696702
"icon": "briefcase"
697703
}
@@ -1424,7 +1430,6 @@
14241430
]
14251431
},
14261432
"zh/self-host/use-dify/build/shortcut-key",
1427-
"zh/self-host/use-dify/build/mcp",
14281433
"zh/self-host/use-dify/build/version-control",
14291434
"zh/self-host/use-dify/build/workflow-collaboration",
14301435
{
@@ -1556,25 +1561,32 @@
15561561
"icon": "book"
15571562
},
15581563
{
1559-
"group": "工作空间",
1564+
"group": "集成",
1565+
"icon": "plug",
15601566
"expanded": false,
15611567
"pages": [
1562-
"zh/self-host/use-dify/workspace/readme",
1563-
"zh/self-host/use-dify/workspace/model-providers",
15641568
"zh/self-host/use-dify/workspace/plugins",
1569+
"zh/self-host/use-dify/workspace/model-providers",
15651570
"zh/self-host/use-dify/workspace/tools",
1566-
"zh/self-host/use-dify/workspace/app-management",
1567-
"zh/self-host/use-dify/workspace/team-members-management",
1568-
"zh/self-host/use-dify/workspace/personal-account-management",
15691571
{
1570-
"group": "API 扩展",
1572+
"group": "自定义端点",
15711573
"pages": [
15721574
"zh/self-host/use-dify/workspace/api-extension/api-extension",
15731575
"zh/self-host/use-dify/workspace/api-extension/external-data-tool-api-extension",
15741576
"zh/self-host/use-dify/workspace/api-extension/moderation-api-extension",
15751577
"zh/self-host/use-dify/workspace/api-extension/cloudflare-worker"
15761578
]
15771579
}
1580+
]
1581+
},
1582+
{
1583+
"group": "工作空间",
1584+
"expanded": false,
1585+
"pages": [
1586+
"zh/self-host/use-dify/workspace/readme",
1587+
"zh/self-host/use-dify/workspace/app-management",
1588+
"zh/self-host/use-dify/workspace/team-members-management",
1589+
"zh/self-host/use-dify/workspace/personal-account-management"
15781590
],
15791591
"icon": "briefcase"
15801592
}
@@ -2299,7 +2311,6 @@
22992311
]
23002312
},
23012313
"ja/self-host/use-dify/build/shortcut-key",
2302-
"ja/self-host/use-dify/build/mcp",
23032314
"ja/self-host/use-dify/build/version-control",
23042315
"ja/self-host/use-dify/build/workflow-collaboration",
23052316
{
@@ -2431,25 +2442,32 @@
24312442
"icon": "book"
24322443
},
24332444
{
2434-
"group": "ワークスペース",
2445+
"group": "統合",
2446+
"icon": "plug",
24352447
"expanded": false,
24362448
"pages": [
2437-
"ja/self-host/use-dify/workspace/readme",
2438-
"ja/self-host/use-dify/workspace/model-providers",
24392449
"ja/self-host/use-dify/workspace/plugins",
2450+
"ja/self-host/use-dify/workspace/model-providers",
24402451
"ja/self-host/use-dify/workspace/tools",
2441-
"ja/self-host/use-dify/workspace/app-management",
2442-
"ja/self-host/use-dify/workspace/team-members-management",
2443-
"ja/self-host/use-dify/workspace/personal-account-management",
24442452
{
2445-
"group": "API 拡張",
2453+
"group": "カスタム API",
24462454
"pages": [
24472455
"ja/self-host/use-dify/workspace/api-extension/api-extension",
24482456
"ja/self-host/use-dify/workspace/api-extension/external-data-tool-api-extension",
24492457
"ja/self-host/use-dify/workspace/api-extension/moderation-api-extension",
24502458
"ja/self-host/use-dify/workspace/api-extension/cloudflare-worker"
24512459
]
24522460
}
2461+
]
2462+
},
2463+
{
2464+
"group": "ワークスペース",
2465+
"expanded": false,
2466+
"pages": [
2467+
"ja/self-host/use-dify/workspace/readme",
2468+
"ja/self-host/use-dify/workspace/app-management",
2469+
"ja/self-host/use-dify/workspace/team-members-management",
2470+
"ja/self-host/use-dify/workspace/personal-account-management"
24532471
],
24542472
"icon": "briefcase"
24552473
}

en/self-host/deploy/overview.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ mode: "frame"
5353

5454
<div className="mt-10">
5555
<Tip>
56-
On Dify Enterprise, you can deploy on Kubernetes for high availability, with SSO and multi-workspace management. For more information, [contact sales](https://udify.app/chat/QuwcpW1oBNcfeL55).
56+
On Dify Enterprise, you can deploy on Kubernetes for high availability, with SSO and multi-workspace management. [Contact sales](https://udify.app/chat/QuwcpW1oBNcfeL55) to learn more.
5757
</Tip>
5858
</div>
5959
</div>

en/self-host/use-dify/build/additional-features.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ Click **Settings** to pick the model that generates the questions, or write a cu
5252
Convert AI responses to audio. You can configure the language and voice to match your app's audience, and enable **Auto Play** to stream audio automatically as the AI responds.
5353

5454
<Info>
55-
**Text to Speech** uses your workspace's text-to-speech model (set in **Settings** > **Model Provider** > **Default Model Settings**).
55+
**Text to Speech** uses your workspace's text-to-speech model (set in **Integrations** > **Model Provider** > **Default Models**).
5656

5757
The feature only appears in the **Features** panel when a default TTS model is configured.
5858
</Info>
@@ -62,7 +62,7 @@ The feature only appears in the **Features** panel when a default TTS model is c
6262
Enable voice input for the chat interface. When enabled, your end users can dictate messages instead of typing by clicking the microphone button.
6363

6464
<Info>
65-
**Speech to Text** uses your workspace's speech-to-text model (set in **Settings** > **Model Provider** > **Default Model Settings**).
65+
**Speech to Text** uses your workspace's speech-to-text model (set in **Integrations** > **Model Provider** > **Default Models**).
6666

6767
The feature only appears in the **Features** panel when a default STT model is configured.
6868
</Info>
@@ -96,7 +96,7 @@ Filter inappropriate content in user inputs, AI outputs, or both. Choose a moder
9696

9797
- **Keywords**: Define a list of blocked terms. Any match triggers the preset response.
9898

99-
- **API Extension**: Connect a custom moderation endpoint for your own filtering logic.
99+
- **Custom Endpoint**: Connect a custom moderation endpoint for your own filtering logic.
100100

101101
When content is flagged, the app replaces it with a preset response that you define.
102102

@@ -116,7 +116,7 @@ To create and manage your annotations:
116116
![Add Annotation Icon](/images/use-dify/workflow/add-annotation-icon.png)
117117
</Frame>
118118

119-
- In the **Logs & Annotations** > **Annotations** tab, manually add new Q&A pairs, manage existing annotations, and view hit history. Click `...` to bulk import or bulk export.
119+
- In **Annotations**, manually add new Q&A pairs, manage existing annotations, and view hit history. Click `...` to bulk import or bulk export.
120120

121121
<Frame>
122122
![Bulk Annotation Operation](/images/use-dify/workflow/bulk-annotation-operation.png)

en/self-host/use-dify/build/agent.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ Choose the variable type that matches the input you expect:
7474
<Tab title="API-based Variable">
7575
Fetches variable values from an external API at runtime instead of collecting them from users.
7676

77-
Use it when your prompt needs dynamic data from an external source, such as live weather conditions or database records. See [API Extension](/en/self-host/use-dify/workspace/api-extension/api-extension) for details.
77+
Use it when your prompt needs dynamic data from an external source, such as live weather conditions or database records. See [Custom Endpoints](/en/self-host/use-dify/workspace/api-extension/api-extension) for details.
7878
</Tab>
7979
</Tabs>
8080

@@ -103,7 +103,7 @@ The model decides when and which tools to use based on each query. To guide this
103103
You can disable or remove added tools, and modify their configuration. If a tool requires authentication, select an existing credential or create a new one.
104104

105105
<Info>
106-
To change the default credential, go to **Tools** or **Plugins**.
106+
To change the default credential, go to **Integrations** > **Tools** > **Tool Plugin**.
107107
</Info>
108108

109109
#### Maximum Iterations

en/self-host/use-dify/build/chatbot.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ Choose the variable type that matches the input you expect:
6767
<Tab title="API-based Variable">
6868
Fetches variable values from an external API at runtime instead of collecting them from users.
6969

70-
Use it when your prompt needs dynamic data from an external source, such as live weather conditions or database records. See [API Extension](/en/self-host/use-dify/workspace/api-extension/api-extension) for details.
70+
Use it when your prompt needs dynamic data from an external source, such as live weather conditions or database records. See [Custom Endpoints](/en/self-host/use-dify/workspace/api-extension/api-extension) for details.
7171
</Tab>
7272
</Tabs>
7373

en/self-host/use-dify/build/goto-anything.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Type a keyword to search all supported resources. Results are grouped by categor
1414
Use the commands below to narrow the scope:
1515

1616
- `@app` – search your applications
17-
- `@plugin` – search or install plugins
17+
- `@plugin` – search or install integrations
1818
- `@kb` or `@knowledge` – search knowledge bases
1919
- `@node` – search nodes in the current workflow (available only when a workflow is open)
2020

@@ -25,7 +25,7 @@ Navigate results with the arrow keys and press `Enter` to open the selected item
2525
Try these scoped searches to jump straight to what you need:
2626

2727
- `@app analytics` – open an app whose name contains "analytics"
28-
- `@plugin slack` – go to the Slack plugin
28+
- `@plugin slack` – go to the Slack integration
2929
- `@kb company handbook` – look up a knowledge base titled "company handbook"
3030
- `@node summary` – locate a node named "summary" in the current workflow
3131

en/self-host/use-dify/build/mcp.mdx

Lines changed: 0 additions & 115 deletions
This file was deleted.

en/self-host/use-dify/build/shortcut-key.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: Hotkeys
55
Speed up your workflow building with keyboard shortcuts.
66

77
<Callout type="tip">
8-
**[Go to Anything](/en/self-host/use-dify/build/goto-anything)**: Press `Cmd+K` (macOS) or `Ctrl+K` (Windows) anywhere in Dify to search and jump to everything—apps, plugins, knowledge bases, even workflow nodes. Use slash commands like `/theme` to change appearance, `/language` to switch languages, or `/help` to access documentation.
8+
**[Go to Anything](/en/self-host/use-dify/build/goto-anything)**: Press `Cmd+K` (macOS) or `Ctrl+K` (Windows) anywhere in Dify to search and jump to everything—apps, integrations, knowledge bases, even workflow nodes. Use slash commands like `/theme` to change appearance, `/language` to switch languages, or `/help` to access documentation.
99

1010
<Frame>
1111
![Command+K Search Interface](/images/use-dify/workflow/command-k.gif)

en/self-host/use-dify/build/text-generator.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ Choose the variable type that matches the input you expect:
6363
<Tab title="API-based Variable">
6464
Fetches variable values from an external API at runtime instead of collecting them from users.
6565

66-
Use it when your prompt needs dynamic data from an external source, such as live weather conditions or database records. See [API Extension](/en/self-host/use-dify/workspace/api-extension/api-extension) for details.
66+
Use it when your prompt needs dynamic data from an external source, such as live weather conditions or database records. See [Custom Endpoints](/en/self-host/use-dify/workspace/api-extension/api-extension) for details.
6767
</Tab>
6868
</Tabs>
6969

0 commit comments

Comments
 (0)