Dify Agent开发实战

Part 2.Dify文本生成应用与Agent开发指南

1. Dify文本应用开发流程

本节开始，我们继续介绍Dify中的文本生成应用和Agent应用开发方法。尽管同样属于初级应用，但各自其实都有非常广泛的应用场景。

Dify 的 文本生成应用 是最基础、也是最容易上手的一类应用。它的核心思想很简单：用户在输入框里提供一个 提示词（Prompt） 或问题，系统会调用后台大模型生成一段文本输出。你只需要在界面中配置好提示词模板、变量，以及必要的上下文，发布后就可以直接使用。下面我们来完整梳理从零到一的开发流程。由于这种模式高度灵活，因此几乎可以覆盖所有与 “文本加工” 相关的工作场景。常见的典型应用包括：

信息摘要
- 从长篇文章、新闻报道或学术论文中提炼核心要点，生成简洁摘要。
- 适合媒体监测、教育学习、知识管理等场景。
语言翻译与改写
- 将文本翻译为目标语言，或对现有内容进行改写、润色，提升表达质量。
- 常见于跨境电商、本地化运营和学术写作。
市场营销与广告文案
- 快速生成多版本广告语、产品描述、邮件标题，支持 A/B 测试。
- 广告优化、社交媒体营销、品牌传播都离不开这一能力。
创意写作与内容创作
- 帮助写作人员生成故事开头、对白片段、诗歌，甚至完整的小说章节。
- 既能激发灵感，也能大幅缩短写作时间。
SEO 与长尾内容生成
- 围绕关键词批量生成搜索引擎优化（SEO）文章、FAQ 页面、长尾描述。
- 特别适合电商、网站运营和内容农场场景。
结构化文本生成
- 自动生成简历、合同条款、实验报告、产品对比表等“半结构化”内容。
- 适用于企业办公自动化、教育考试与法律合规场景。
对话脚本与客服回复
- 批量生成常见问题解答（FAQ）、客服邮件模板，缩短人工整理时间。
- 便于企业搭建客户支持系统。

接下来我们就通过创建一个新闻摘要助手为例，来介绍Dify的文本生成助手应用如何开发。

Step 1.新建应用

在「工作区」中新建应用，选择 文本生成应用（Text Generator）。我们将它命名为 “新闻摘要助手”，目标是让模型把一段较长的新闻文本，提炼总结成简洁的三句话。

Step 2.核心功能设置

能够发现，文本生成应用和聊天助手类似，都是主要以提示词来控制模型行为，同时允许关联知识库进行问答。这里我们在 前缀提示词 区域输入以下内容：

FENCE0

这里我们告诉模型三个关键点：

任务：生成摘要；
限制：三句话；
变量：{{news_content}} 会被用户输入的新闻正文替换。

同时在变量区新增一个变量：

名称：news_content
类型：段落（Paragraph）
必填：是

这样，用户在运行应用时，就会看到一个多行文本框，粘贴新闻内容即可。

新闻摘要助手其实不依赖知识库，因为输入的新闻就是上下文。但如果你想要额外增强，比如固定引用某些行业分析文档，也可以在这里添加知识库，作为额外的参考背景。

Step 3.调试与预览

接下来开始尝试进行对话，我们在右侧输入区粘贴一段新闻：

FENCE1

点击运行，能够看出Dify默认会调用推理模型先进行推理然后再进行编写：

最终思考输出结果如下：

需要注意的是，和普通的聊天机器人有所不同的是，文本生成往往是一次性的工作，并不能进行持续多轮对话。

Step 4.发布运行

Step 4. 批量文本生成

此外，文本生成还支持批量创建，通过 CSV 文件批量导入数据，一次性生成所有结果。例如有一个包含三条新闻的CSV文件：

批量处理如下：

2. 文本翻译类应用开发

接下来我们已跨境电商商品描述本地化为例，带尝试用文本生成应用做一套可真实落地的翻译流程：既能一条条翻译，也能批量处理，并兼顾术语统一、格式保真、品牌语气与合规信息。这就是一整套“轻量 TMS（翻译管理系统）+ 术语库”的企业级实现。

