Skip to content

Add intro docs for different app types#718

Open
RiskeyL wants to merge 1 commit intomainfrom
add/app-intro
Open

Add intro docs for different app types#718
RiskeyL wants to merge 1 commit intomainfrom
add/app-intro

Conversation

@RiskeyL
Copy link
Copy Markdown
Contributor

@RiskeyL RiskeyL commented Mar 20, 2026

No description provided.

Copilot AI review requested due to automatic review settings March 20, 2026 07:11
@dosubot dosubot bot added the size:XL This PR changes 500-999 lines, ignoring generated files. label Mar 20, 2026
@RiskeyL RiskeyL changed the title draft Add intro docs for different app types Mar 20, 2026
@dosubot dosubot bot added the documentation Improvements or additions to documentation label Mar 20, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Dify documentation navigation metadata (sidebar titles/icons), adds new “Build” section pages for core app types (Workflow/Chatflow, Text Generator, Chatbot, Agent), and introduces a new screenshot asset referenced by the Agent page.

Changes:

  • Added new build docs: Workflow & Chatflow overview, Text Generator guide, Chatbot guide, and Agent guide.
  • Updated knowledge docs frontmatter to refine sidebar titles and add icons.
  • Added a new image asset images/tool_name.png used in the Agent doc.

Reviewed changes

Copilot reviewed 9 out of 13 changed files in this pull request and generated 7 comments.

Show a summary per file
File Description
images/tool_name.png Adds a screenshot referenced in the new Agent documentation.
en/use-dify/knowledge/metadata.mdx Updates sidebar title and adds an icon to improve nav presentation.
en/use-dify/knowledge/manage-knowledge/maintain-knowledge-documents.mdx Renames sidebar title for clearer navigation labeling.
en/use-dify/knowledge/manage-knowledge/maintain-dataset-via-api.mdx Adds a sidebar title to improve navigation labeling.
en/use-dify/knowledge/manage-knowledge/introduction.mdx Renames sidebar title for clearer navigation labeling.
en/use-dify/knowledge/integrate-knowledge-within-application.mdx Adds a sidebar title to improve navigation labeling.
en/use-dify/build/workflow-chatflow.mdx New overview page explaining workflow vs. chatflow.
en/use-dify/build/text-generator.mdx New guide for configuring and using Text Generator apps.
en/use-dify/build/chatbot.mdx New guide for configuring and using Chatbot apps.
en/use-dify/build/agent.mdx New guide for configuring and using Agent apps, including tools and retrieval.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.


### Extend the Agent with Dify Tools

Add [tools](/en/use-dify/workspace/tool) to enable the model to interact with external services and APIs for tasks beyond text generation, such as fetching live data, searching the web, or querying databases.
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The internal link target /en/use-dify/workspace/tool does not exist in this repo (there is no en/use-dify/workspace/tool*.mdx). This will render as a broken link; please update it to an existing Tools-related doc (e.g. the Tools node page) or add the missing destination page.

Suggested change
Add [tools](/en/use-dify/workspace/tool) to enable the model to interact with external services and APIs for tasks beyond text generation, such as fetching live data, searching the web, or querying databases.
Add [tools](/en/use-dify/workspace/tools) to enable the model to interact with external services and APIs for tasks beyond text generation, such as fetching live data, searching the web, or querying databases.

Copilot uses AI. Check for mistakes.

This improves retrieval precision, especially when your knowledge base is large or contains content for different contexts.

For creating and managing document metadata, see [Metadata](/en/use-dify/workspace/knowledge-base/metadata).
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link points to /en/use-dify/workspace/knowledge-base/metadata, but there is no workspace/knowledge-base section in the docs tree. The existing metadata page lives at /en/use-dify/knowledge/metadata, so this should be updated to avoid a broken link.

Suggested change
For creating and managing document metadata, see [Metadata](/en/use-dify/workspace/knowledge-base/metadata).
For creating and managing document metadata, see [Metadata](/en/use-dify/knowledge/metadata).

