document/content/guide/getting-started/quick-start.mdx
本文通过四个完整案例，帮助你快速理解 FastGPT 的核心应用类型，并完成从简单对话到复杂任务编排的基础搭建。
本页适合第一次接触 FastGPT 的用户，也适合售前、交付、运营、法务、行政等角色快速体验平台能力。完成本页后，你将依次搭建：
建议提前准备以下内容：
阅读时建议重点关注三件事：每种应用类型适合解决什么问题、关键配置为什么这样写、验证时应该观察哪些效果。本文中的参数和 Prompt 都是可复用的起点，正式落地时可以替换为你自己的业务资料、审核规则、通知渠道和数据文件。
对话 Agent 适合轻量问答、内容生成、文案润色、标准化输出等场景。本案例不关联知识库，也不依赖复杂流程，只通过模型配置、Prompt 和 Email 工具完成一个企业邮件撰写助手。
企业员工经常需要处理项目同步、跨部门协作、客户回复、会议纪要等邮件。通过 AI 统一邮件格式和表达风格，可以提升写作效率，也能保持企业对外沟通的专业性。
这个案例的重点不是让 AI 随意生成一封邮件，而是把企业邮件写作中的稳定要求沉淀到 Prompt 中，例如主题行、称呼、正文结构、行动项和风险提醒。对于新手来说，它也是理解 FastGPT 应用配置的最小闭环：先定义角色，再约束输出，最后通过工具扩展执行动作。
创建对话 Agent
在工作台点击新建，选择对话 Agent，应用名称填写为 企业邮件撰写助手。
进入应用配置页
创建完成后进入应用配置页。页面通常分为左右两栏：左侧是 AI 配置，右侧是调试预览。
选择模型
在 AI 配置中选择对话 Agent 使用的基础模型。本案例使用 GLM-5.1，你也可以替换为当前环境中已配置的其他可用模型。
选择模型时优先关注两点：一是模型是否擅长中文商务表达，二是输出是否稳定遵守格式。邮件撰写属于低风险、低结构复杂度任务，通常不需要过度追求最强模型，但要确保语气自然、指令遵循能力较好。
编写 Prompt
Prompt 需要清晰描述助手的角色、输出格式和约束。可以使用以下示例：
你是一个企业邮件撰写专家，帮助员工撰写专业、清晰、得体的工作邮件。
输出格式：
- **主题行**：简洁明确
- **称呼**：根据收件人关系选择“尊敬的 XX 总”或“Hi XX”
- **正文**：三段式（背景 → 核心内容 → 行动项）
- **落款**：署名、职位、部门
规则：
- 正文控制在 200-500 字
- 行动项和待办用项目符号列出
- 涉及薪资、人事、法律等敏感内容时，提醒用户谨慎发送
- 不确定收件人关系时使用中性礼貌语气
将 Prompt 写入提示词模块。
这段 Prompt 由三部分组成：角色定义用于稳定助手身份，输出格式用于约束邮件结构，规则用于控制风险边界。实际业务中可以继续补充企业语气要求、品牌用语、禁用词、签名格式等内容，让输出更贴合内部规范。
添加 Email 工具
工具是对复杂操作的封装。本案例使用 Email 邮件发送工具，让 AI 助手在生成邮件后具备发送能力。点击工具右侧的加号，选择 Email 邮件发送。
可以把工具理解为 AI 的外部能力。没有工具时，助手只能生成邮件正文；添加 Email 工具后，助手可以在用户确认后执行发送动作。正式环境中建议先让助手生成邮件草稿，再由用户确认发送，避免误发或发送给错误收件人。
配置 Email 工具
进入工具配置页，填写邮件服务相关参数。
激活工具
点击设置后进入工具激活页面，再点击工具激活。
填写邮箱 SMTP 信息
本案例以 QQ 邮箱为例。测试时可以按以下方式填写：
SMTP 服务器地址：smtp.qq.com
SMTP 端口：465
启用 SSL
SMTP 用户名：邮箱地址
SMTP 密码：授权码
授权码可参考 授权码获取教程。
设置对话开场白
对话开场白用于告诉用户这个 AI 助手可以做什么。可以填写：
你好！我是邮件撰写助手 📧
请告诉我：收件人是谁？邮件目的是什么？需要包含哪些关键信息？
我会帮你生成一封专业、得体的邮件。
填写后，可以在右侧预览区域看到效果。
验证运行效果
配置完成后，在调试预览中输入邮件需求，检查助手是否能生成结构清晰、语气得体的邮件。
如果用户信息不足，助手应主动提示补充收件人、邮件目的、关键信息等内容。
验证时建议至少测试三类输入：信息完整的邮件需求、缺少收件人或目的的模糊需求、包含敏感信息的邮件需求。一个可上线的邮件助手不只要“能写”，还要能在信息不足时追问，在敏感场景下提醒用户谨慎发送。
知识库适合“回答必须基于资料”的场景，例如制度问答、产品手册问答、法律条文检索、客服知识支持等。没有知识库时，AI 主要依赖模型自身能力回答；接入知识库后，AI 会先检索你的资料，再基于检索结果组织答案。
本案例将《中华人民共和国民法典》导入知识库，并创建一个民法典问答助手。用户用自然语言提问时，助手需要优先引用民法典原文，减少凭空生成。
可以把知识库理解为给 AI 配置的“资料室”。模型本身具备通用知识，但不了解你的公司制度、产品细节、内部流程或指定法规版本；知识库把这些资料变成可检索内容，让 AI 在回答前先查资料，再组织答案。对于法律、制度、客服、售后等场景，这比单纯依赖模型记忆更可控。
创建知识库
在主页点击左侧的知识库，进入后点击右上角的新建。知识库名称填写为 民法典问答助手，案例阶段其他配置保持默认即可。
创建文本数据集
点击新建，再选择文本数据集，用于导入本地文档。
上传本地文件
点击上传本地文件，选择示例文件。实际使用时可以同时上传多个文件，本案例只上传一个文件作为演示。
设置解析参数
进入参数设置页后，根据文件类型选择解析方式。
常用配置建议：
这些参数会直接影响后续问答质量。分块过大时，检索结果可能包含太多无关内容，回答容易变得冗长；分块过小时，关键上下文可能被拆散，回答容易缺少依据。快速上手阶段可以先使用默认配置，正式接入企业制度、合同、产品手册时，再根据问答效果逐步调整。
预览分块效果
到数据预览步骤后，检查分块是否完整、可读。如果分块过长或过短，再返回调整参数。
预览分块时重点看三点：段落是否被异常截断，标题与正文是否保留在同一语义范围内，表格、条款或编号是否仍然可读。只要这里的知识片段质量不稳定，后续应用即使 Prompt 写得很好，也很难稳定给出准确答案。
等待知识库就绪
当数据状态变为“已就绪”后，知识库即可被应用引用。
创建并关联对话 Agent
创建一个新的对话 Agent，名称同样填写为 民法典问答助手。创建完成后，在应用配置中关联刚刚创建的知识库。
关联知识库后，应用的回答链路会从单纯对话变成“用户问题 → 知识库检索 → 模型总结回答”。这也是案例一和案例二的关键差异：案例一强调内容生成，案例二强调基于资料回答。
配置问答 Prompt
民法典问答助手需要强调“基于知识库回答”和“引用原文”。可以使用以下 Prompt：
你是一个专业的民法典问答助手，基于《中华人民共和国民法典》原文回答法律问题。
规则：
- 严格基于知识库检索到的民法典条文回答，不得臆造法条
- 每条回答必须引用民法典原文（编、章、条）
- 如果民法典中没有直接对应的规定，如实说明，不做法律建议
- 涉及具体案件的法律适用时，提醒用户“本回答仅供参考，建议咨询专业律师”
- 对法律术语做通俗解释，让非法学背景的用户也能理解
输出格式：
1. **法律结论**（1-3 句概述）
2. **相关法条引用**（原文摘录 + 编章节条号）
3. **通俗解读**（用日常语言解释法条含义）
4. **实务建议**（2-3 条可操作建议）
5. **免责声明**（“本回答基于民法典原文，不构成法律意见，具体案件请咨询专业律师”）
法律问答类场景尤其要强调边界：能回答的是基于资料的通用解释，不能把模型回答包装成正式法律意见。Prompt 中要求引用条文、说明不确定性、添加免责声明，目的都是让输出更可追溯，也更符合高风险知识问答的使用规范。
配置开场白
开场白可以内置几个示例问题，帮助用户快速理解这个助手的使用方式：
你好！我是民法典问答助手 ⚖️
我基于《中华人民共和国民法典》原文，帮你解答法律问题。
你可以问我：
["租房合同没到期，房东要卖房，我该怎么办？"]
["网购商品收到后发现坏了，商家不给退，法律怎么规定？"]
["楼上漏水把我家的天花板泡了，能索赔吗？"]
⚠️ 提示：我的回答仅供参考，具体法律问题建议咨询专业律师。
如果在开场白里添加 [问题内容]，用户可以点击问题一键提问，适合用于演示和引导。
验证问答效果
提出一个民法典相关问题，检查回答是否包含法律结论、法条引用、通俗解读和免责声明。
验证时不要只看回答是否“像法律回答”，还要看它是否真的引用了知识库内容。建议同时测试资料内问题、资料外问题和模糊问题：资料内问题应能引用原文，资料外问题应说明无法直接确认，模糊问题应主动提示需要补充事实。
工作流适合步骤固定、逻辑清晰、需要分支判断或人工确认的任务。本案例将“内容合规审核”拆成知识库检索、AI 分类、条件判断、自动改写、拒绝说明和人工确认几个环节，用来模拟企业内容发布前的审核流程。
它的核心价值有两个：
判断一个任务是否适合工作流，可以看它是否具备“步骤稳定、规则明确、可重复执行”三个特征。内容审核就是典型场景：输入是一段待发布内容，规则来自合规知识库，输出通常是通过、改写或拒绝，中间还可以加入人工确认，既提升处理效率，也保留风险控制。
先创建一个“内容合规规则库”知识库，并上传一个简单的文本文件。可以直接使用以下规则模板：
内容合规规则
安全内容（可直接发布）
- 客观事实陈述
- 正常的活动通知、会议安排
- 产品功能介绍（基于真实数据）
- 行业知识分享
敏感措辞（需改写）
- 绝对化用语：“最好的”“第一”“100%”“绝对”“唯一”
- 夸张宣传：“颠覆行业”“史无前例”“无人能比”
- 未证实数据：无来源的转化率、满意度、增长率
- 对比贬低：直接点名竞品并贬低
违规内容（禁止发布）
- 违法信息：涉及黄赌毒、诈骗、传销
- 人身攻击：针对个人或群体的侮辱、诽谤
- 虚假信息：伪造数据、虚构资质、冒充官方
- 敏感话题：政治敏感、宗教歧视、地域攻击
规则库不需要一开始就非常复杂。快速验证时，先把规则拆成“安全、需改写、禁止发布”三类即可；正式使用时，可以继续按行业、品牌、渠道、地区增加规则，例如广告法敏感词、医疗合规要求、金融营销禁用表达、品牌语气规范等。
正式配置节点之前，建议先确认完整流程。这个案例可以按以下方式设计：
工作流设计时要先确定每个节点的职责，避免让一个 AI 节点同时承担“检索规则、判断分类、改写内容、解释原因”等过多任务。职责拆清楚后，每个节点的 Prompt 会更短、更稳定，后续也更容易定位问题：是知识库没有召回规则，是审核节点分类不准，还是判断器条件没有匹配上。
创建工作流
进入工作流主页，点击新建工作流，名称填写为 内容审核与自动改写。
创建完成后进入工作流编辑页。
本案例的完整流程图如下：
配置开场白
在系统配置中填写开场白，说明助手的审核规则和使用方式。
你好！我是内容合规审核助手 🛡️
请把需要审核的内容发给我，我会按规则自动判断：
- **✅ 安全** — 内容无敏感信息，可以直接发布
- **⚠️ 敏感可改** — 包含可修正的措辞，我会改写后发回你确认
- **🚫 违规** — 包含红线内容，直接拒绝并说明原因
支持单个文本审核，也可以批量发（多条用换行分隔）。
**开始吧。**
调用知识库
在工作流中添加知识库检索节点，选择前面创建的内容合规规则库。该节点的输入使用用户输入，输出供后续 AI 节点引用。
这个节点的目的不是让模型阅读完整规则库，而是把与当前内容最相关的规则片段召回给后续审核节点。引用上限可以先设置为 1-2 条，保证提示词上下文足够聚焦；如果规则库较大或分类较细，再逐步提高引用数量。
配置内容审核节点
添加 AI 对话节点，并重命名为“内容审核节点”。该节点负责根据用户输入和知识库规则输出分类结果。
你是一个内容合规审核专家。结合知识库检索到的合规规则，判断用户输入内容的合规等级。
分类标准：
- 安全：内容无敏感信息，可以直接发布
- 敏感可改：包含可修正的敏感措辞，改写后可发布
- 违规：包含红线内容，不可发布
输出格式：
仅输出三个词之一：安全 / 敏感可改 / 违规
注意：知识库引用处必须选择前面创建的知识库，否则 AI 无法读取规则内容。
审核节点的输出要尽量稳定，因为它会直接影响判断器分支。快速演示时可以只输出“安全 / 敏感可改 / 违规”三个词；如果后续要做更严格的自动化集成，可以改成结构化输出，例如同时返回分类、原因和命中的规则，方便下游节点做精确匹配和日志记录。
测试审核节点
点击右上角运行，输入一段待审核内容，确认审核节点能够返回稳定的分类结果。
这一步建议单独测试节点，而不是等全部流程搭完再调试。可以分别输入正常活动通知、包含绝对化宣传的营销文案、明显违规的文本，观察分类是否符合预期。如果分类不稳定，优先调整规则库表达和审核 Prompt，再继续配置后续分支。
隐藏中间输出
点击模型右侧的设置按钮，调整节点基础设置。由于用户只需要最终结果，建议隐藏内容审核节点的中间输出。
配置判断器
添加判断器节点，根据内容审核节点输出的“安全 / 敏感可改 / 违规”进入不同分支。
判断器相当于流程中的分流开关。上一步输出越稳定，判断器越容易配置；如果审核节点输出包含解释性文字，判断条件就可能匹配失败。因此在分支类工作流中，通常要先约束上游节点的输出格式，再配置判断器条件。
配置安全分支
当审核结果为“安全”时，直接输出原文即可。生产场景中也可以增加抽样复核或人工确认。
输出效果如下：
配置敏感可改分支
当审核结果为“敏感可改”时，添加 AI 对话节点自动改写内容。可以使用以下 Prompt：
你是一个内容改写专家。将用户输入的内容改写为合规版本。
改写原则：
- 保留原意和信息量，不改变核心表达
- 将绝对化用语替换为客观表述，例如“最好的”改为“行业领先的”
- 将未证实的数据表述替换为合理推测，例如“100% 有效”改为“多数用户反馈有效”
- 将敏感措辞替换为中性表达
- 保持原文风格和语气
改写完成后，可以添加用户选择节点，让用户选择接受改写、继续改写或放弃。
人工确认节点适合放在有风险但可修正的路径上。AI 可以负责提出改写建议，但是否发布仍交给业务人员确认。这样既能减少人工初筛和反复改稿的时间，也不会把最终发布权完全交给自动化流程。
如果用户接受改写，输出改写结果；如果用户选择继续改写，可连接回内容改写节点；如果用户放弃，则输出原文。
配置违规分支
当审核结果为“违规”时，添加 AI 对话节点输出拒绝说明。可以使用以下 Prompt：
用户提交的内容因涉及违规信息无法发布。请用礼貌、专业的语气说明原因。
输出格式：
1. 一句话说明内容无法发布
2. 列举具体的违规点（1-3 条）
3. 提供替代建议（如：建议修改哪些方面后重新提交）
验证完整流程
分别输入安全内容、敏感内容和违规内容，确认三条分支都能返回预期结果。
完整流程验证时，建议记录每条测试内容的输入、审核分类、进入分支和最终输出。若输出不符合预期，按节点顺序排查：先看知识库是否召回正确规则，再看审核节点分类是否准确，最后看判断器条件和分支输出是否配置正确。
Agent V2 适合开放式、多步骤、需要动态规划的任务。与工作流不同，工作流需要提前定义每一步；Agent V2 更适合“步骤不固定”的任务，例如数据分析、文件处理、多工具协作和需要追问澄清的复杂问题。
本案例模拟运营、产品或销售团队的日常数据分析需求：上传 Excel 文件后，直接用自然语言提出问题，让 Agent 自主读取文件、制定分析计划，并在虚拟机中执行分析。
案例三的工作流需要你先设计“检索规则 → 分类 → 分支 → 改写或拒绝”的固定路径；Agent V2 则更像一个可以自主规划的执行者。你不需要提前定义每一步，只需要提供目标和文件，Agent 会根据数据结构和问题复杂度决定先读取文件、再做统计、是否需要追问、是否需要运行代码。
数据分析很适合用来体验 Agent V2，因为它天然具备三个特点：分析路径不固定、经常需要多步推理、需求可能需要澄清。同一份 Excel，不同用户可能关心产品销量、渠道 ROI、区域趋势或异常订单，固定工作流很难提前覆盖所有路径，而 Agent V2 可以根据问题动态规划。
创建 Agent V2 应用
工作台点击新建应用，选择 对话 Agent V2(Beta)，名称填写为 智能数据分析 Agent。
配置模型与 Prompt
AI 配置继续使用 GLM-5.1 模型。系统提示词可以参考：
你是一个资深数据分析师 Agent。你可以读取用户上传的数据文件、在沙箱中运行 Python 分析代码、并主动向用户追问澄清需求。
工具：
- 📄 **读取文件** — 读取用户上传的 Excel/CSV 数据
- 💻 **沙箱执行** — 运行 Python 脚本（pandas/matplotlib/numpy）
- ❓ **主动追问** — 分析需求不明确时向用户确认
工作方式：
1. 收到数据和问题后，先读取文件了解数据结构和内容
2. 制定分析计划，以步骤列表展示给用户
3. 按计划逐步执行，每步展示关键发现
4. 遇到模糊需求时主动追问，如指标定义不明确或缺少对比基准
5. 根据追问结果动态更新计划
6. 输出分析报告，包含数据概览、核心发现、可视化图表、业务建议
安全规则：
- 沙箱中只能做数据分析，禁止访问网络，禁止写文件到宿主机
- 数据仅用于本次分析，不在报告中暴露原始敏感数据
- 不确定的结论标注置信度
输出格式：
1. 📋 分析计划（根据数据自动生成）
2. 📊 数据概览（行数、列名、缺失值、基本统计）
3. 🔍 核心发现（3-5 个关键洞察，图表辅助）
4. 💡 业务建议（基于数据的可操作建议）
这段 Prompt 的重点是让 Agent 先规划再执行，而不是直接给结论。对于数据分析类任务，先读取数据结构、确认字段含义、制定分析计划，可以显著减少误解需求或误用指标的风险。正式使用时，可以继续补充企业内部指标定义，例如 GMV、ROI、转化率、有效客户、复购率等口径。
配置开场白
开场白用于引导用户上传数据文件并提出分析问题：
你好！我是智能数据分析 Agent 📊
直接把 Excel 或 CSV 文件拖进来，告诉我你想分析什么。
例如：
- "分析这份销售数据，找出销量最好的产品和趋势"
- "帮我看看用户活跃度的变化，找出下降的原因"
- "对比三个渠道的转化率，哪个 ROI 最高？"
我会先了解你的数据，制定分析计划，然后在沙箱中运行分析代码。
需要确认的地方我会主动问你。
开启虚拟机能力
数据分析通常需要读取文件并执行代码，因此需要开启虚拟机配置。
虚拟机能力用于隔离代码执行环境。Agent 可以在其中运行数据分析脚本、读取上传文件、生成统计结果，但不会直接影响本地宿主环境。对于需要运行 Python、处理 Excel、绘制图表或做批量计算的场景，这是 Agent V2 区别于普通对话应用的重要能力。
上传文件并测试
上传销售数据示例文件，并输入问题：
帮我分析这份销售数据，看看哪些产品卖得好，哪个渠道 ROI 最高
Agent 会先拆解任务，再逐步执行分析。
执行过程中可以看到任务在虚拟机中运行，不会影响本地环境。
测试时重点观察 Agent 是否具备完整的分析过程：是否先识别表格字段，是否解释分析计划，是否在需要时运行代码，是否根据结果给出业务建议。如果问题描述不清晰，理想行为不是强行分析，而是先向用户追问关键口径。
最终结果应包含分析计划、数据概览、关键发现和业务建议。
结果验证时建议关注四个维度：结论是否来自实际数据，指标口径是否清楚，图表或统计是否能支撑结论，业务建议是否可执行。数据分析 Agent 的价值不只是输出一段总结，而是把“读数据、算指标、解释结果、提出建议”的过程串起来。
完成四个案例后，可以把 FastGPT 的常见应用类型理解为从简单到复杂的能力递进：对话 Agent 解决“怎么回答和生成内容”，知识库解决“基于什么资料回答”，工作流解决“按什么固定流程处理”，Agent V2 解决“面对开放任务如何自主规划和执行”。
| 应用类型 | 适合场景 | 核心能力 |
|---|---|---|
| 对话 Agent | 轻量问答、文案生成、标准化输出 | Prompt、模型配置、工具调用 |
| 知识库 + 对话 Agent | 基于资料、制度、法条、产品手册的问答 | 文件导入、知识库检索、引用原文 |
| 工作流 | 固定步骤、条件分支、审核流、自动化处理 | 节点编排、判断器、人工确认 |
| Agent V2 | 数据分析、复杂任务、多步推理、动态规划 | 自主规划、工具调用、虚拟机执行 |
选型时可以按任务复杂度判断：
实际项目中也可以组合使用这些能力。例如客服助手可以使用知识库回答产品问题，再通过工具查询订单；内容审核可以用工作流固定审核路径，同时用知识库维护规则；数据分析场景可以先用 Agent V2 完成探索，再把稳定下来的分析步骤沉淀成工作流。