2.1 使用场景与目标

使用场景：跨境电商需将英文商品描述、规格参数、售后政策翻译为多语种（例如中文、德语、法语），并保持术语一致、格式不破坏（Markdown/HTML/JSON）、品牌名不翻译、单位换算合规。
业务目标：
1. 快速构建“文本翻译”应用，支持单次运行与CSV 批量运行；
2. 通过变量与提示词模板实现“语言/语气/风格/领域”的可选；
3. 通过**知识库（可选）**接入“品牌术语表/风格指南”，提升稳定性；
4. 预留API 接口，便于后续与电商后台/ERP/网站联动。

2.2 应用结构设计

应用类型：文本生成应用（Text Generator）

变量设计（建议至少包含）：

source_text（段落，必填）：源文本（英文商品描述/参数/售后政策）。
source_lang（下拉，默认 auto）：源语言（auto/en/de/...）。
target_lang（下拉，必选）：目标语言（如 zh-CN、de-DE、fr-FR 等）。
tone（下拉，可选）：品牌语气（professional/friendly/concise 等）。
format_mode（下拉，可选）：格式保真策略（plain/markdown/html/json）。
domain（下拉，可选）：领域（electronics/fashion/home… 用于选择术语表）。

可选 知识库：上传“品牌术语表（Brand Glossary）/风格指南（Style Guide）”。术语表可用表格或 Markdown 文档维护（如“battery life→续航时间；Apple Watch → Apple Watch（保持英文）”等），用于 RAG 辅助统一译法。

2.3 提示词模板

将以下内容放入前缀提示词（System Prompt），再结合变量：

FENCE2

说明：

知识库接入后，模型会在翻译时优先参考“术语表/风格指南”。

format_mode=json 时，要求“键不翻，值可翻”，非常适合 API 文案、本地化资源文件。

2.4 测试示例（单次翻译）

输入（source_text，节选 Markdown）：

FENCE3

变量：source_lang=auto，target_lang=zh-CN，tone=professional，format_mode=markdown （可选）知识库：术语表中约定 “Apple Watch” 不翻译，“battery life→续航时间”。

输出结果

2.5 批量运行：CSV 批量本地化

运行结果如下：

2.6 API 调用

发布后，进入“访问 API”页面即可看到此应用的接口与示例代码。不同部署的路径命名可能略有差异（常见为 completion-messages 或页面展示的“文本生成端点”），以页面给出的实际地址为准。请求体通常包含：inputs（上述变量）、response_mode（blocking/streaming）、可选 user/conversation_id 等字段。示例（以你环境里“访问 API”页为准）：

FENCE4

3. 广告文案自动优化应用开发

3.1 使用场景与业务价值

在跨境电商与互联网广告投放领域，一个产品往往需要 多版本广告文案，以便在不同渠道、不同用户群体、不同语言环境下进行投放测试（A/B Test）。企业级示例：跨境电商广告投放。

例如：

在 Facebook 投放时，需要简短、吸睛的文案。
在 Google Ads 投放时，需要精准、包含关键词的描述。
在 TikTok/Instagram 上，则更适合轻松、创意风格的内容。

业务痛点：

人工撰写多个版本文案费时费力；
不同渠道风格差异大，难以统一；
缺少快速的自动化优化与批量处理能力。

目标：用 Dify 搭建一个“广告文案优化助手”，能够：

输入一段原始广告文案/商品描述；
自动生成 多版本广告文案（风格、语气、渠道差异化）；
支持 多语言输出，方便跨境投放；
提供 批量处理功能，一次生成上百条优化后的文案，支持导出；
可通过 API 对接广告投放系统（如 Google Ads API、Facebook Marketing API）。

3.2 应用结构设计

应用类型：文本生成应用（Text Generator）

变量设计（推荐）：