Copilot uses AI. Check for mistakes.
- **Upload Limit**: The maximum number of files a user can upload per message.

<Tip>
Agents also support optional features like conversation openers, follow-up suggestions, text to speech, speech to text, citations and attributions, content moderation, and annotation replies. See [App Toolkit](/en/use-dify/build/app-toolkit) for details.
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/en/use-dify/build/app-toolkit is referenced here, but there is no app-toolkit.mdx (or equivalent) under en/use-dify/build/, so this will be a broken link. Please point this to an existing page that covers these features (or add the missing App Toolkit page).

Suggested change
Agents also support optional features like conversation openers, follow-up suggestions, text to speech, speech to text, citations and attributions, content moderation, and annotation replies. See [App Toolkit](/en/use-dify/build/app-toolkit) for details.
Agents also support optional features like conversation openers, follow-up suggestions, text to speech, speech to text, citations and attributions, content moderation, and annotation replies. See [App Toolkit](/en/use-dify/build/README) for details.

Copilot uses AI. Check for mistakes.

This improves retrieval precision, especially when your knowledge base is large or contains content for different contexts.

For creating and managing document metadata, see [Metadata](/en/use-dify/workspace/knowledge-base/metadata).
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link points to /en/use-dify/workspace/knowledge-base/metadata, but that section doesn’t exist in the current docs tree. The metadata page is /en/use-dify/knowledge/metadata; please update the link to avoid a 404.

Suggested change
For creating and managing document metadata, see [Metadata](/en/use-dify/workspace/knowledge-base/metadata).
For creating and managing document metadata, see [Metadata](/en/use-dify/knowledge/metadata).

Copilot uses AI. Check for mistakes.
- **Upload Limit**: The maximum number of files a user can upload per message.

<Tip>
Chatbots also support optional features like conversation openers, follow-up suggestions, text to speech, speech to text, citations and attributions, content moderation, and annotation replies. See [App Toolkit](/en/use-dify/build/app-toolkit) for details.
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/en/use-dify/build/app-toolkit is linked here, but there’s no corresponding page under en/use-dify/build/ in this repo. Please update the link to an existing page that documents these optional features (or add the missing page) to prevent a broken link in the published docs.

Suggested change
Chatbots also support optional features like conversation openers, follow-up suggestions, text to speech, speech to text, citations and attributions, content moderation, and annotation replies. See [App Toolkit](/en/use-dify/build/app-toolkit) for details.
Chatbots also support optional features like conversation openers, follow-up suggestions, text to speech, speech to text, citations and attributions, content moderation, and annotation replies. See [App Toolkit](/en/use-dify/build/README) for details.

Copilot uses AI. Check for mistakes.

This improves retrieval precision, especially when your knowledge base is large or contains content for different contexts.

For creating and managing document metadata, see [Metadata](/en/use-dify/workspace/knowledge-base/metadata).
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link points to /en/use-dify/workspace/knowledge-base/metadata, which doesn’t exist in the current docs tree. The metadata page is /en/use-dify/knowledge/metadata; please update the link to avoid a broken reference.

Suggested change
For creating and managing document metadata, see [Metadata](/en/use-dify/workspace/knowledge-base/metadata).
For creating and managing document metadata, see [Metadata](/en/use-dify/knowledge/metadata).

Copilot uses AI. Check for mistakes.
- **Upload Limit**: The maximum number of files a user can upload per run.

<Tip>
Text Generators also support optional features like generating multiple outputs at once, text to speech, and content moderation. See [App Toolkit](/en/use-dify/build/app-toolkit) for details.
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/en/use-dify/build/app-toolkit is referenced, but there is no page at that path in the repository. Please change this link to an existing doc covering these features (or add the missing page) so readers don’t hit a 404.

Suggested change
Text Generators also support optional features like generating multiple outputs at once, text to speech, and content moderation. See [App Toolkit](/en/use-dify/build/app-toolkit) for details.
Text Generators also support optional features like generating multiple outputs at once, text to speech, and content moderation. See [Build Overview](/en/use-dify/build/README) for details.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants