更新 docSite 文档内容 (#3131)

docSite/content/zh-cn/docs/faq/_index.md

@@ -6,6 +6,6 @@ draft: false
 toc: true
 weight: 900
 ---
-<!-- 9800 ~ 1000 -->
+<!-- 900 ~ 1000 -->
 
 FastGPT 是一个由用户和贡献者参与推动的开源项目，如果您对产品使用存在疑问和建议，可尝试[加入社区](community)寻求支持。我们的团队与社区会竭尽所能为您提供帮助。

docSite/content/zh-cn/docs/faq/app.md

@@ -4,7 +4,7 @@ description: 'FastGPT 常见应用使用问题，包括简易应用、工作流
 icon: 'quiz'
 draft: false
 toc: true
-weight: 903
+weight: 908
 ---
 
 ## 工作流中多轮对话场景中如何使连续问题被问题分类节点正确的归类

docSite/content/zh-cn/docs/faq/chat.md

@@ -4,7 +4,7 @@ description: 'FastGPT 常见聊天框问题'
 icon: 'quiz'
 draft: false
 toc: true
-weight: 905
+weight: 906
 ---
 
 ## 我修改了工作台的应用，为什么在“聊天”时没有更新配置？

docSite/content/zh-cn/docs/faq/dataset.md

@@ -4,7 +4,7 @@ description: '常见知识库使用问题'
 icon: 'quiz'
 draft: false
 toc: true
-weight: 904
+weight: 910
 ---
 
 ## 上传的文件内容出现中文乱码

docSite/content/zh-cn/docs/faq/docker.md

@@ -4,7 +4,7 @@ description: 'FastGPT Docker 部署问题'
 icon: ''
 draft: false
 toc: true
-weight: 901
+weight: 902
 type: redirect
 target: /docs/development/docker/#faq
 ---

docSite/content/zh-cn/docs/faq/error.md

@@ -1,7 +1,15 @@
 ---
-title: '常见错误'
+title: '报错'
 icon: 'quiz'
 draft: false
 toc: true
-weight: 920
----
+weight: 914
+---
+
+1. ### 当前分组上游负载已饱和，请稍后再试(request id:202407100753411462086782835521)
+
+是oneapi渠道的问题，可以换个模型用or换一家中转站
+
+1. ### 使用API时在日志中报错Connection Error 
+
+大概率是api-key填写了openapi，然后部署的服务器在国内，不能访问海外的api，可以使用中转或者反代的手段解决访问不到的问题

docSite/content/zh-cn/docs/faq/external_channel_integration.md

@@ -0,0 +1,18 @@
+---
+title: "接入外部渠道"
+description: "如何通过外部渠道与 FastGPT 集成，实现对多种平台的支持"
+icon: "integration"
+draft: false
+toc: true
+weight: 912
+---
+
+1. ### 接入cow，图文对话无法直接显示图片
+
+提示词给引导，不要以markdown格式输出。图片需要二开 cow 实现图片链接截取并发送。
+
+1. ### 可以获取到用户发送问答的记录吗
+
+在应用的对话日志里可以查看。
+
+![](/imgs/integration1.png)

docSite/content/zh-cn/docs/faq/other.md

@@ -3,7 +3,7 @@ title: '其他问题'
 icon: 'quiz'
 draft: false
 toc: true
-weight: 925
+weight: 918
 ---
 
 ## oneapi 官网是哪个

docSite/content/zh-cn/docs/faq/points_consumption.md

@@ -0,0 +1,14 @@
+---
+title: "积分消耗"
+description: "了解 FastGPT 中的积分消耗机制和使用场景"
+icon: "points"
+draft: false
+toc: true
+weight: 916
+---
+
+1. ### 接入oneapi后，为什么还会消耗fastgpt的积分
+
+矢量数据库检索会默认消耗。可以查看看绑定提示和使用记录。
+
+![](/imgs/points1.png)

docSite/content/zh-cn/docs/faq/privateDeploy.md

@@ -4,7 +4,7 @@ description: "FastGPT 私有部署常见问题"
 icon: upgrade
 draft: false
 images: []
-weight: 902
+weight: 904
 type: redirect
 target: /docs/development/faq/
 ---

docSite/content/zh-cn/docs/guide/_index.md

@@ -0,0 +1,9 @@
+---
+weight: 100
+title: '功能介绍'
+description: 'FastGPT 的功能和使用指南'
+icon: 'import_contacts'
+draft: false
+images: []
+---
+<!-- 100 ~ 500 -->

docSite/content/zh-cn/docs/guide/course/_index.md

@@ -6,4 +6,4 @@ icon: 'import_contacts'
 draft: false
 images: []
 ---
-<!-- 100 ~ 300 -->
+<!-- 100 ~ 200 -->

docSite/content/zh-cn/docs/guide/course/ai_settings.md

@@ -4,7 +4,7 @@ description: "FastGPT AI 相关参数配置说明"
 icon: "sign_language"
 draft: false
 toc: true
-weight: 102
+weight: 104
 ---
 
 在 FastGPT 的 AI 对话模块中，有一个 AI 高级配置，里面包含了 AI 模型的参数配置，本文详细介绍这些配置的含义。

docSite/content/zh-cn/docs/guide/course/chat_input_guide.md

@@ -4,7 +4,7 @@ description: "FastGPT 对话问题引导"
 icon: "code"
 draft: false
 toc: true
-weight: 108
+weight: 106
 ---
 
 ![](/imgs/questionGuide.png)

docSite/content/zh-cn/docs/guide/course/quick-start.md

@@ -4,7 +4,7 @@ description: '快速体验 FastGPT 基础功能'
 icon: 'rocket_launch'
 draft: false
 toc: true
-weight: 101
+weight: 102
 ---
 
 更多使用技巧，[查看视屏教程](https://www.bilibili.com/video/BV1sH4y1T7s9)

docSite/content/zh-cn/docs/guide/knowledge_base/RAG.md

@@ -4,7 +4,7 @@ description: '本节详细介绍RAG模型的核心机制、应用场景及其在
 icon: 'language'
 draft: false
 toc: true
-weight: 106
+weight: 402
 ---
 
 [RAG文档](https://huggingface.co/docs/transformers/model_doc/rag)
@@ -83,7 +83,7 @@ RAG（检索增强生成）模型通过结合检索器和生成器，实现了
 RAG模型的性能很大程度上取决于检索器返回的文档质量。由于生成器主要依赖检索器提供的上下文信息，如果检索到的文档片段不相关、不准确，生成的文本可能出现偏差，甚至产生误导性的结果。尤其在多模糊查询或跨领域检索的情况下，检索器可能无法找到合适的片段，这将直接影响生成内容的连贯性和准确性。
 
 - 挑战：当知识库庞大且内容多样时，如何提高检索器在复杂问题下的精确度是一大挑战。当前的方法如BM25等在特定任务上有局限，尤其是在面对语义模糊的查询时，传统的关键词匹配方式可能无法提供语义上相关的内容。
-- 解决途径：引入混合检索技术，如结合稀疏检索（BM25）与密集检索（如向量检索）。例如，[Faiss](https://fael3z0zfze.feishu.cn/wiki/LULawsUufitGvWkDjx3cKJqHnle?from=from_copylink)的底层实现允许通过BERT等模型生成密集向量表示，显著提升语义级别的匹配效果。通过这种方式，检索器可以捕捉深层次的语义相似性，减少无关文档对生成器的负面影响。
+- 解决途径：引入混合检索技术，如结合稀疏检索（BM25）与密集检索（如向量检索）。例如，Faiss的底层实现允许通过BERT等模型生成密集向量表示，显著提升语义级别的匹配效果。通过这种方式，检索器可以捕捉深层次的语义相似性，减少无关文档对生成器的负面影响。
 
 #### 4.2.2 生成器的计算复杂度与性能瓶颈
 

docSite/content/zh-cn/docs/guide/knowledge_base/_index.md

@@ -0,0 +1,9 @@
+---
+weight: 400
+title: '知识库'
+description: '知识库的基础原理、搜索方案、Web站点同步和外部文件知识库的使用方法。'
+icon: 'book'
+draft: false
+images: []
+---
+<!-- 400 ~ 450 -->

docSite/content/zh-cn/docs/guide/knowledge_base/dataset_engine.md

@@ -4,7 +4,7 @@ description: '本节会详细介绍 FastGPT 知识库结构设计，理解其 QA
 icon: 'language'
 draft: false
 toc: true
-weight: 106
+weight: 404
 ---
 
 ## 理解向量

docSite/content/zh-cn/docs/guide/knowledge_base/externalFile.md

@@ -4,7 +4,7 @@ description: 'FastGPT 外部文件知识库功能介绍和使用方式'
 icon: 'language'
 draft: false
 toc: true
-weight: 107
+weight: 408
 ---
 
 外部文件库是 FastGPT 商业版特有功能。它允许接入你现在的文件系统，无需将文件再导入一份到 FastGPT 中。

docSite/content/zh-cn/docs/guide/knowledge_base/websync.md

@@ -4,7 +4,7 @@ description: 'FastGPT Web 站点同步功能介绍和使用方式'
 icon: 'language'
 draft: false
 toc: true
-weight: 105
+weight: 406
 ---
 
 ![](/imgs/webSync1.jpg)

docSite/content/zh-cn/docs/guide/plugins/_index.md

@@ -0,0 +1,9 @@
+---
+weight: 300
+title: '系统插件'
+description: '介绍如何使用和提交系统插件，以及各插件的填写说明'
+icon: 'extension'
+draft: false
+images: []
+---
+<!-- 300 ~ 400 -->

docSite/content/zh-cn/docs/guide/plugins/bing_search_plugin.md

@@ -0,0 +1,32 @@
+---
+title: "Bing 搜索插件填写说明"
+description: "FastGPT Bing 搜索插件配置步骤详解"
+icon: "bing_search"
+draft: false
+toc: true
+weight: 306
+---
+
+1. # 打开微软Azure官网，登陆账号
+
+https://portal.azure.com/
+
+![](/imgs/bing_search_plugin1.png)
+
+1. # 创建bing web搜索资源
+
+搜索Bing Search v7，点击创建
+
+https://portal.azure.com/#create/Microsoft.BingSearch
+
+![](/imgs/bing_search_plugin2.png)
+
+1. # 进入资源详情点击管理密钥
+
+![](/imgs/bing_search_plugin3.png)
+
+# 4. 复制任意一个密钥填入插件输入
+
+![](/imgs/bing_search_plugin4.png)
+
+![](/imgs/bing_search_plugin5.png)

docSite/content/zh-cn/docs/guide/plugins/doc2x_plugin_guide.md

@@ -0,0 +1,26 @@
+---
+title: "Doc2x 插件填写说明"
+description: "如何配置和使用 Doc2x 插件"
+icon: "doc_transform"
+draft: false
+toc: true
+weight: 308
+---
+
+1. # 打开docx官网，创建账号，并复制 apikey
+
+https://doc2x.noedgeai.com/
+
+![](/imgs/doc2x_plugin1.png)
+
+![](/imgs/doc2x_plugin2.png)
+
+1. # 填写apikey到fastgpt中
+
+**工作流****中：**
+
+![](/imgs/doc2x_plugin3.png)
+
+**简易模式使用：**
+
+![](/imgs/doc2x_plugin4.png)

docSite/content/zh-cn/docs/guide/plugins/google_search_plugin_guide.md

@@ -0,0 +1,32 @@
+---
+title: "Google 搜索插件填写说明"
+description: "FastGPT Google 搜索插件配置指南"
+icon: "google_search"
+draft: false
+toc: true
+weight: 304
+---
+
+1. # 创建Google Custom Search Engine
+
+https://programmablesearchengine.google.com/
+
+我们连到Custom Search Engine control panel 建立Search Engine
+
+![](/imgs/google_search_plugin1.png)
+
+取得搜索引擎的ID，即cx
+
+![](/imgs/google_search_plugin2.png)
+
+1. # 获取api key
+
+https://developers.google.com/custom-search/v1/overview?hl=zh-cn
+
+![](/imgs/google_search_plugin3.png)
+
+1. # 填入插件输入参数
+
+将搜索引擎ID填入cx字段，api key填入key字段
+
+![](/imgs/google_search_plugin4.png)

docSite/content/zh-cn/docs/guide/plugins/how_to_submit_system_plugin.md

@@ -0,0 +1,118 @@
+---
+title: "如何提交系统插件"
+description: "FastGPT 系统插件提交指南"
+icon: "plugin_submission"
+draft: false
+toc: true
+weight: 302
+---
+
+> 如何向 FastGPT 社区提交系统插件
+
+## 系统插件原则
+
+- 尽可能的轻量简洁，以解决实际问题的工具为主
+- 不允许有密集 cpu 计算，不会占用大量内存占用或网络消耗
+- 不允许操作数据库
+- 不允许往固定的私人地址发送请求（不包含请求某些在线服务，例如 gapier, firecrawl等)
+- 不允许使用私人包，可使用主流的开源包
+
+## 什么插件可以合并
+
+由于目前未采用按需安装的模式，合并进仓库的插件会全部展示给用户使用。
+
+为了控制插件的质量以及避免数量过多带来的繁琐，并不是所有的插件都会被合并到开源仓库中，你可以提前 PR 与我们沟通插件的内容。
+
+后续实现插件按需安装后，我们会允许更多的社区插件合入。
+
+## 如何写一个系统插件 - 初步
+
+FastGPT 系统插件和用户工作台的插件效果是一致的，所以你需要提前了解“插件”的定义和功能。
+
+在 FastGPT 中，插件是一种特殊的工作流，它允许你将一个工作流封装起来，并自定义入口参数和出口参数，类似于代码里的 “子函数”。
+
+1. ### 跑通 FastGPT dev 环境
+
+需要在 dev 环境下执行下面的操作。
+
+1. ### 在 FastGPT 工作台中，创建一个插件
+
+选择基础模板即可。
+
+![](/imgs/plugin_submission1.png)
+
+1. ### 创建系统插件配置
+
+系统插件配置以及自定义代码，都会在 **packages/plugins** 目录下。
+
+1. 在 **packages/plugins/src** 下，复制一份 **template** 目录，并修改名字。
+2. 打开目录里面的 template.json 文件，配置如下：
+3. 目录还有一个 index.ts 文件，下文再提。
+
+```TypeScript
+{
+  "author": "填写你的名字", 
+  "version": "当前系统版本号",
+  "name": "插件名",
+  "avatar": "插件头像，需要配成 icon 格式。直接把 logo 图在 pr 评论区提交即可，我们会帮你加入。",
+  "intro": " 插件的描述，这个描述会影响工具调用",
+  "showStatus": false, // 是否在对话过程展示状态
+  "weight": 10, // 排序权重，均默认 10
+
+  "isTool": true, // 是否作为工具调用节点
+  "templateType": "tools", // 都填写 tools 即可，由官方来分类
+
+  "workflow": { // 这个对象先不管，待会直接粘贴导出的工作流即可
+    "nodes": [],
+    "edges": []
+  }
+}
+```
+
+1. 打开 **packages/plugins/register** 文件，注册你的插件。在 list 数组中，加入一个你插件目录的名字，如下图的例子。如需构建插件组（带目录），可参考 DuckDuckGo 插件。
+
+无需额外写代码的插件，直接放在 staticPluginList 内，需要在项目内额外写代码的，写在 packagePluginList 中。
+
+![](/imgs/plugin_submission2.png)
+
+1. ### 完成工作流编排并测试
+
+完成工作流编排后，可以点击右上角的发布，并在其他工作流中引入进行测试（此时属于团队插件）。
+
+1. ### 复制配置到 template.json
+
+鼠标放置在左上角插件的头像和名称上，会出现对于下拉框操作，可以导出工作流配置。
+
+导出的配置，会自动到剪切板，可以直接到 template.json 文件中粘贴使用，替换步骤 2 中，**workflow** 的值。
+
+![](/imgs/plugin_submission3.png)
+
+1. ### 验证插件是否加载成功
+
+刷新页面，打开系统插件，看其是否成功加载，并将其添加到工作流中使用。
+
+![](/imgs/plugin_submission4.png)
+
+1. ### 提交 PR
+
+如果你觉得你的插件需要提交到开源仓库，可以通过 PR 形式向我们提交。
+
+- 写清楚插件的介绍和功能
+- 配上插件运行的效果图
+- 插件参数填写说明，需要在 PR 中写清楚。例如，有些插件需要去某个提供商申请 key，需要附上对应的地址和教材，后续我们会加入到文档中。
+
+## 写一个复杂的系统插件 - 进阶
+
+这一章会介绍如何增加一些无法单纯通过编排实现的插件。因为可能需要用到网络请求或第三方包。
+
+上一章提到，在插件的 **template** 目录下，还有一个 **index.ts** 文件，这个文件就是用来执行一些插件的代码的。你可以通过在 HTTP 节点中的 URL，填写插件的名字，即可触发该方法，下面以 **duckduckgo/search** 这个插件为例：
+
+![](/imgs/plugin_submission5.png)
+
+![](/imgs/plugin_submission6.png)
+
+![](/imgs/plugin_submission7.png)
+
+参考上面 3 张图片，当 HTTP 节点的 URL 为系统插件注册的名字时，该请求不会以 HTTP 形式发送，而是会请求到 index.ts 文件中的 main 方法。出入参则对应了 body 和自定义输出的字段名。
+
+由于目前插件会默认插件输出均作为“工具调用”的结果，无法单独指定某些字段作为工具输出，所以，请避免插件的自定义输出携带大量说明字段。

docSite/content/zh-cn/docs/guide/team_permissions/_index.md

@@ -0,0 +1,9 @@
+---
+weight: 450
+title: '团队与权限'
+description: '团队管理、成员组与权限设置，确保团队协作中的数据安全和权限分配合理。'
+icon: 'group'
+draft: false
+images: []
+---
+<!-- 450 ~ 500 -->

docSite/content/zh-cn/docs/guide/team_permissions/team_roles_permissions.md

@@ -0,0 +1,8 @@
+---
+title: "团队&成员组&权限"
+description: "如何管理 FastGPT 团队、成员组及权限设置"
+icon: "group"
+draft: false
+toc: true
+weight: 450
+---

docSite/content/zh-cn/docs/guide/workbench/_index.md

@@ -0,0 +1,9 @@
+---
+weight: 200
+title: '工作台'
+description: 'FastGPT 工作台及工作流节点的使用说明'
+icon: 'dashboard'
+draft: false
+images: []
+---
+<!-- 200 ~ 300 -->

docSite/content/zh-cn/docs/guide/workbench/basic-mode.md

@@ -0,0 +1,8 @@
+---
+weight: 202
+title: '简易模式'
+description: '快速了解 FastGPT 工作台的简易模式'
+icon: 'speed'
+draft: false
+images: []
+---

docSite/content/zh-cn/docs/guide/workbench/gapier.md

@@ -4,7 +4,7 @@ description: "FastGPT 使用 Gapier 快速导入Agent工具"
 icon: "build"
 draft: false
 toc: true
-weight: 501
+weight: 300
 ---
 
 FastGPT V4.7版本加入了工具调用，可以兼容 GPTs 的 Actions。这意味着，你可以直接导入兼容 GPTs 的 Agent 工具。

docSite/content/zh-cn/docs/guide/workbench/intro.md

@@ -1,10 +1,10 @@
 ---
-title: "高级编排介绍"
-description: "快速了解 FastGPT 高级编排"
-icon: "circle"
+title: "工作流&插件"
+description: "快速了解 FastGPT 工作流和插件的使用"
+icon: "extension"
 draft: false
 toc: true
-weight: 301
+weight: 220
 ---
 
 FastGPT 从 V4 版本开始采用新的交互方式来构建 AI 应用。使用了 Flow 节点编排（工作流）的方式来实现复杂工作流，提高可玩性和扩展性。但同时也提高了上手的门槛，有一定开发背景的用户使用起来会比较容易。

docSite/content/zh-cn/docs/guide/workbench/workflow/_index.md

@@ -0,0 +1,9 @@
+---
+weight: 230
+title: '工作流节点'
+description: 'FastGPT 工作流节点设置和使用指南'
+icon: 'workflow'
+draft: false
+images: []
+---
+<!-- 200 ~ 300 -->