original_copy（段落，必填）：原始广告文案或商品描述。
target_lang（下拉，必填）：目标语言（如 en-US、zh-CN、de-DE）。
platform（下拉，必选）：广告投放平台（Facebook / Google / TikTok / Instagram / LinkedIn）。
tone（下拉，可选）：语气（friendly / professional / humorous / concise / persuasive）。
num_versions（数字，可选）：输出多少个优化版本（默认 3 个）。

3.3 提示词模板

FENCE5

3.4 单次运行示例

输入：

original_copy：

Introducing the new Noise Cancelling Headphones with 30 hours battery life, designed for work, travel, and ultimate focus.
target_lang：en-US
platform：Facebook
tone：friendly
num_versions：3

输出（示例）：

“Silence the world, enjoy your music 🎧 — 30 hours of pure focus wherever you go.”
“Work smarter, travel lighter. 30-hour noise-cancelling headphones built for your lifestyle.”
“Stay in your zone. Noise-free, stress-free, 30 hours nonstop.”

3.5 批量运行：多广告文案优化

准备 CSV：

original_copy,target_lang,platform,tone,num_versions
"Introducing the new Noise Cancelling Headphones with 30 hours battery life...",en-US,Facebook,friendly,3
"轻薄高效的笔记本电脑，搭载最新 i7 处理器，适合商务与学习。",en-US,LinkedIn,professional,2
"Smartwatch with GPS and heart rate monitor, designed for fitness lovers.",de-DE,Google,persuasive,3

上传至 批量运行，即可一次性生成多平台、多语言、多风格的广告文案。
导出 CSV，直接用于 广告投放系统。

4. 创意写作类应用开发

4.1 使用场景与业务价值

在内容产业和数字营销领域，创意文案和故事脚本是企业获取用户注意力和塑造品牌形象的关键。例如：

短视频平台（抖音/TikTok/YouTube Shorts）：品牌需要大量创意脚本，适配不同产品与节日活动。
品牌故事营销：通过讲故事的方式传达品牌价值观，增强用户情感认同。
影视/游戏行业：辅助编剧生成分镜脚本、对白设计和剧情创意，提升前期策划效率。
广告与公关：快速生成带有叙事性的广告内容，形成差异化竞争。

业务痛点：

人工创意效率低，内容需求量大；
很多场合需要多风格、多版本脚本以便测试；
不同品牌/产品需要保持一致的核心价值观与风格基调。

目标：搭建一个 “创意写作助手”，能根据产品/品牌信息，自动生成多风格创意文案或短视频脚本，并支持批量运行和 API 调用。（企业级示例：短视频脚本生成与品牌故事创作）

4.2 应用结构设计

应用类型：文本生成应用（Text Generator）

变量设计（推荐）：

theme（文本，必填）：创意主题（如“环保节能”或“母亲节礼物”）。
brand_info（段落，必填）：品牌或产品的背景信息（核心卖点、价值观、目标用户）。
format_type（下拉，必填）：生成形式（短视频脚本 / 广告文案 / 品牌故事 / 分镜脚本）。
tone（下拉，可选）：风格（幽默 / 温情 / 专业 / 激励 / 年轻化）。
num_versions（数字，可选）：输出几个不同创意版本（默认 2 个）。

4.3 提示词模板（可直接复制）

FENCE6

4.4 单次运行示例

输入：

theme：环保节能
brand_info：某家电品牌，主打节能冰箱，目标群体为年轻家庭用户，品牌理念是“绿色生活，从家开始”。
format_type：短视频脚本
tone：温情
num_versions：2

FENCE7

FENCE8

4.5 批量运行

5. SEO文章编写类应用开发

5.1 使用场景与业务价值

在跨境电商和内容营销领域，SEO（搜索引擎优化）文章是提升自然流量的关键手段。企业需要针对 特定关键词（如“best noise cancelling headphones 2025”、“eco-friendly refrigerators for small apartments”）持续产出长尾内容。【企业级示例：跨境电商长尾关键词批量文章生成】

业务痛点：