diff --git a/docs.json b/docs.json index c44335a2..00179b8c 100644 --- a/docs.json +++ b/docs.json @@ -115,7 +115,8 @@ ] }, "en/use-dify/publish/publish-mcp", - "en/use-dify/publish/developing-with-apis" + "en/use-dify/publish/developing-with-apis", + "en/use-dify/publish/publish-to-marketplace" ] }, { @@ -501,7 +502,8 @@ ] }, "zh/use-dify/publish/publish-mcp", - "zh/use-dify/publish/developing-with-apis" + "zh/use-dify/publish/developing-with-apis", + "zh/use-dify/publish/publish-to-marketplace" ] }, { @@ -887,7 +889,8 @@ ] }, "ja/use-dify/publish/publish-mcp", - "ja/use-dify/publish/developing-with-apis" + "ja/use-dify/publish/developing-with-apis", + "ja/use-dify/publish/publish-to-marketplace" ] }, { diff --git a/en/use-dify/publish/publish-to-marketplace.mdx b/en/use-dify/publish/publish-to-marketplace.mdx new file mode 100644 index 00000000..351be8c6 --- /dev/null +++ b/en/use-dify/publish/publish-to-marketplace.mdx @@ -0,0 +1,149 @@ +--- +title: Publish Apps to Marketplace +sidebarTitle: Marketplace +description: Publish your apps to Dify Marketplace and share them with the world +icon: store +--- + +Publish your apps as templates to Dify Marketplace, where other Dify users can discover and use them. + +## Submit Templates + +To publish a template, submit it for review first. Once approved, it will be listed on Marketplace. + + + Before submission, make sure all plugins used in the app are **installed directly from Marketplace**. + + +There are two ways to submit: + + + + + Available in [beta](https://github.com/langgenius/dify/releases/tag/1.14.0-rc1) environment only. + + In your app, click **Publish** > **Publish to Marketplace**. + + This takes you to the [Creator Center](https://creators.dify.ai) where you can fill in the template details and submit for review. + + + + Export your app, then go to the [Creator Center](https://creators.dify.ai) and upload the export file. Fill in the template details and submit for review. + + + +## Template Writing Guidelines + +### Language Requirements + +Keep the template library consistent and searchable. + +**The following fields must be written in English**: + +- Template name +- Overview +- Setup steps + +**Inside the app, you can use any language (e.g. Chinese) for**: + +- Node names +- Prompts / system messages +- Messages shown to end-users + +If your template mainly targets non-English users, you can add a tag in the title. For example, +`Stock Investment Analysis Copilot [ZH]`. + +### Template Name & Icon + +From the name alone, users should know where it runs and what it does. + +- Use a short English phrase, typically 3-7 words. +- Recommended pattern: [Channel / target] + [core task], for example: + - WeChat Customer Support Bot + - CSV Data Analyzer with Natural Language + - Internal Docs Q&A Assistant + - GitHub Issue Triage Agent +- Include keywords users might search for: channel names (Slack, WeChat, Email, Notion) and task names (Summarizer, Assistant, Generator, Bot). + +### Categories + +Help users discover your template when browsing or filtering by category. + +- Select only **1-3** categories that best describe your template. +- Do not check every category just for exposure. + +### Language + +Help users discover your template via language filters. + +- Select the language(s) your template is designed for in real usage. +- This refers to the language of the template's use case, input, or output — **not** the title or overview (which must be in English). + +### Overview + +In 2-4 English sentences, explain what it does and who it is for. + +You don't need to list prerequisites, inputs, or outputs here. + +**Recommended structure** + +1. Sentence 1: **What it does** + + A one-sentence summary of the main function. +2. Sentence 2-3: **Who and when** + + Typical user roles or scenarios (support team, marketers, founders, individual knowledge workers, etc.). + + + This template creates a stock investment analysis copilot that uses Yahoo Finance tools to fetch news, analytics, and ticker data for any listed company. + + It helps investors and analysts quickly generate structured research summaries, compare companies, and prepare reports without manually switching between multiple finance websites. + + +### Setup Steps + +Write Setup steps as a numbered Markdown list (1., 2., 3.), with one short sentence per step, starting with a verb. + +A new user should be able to get the template running in a few minutes just by following these steps. + +**Writing principles** + +1. Follow the real setup order, usually: + 1. Use/import the template + 2. Connect accounts / add API keys + 3. Connect data sources (docs, databases, sheets, etc.) + 4. Optional customization (assistant name, tone, filters) + 5. Activate the workflow and run a test + +2. Each step should answer: + - Where to click in the UI + - What to configure or fill in + +3. Aim for 3-8 steps. Too few feels incomplete; too many feels overwhelming. + + + 1. Click **Use template** to copy the “Investment Analysis Copilot (Yahoo Finance)” agent into your workspace. + + 2. Go to **Settings → Model provider** and add your LLM API key. For example, OpenAI, Anthropic, or another supported provider. + + 3. Open the agent's **Orchestrate** page and make sure the Yahoo Finance tools are enabled in the **Tools** section: + - `yahoo Analytics` + - `yahoo News` + - `yahoo Ticker` + + 4. (Optional) Customize the analysis style: + - In the **INSTRUCTIONS** area, adjust the system prompt to match your target users. For example, tone, report length, preferred language, or risk preference. + - Update the suggested questions in the **Debug & Preview** panel if you want different example queries. + + 5. Click **Publish** to make the agent available, then use the preview panel to test it: + - Enter a company name or ticker (e.g., `Nvidia`, `AAPL`, `TSLA`). + - Confirm that the copilot calls the Yahoo Finance tools and returns a structured investment analysis report. + + +### Quick Checklist Before You Submit + +- The name is a short English phrase that clearly shows where it runs and what it does. +- The overview uses 2-4 English sentences to explain the value and typical use cases. +- Only 1-3 relevant categories are selected. +- Setup steps are a clear numbered list. +- Internal workflow texts and prompts are written in appropriate languages for your target users. \ No newline at end of file diff --git a/ja/use-dify/publish/publish-to-marketplace.mdx b/ja/use-dify/publish/publish-to-marketplace.mdx new file mode 100644 index 00000000..8a580f6e --- /dev/null +++ b/ja/use-dify/publish/publish-to-marketplace.mdx @@ -0,0 +1,151 @@ +--- +title: "アプリをマーケットプレイスに公開" +sidebarTitle: "マーケットプレイス" +description: "アプリを Dify マーケットプレイスに公開して世界中のユーザーと共有" +icon: "store" +--- + + ⚠️ このドキュメントはAIによって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/use-dify/publish/publish-to-marketplace)を参照してください。 + +アプリをテンプレートとして Dify マーケットプレイスに公開すると、他の Dify ユーザーが発見して利用できるようになります。 + +## テンプレートの提出 + +テンプレートを公開するには、まず審査に提出します。承認されると、マーケットプレイスに掲載されます。 + + + 提出前に、アプリで使用しているすべてのプラグインが**マーケットプレイスから直接インストール**されていることを確認してください。 + + +提出方法は2つあります: + + + + + [beta](https://github.com/langgenius/dify/releases/tag/1.14.0-rc1) 環境でのみ利用可能です。 + + アプリ内で、**公開** > **マーケットプレイスに公開**をクリックします。 + + [クリエイターセンター](https://creators.dify.ai)に移動し、テンプレートの詳細を入力して審査に提出できます。 + + + + アプリをエクスポートし、[クリエイターセンター](https://creators.dify.ai)でエクスポートファイルをアップロードします。テンプレートの詳細を入力して審査に提出します。 + + + +## テンプレート作成ガイドライン + +### 言語の要件 + +テンプレートライブラリの一貫性と検索しやすさを保つため、以下に従ってください。 + +**以下のフィールドは英語で記述する必要があります**: + +- テンプレート名 +- 概要 +- セットアップ手順 + +**アプリ内部では、任意の言語(日本語など)を使用できます**: + +- ノード名 +- プロンプト / システムメッセージ +- エンドユーザーに表示されるメッセージ + +テンプレートが主に英語以外のユーザーを対象とする場合は、タイトルにタグを追加できます。例えば、 +`Stock Investment Analysis Copilot [JA]`。 + +### テンプレート名とアイコン + +名前だけで、ユーザーがどこで動作し何をするかがわかるようにします。 + +- 短い英語のフレーズを使い、通常 3-7 語にします。 +- 推奨パターン:[チャネル / 対象] + [コアタスク]。例: + - WeChat Customer Support Bot + - CSV Data Analyzer with Natural Language + - Internal Docs Q&A Assistant + - GitHub Issue Triage Agent +- ユーザーが検索しそうなキーワードを含めます:チャネル名(Slack、WeChat、Email、Notion)やタスク名(Summarizer、Assistant、Generator、Bot)。 + +### カテゴリ + +ユーザーがブラウズやカテゴリフィルターでテンプレートを発見しやすくします。 + +- テンプレートを最もよく表す **1-3** つのカテゴリのみを選択してください。 +- 露出を増やすためにすべてのカテゴリを選択しないでください。 + +### 言語 + +ユーザーが言語フィルターでテンプレートを発見しやすくします。 + +- テンプレートが実際の利用で対象とする言語を選択します。 +- これはテンプレートのユースケース、入力、または出力の言語を指します——タイトルや概要の言語(英語必須)では**ありません**。 + +### 概要 + +2-4 文の英語で、何をするか、誰向けかを説明します。 + +前提条件、入力、出力をここに記載する必要はありません。 + +**推奨構成** + +1. 第 1 文:**何をするか** + + 主な機能を一文で要約。 +2. 第 2-3 文:**誰が、いつ** + + 典型的なユーザーの役割やシナリオ(サポートチーム、マーケター、創業者、個人のナレッジワーカーなど)。 + + + This template creates a stock investment analysis copilot that uses Yahoo Finance tools to fetch news, analytics, and ticker data for any listed company. + + It helps investors and analysts quickly generate structured research summaries, compare companies, and prepare reports without manually switching between multiple finance websites. + + +### セットアップ手順 + +セットアップ手順を Markdown の番号付きリスト(1., 2., 3.)で記述し、各ステップは動詞で始まる短い一文にします。 + +新しいユーザーがこの手順に従うだけで、数分でテンプレートを動かせるようにします。 + +**記述の原則** + +1. 実際のセットアップ順序に従います。通常: + 1. テンプレートの使用/インポート + 2. アカウントの接続 / API キーの追加 + 3. データソースの接続(ドキュメント、データベース、スプレッドシートなど) + 4. オプションのカスタマイズ(アシスタント名、トーン、フィルターなど) + 5. ワークフローを有効化してテスト実行 + +2. 各ステップで以下を明確にします: + - UI のどこをクリックするか + - 何を設定または入力するか + +3. 3-8 ステップが目安です。少なすぎると不完全に感じ、多すぎると負担になります。 + + + 1. Click **Use template** to copy the "Investment Analysis Copilot (Yahoo Finance)" agent into your workspace. + + 2. Go to **Settings → Model provider** and add your LLM API key. For example, OpenAI, Anthropic, or another supported provider. + + 3. Open the agent's **Orchestrate** page and make sure the Yahoo Finance tools are enabled in the **Tools** section: + - `yahoo Analytics` + - `yahoo News` + - `yahoo Ticker` + + 4. (Optional) Customize the analysis style: + - In the **INSTRUCTIONS** area, adjust the system prompt to match your target users. For example, tone, report length, preferred language, or risk preference. + - Update the suggested questions in the **Debug & Preview** panel if you want different example queries. + + 5. Click **Publish** to make the agent available, then use the preview panel to test it: + - Enter a company name or ticker (e.g., `Nvidia`, `AAPL`, `TSLA`). + - Confirm that the copilot calls the Yahoo Finance tools and returns a structured investment analysis report. + + +### 提出前クイックチェックリスト + +- 名前が、どこで動作し何をするかを明確に示す短い英語フレーズであること。 +- 概要が 2-4 文の英語で価値と典型的なユースケースを説明していること。 +- 関連するカテゴリが 1-3 つのみ選択されていること。 +- セットアップ手順が明確な番号付きリストであること。 +- ワークフロー内部のテキストやプロンプトが、ターゲットユーザーに適した言語で記述されていること。 diff --git a/zh/use-dify/publish/publish-to-marketplace.mdx b/zh/use-dify/publish/publish-to-marketplace.mdx new file mode 100644 index 00000000..d145883b --- /dev/null +++ b/zh/use-dify/publish/publish-to-marketplace.mdx @@ -0,0 +1,151 @@ +--- +title: "发布应用到市场" +sidebarTitle: "市场" +description: "将你的应用发布到 Dify 市场,与全世界分享" +icon: "store" +--- + + ⚠️ 本文档由 AI 自动翻译。如有任何不准确之处,请参考[英文原版](/en/use-dify/publish/publish-to-marketplace)。 + +将你的应用作为模板发布到 Dify 市场,让其他 Dify 用户可以发现和使用。 + +## 提交模板 + +若要发布模板,需先提交审核。通过后,模板将在市场上架。 + + + 提交前,请确保应用中使用的所有插件都**直接从市场安装**。 + + +有两种提交方式: + + + + + 仅在 [beta](https://github.com/langgenius/dify/releases/tag/1.14.0-rc1) 环境中可用。 + + 在应用内部,点击**发布** > **发布到市场**。 + + 这将跳转到 [创作者中心](https://creators.dify.ai),你可以在此填写模板详情并提交审核。 + + + + 导出你的应用,然后前往 [创作者中心](https://creators.dify.ai) 上传导出文件。填写模板详情并提交审核。 + + + +## 模板填写指南 + +### 语言要求 + +保持模板库的一致性和可搜索性。 + +**以下字段必须使用英文撰写**: + +- 模板名称 +- 概述 +- 设置步骤 + +**在应用内部,你可以使用任何语言(如中文)来编写**: + +- 节点名称 +- 提示词 / 系统消息 +- 展示给终端用户的消息 + +如果你的模板主要面向非英语用户,可以在标题中添加标签。例如, +`Stock Investment Analysis Copilot [ZH]`。 + +### 模板名称和图标 + +仅从名称,用户就应该知道它在哪里运行以及做什么。 + +- 使用简短的英文短语,通常为 3-7 个单词。 +- 推荐模式:[渠道 / 目标] + [核心任务],例如: + - WeChat Customer Support Bot + - CSV Data Analyzer with Natural Language + - Internal Docs Q&A Assistant + - GitHub Issue Triage Agent +- 包含用户可能搜索的关键词:渠道名称 (Slack, WeChat, Email, Notion) 和任务名称 (Summarizer, Assistant, Generator, Bot)。 + +### 分类 + +帮助用户在浏览或按分类筛选时发现你的模板。 + +- 仅选择 **1-3** 个最能描述你模板的分类。 +- 不要为了增加曝光而勾选所有分类。 + +### 语言 + +帮助用户通过语言筛选发现你的模板。 + +- 选择你的模板在实际使用中所面向的语言。 +- 这里指的是模板用例、输入或输出的语言——**而非**标题或概述的语言(这些必须使用英文)。 + +### 概述 + +用 2-4 句英文说明它做什么以及面向谁。 + +你无需在此列出先决条件、输入或输出。 + +**推荐结构** + +1. 第 1 句:**它做什么** + + 一句话概括主要功能。 +2. 第 2-3 句:**面向谁、什么场景** + + 典型用户角色或场景(客服团队、营销人员、创始人、个人知识工作者等)。 + + + This template creates a stock investment analysis copilot that uses Yahoo Finance tools to fetch news, analytics, and ticker data for any listed company. + + It helps investors and analysts quickly generate structured research summaries, compare companies, and prepare reports without manually switching between multiple finance websites. + + +### 设置步骤 + +将设置步骤写成 Markdown 编号列表(1., 2., 3.),每一步用简短的一句话,以动词开头。 + +新用户只需按照这些步骤操作,即可在几分钟内让模板运行起来。 + +**撰写原则** + +1. 按照实际设置顺序,通常为: + 1. 使用/导入模板 + 2. 连接账户 / 添加 API 密钥 + 3. 连接数据源(文档、数据库、表格等) + 4. 可选自定义(助手名称、语气、过滤器) + 5. 激活工作流并运行测试 + +2. 每一步应回答: + - 在界面中点击哪里 + - 需要配置或填写什么 + +3. 目标 3-8 步。太少显得不完整,太多则会令人生畏。 + + + 1. Click **Use template** to copy the "Investment Analysis Copilot (Yahoo Finance)" agent into your workspace. + + 2. Go to **Settings → Model provider** and add your LLM API key. For example, OpenAI, Anthropic, or another supported provider. + + 3. Open the agent's **Orchestrate** page and make sure the Yahoo Finance tools are enabled in the **Tools** section: + - `yahoo Analytics` + - `yahoo News` + - `yahoo Ticker` + + 4. (Optional) Customize the analysis style: + - In the **INSTRUCTIONS** area, adjust the system prompt to match your target users. For example, tone, report length, preferred language, or risk preference. + - Update the suggested questions in the **Debug & Preview** panel if you want different example queries. + + 5. Click **Publish** to make the agent available, then use the preview panel to test it: + - Enter a company name or ticker (e.g., `Nvidia`, `AAPL`, `TSLA`). + - Confirm that the copilot calls the Yahoo Finance tools and returns a structured investment analysis report. + + +### 提交前快速检查清单 + +- 名称是一个简短的英文短语,能清楚地说明它在哪里运行、做什么。 +- 概述用 2-4 句英文解释价值和典型用例。 +- 仅选择了 1-3 个相关分类。 +- 设置步骤是清晰的编号列表。 +- 工作流内部的文本和提示词使用了面向目标用户的适当语言。