跳转到主内容
版本:开发版

开始组件

工作流中的起始组件。


开始组件用于设置开场问候语或接受用户的输入。当您创建智能体(Agent)时,无论是从模板创建还是从头开始(从空白模板创建),它都会自动填充到画布上。工作流中应该只有一个开始组件。

使用场景

在所有情况下,开始组件都是必不可少的。每个智能体都包含一个开始组件,且该组件无法删除。

配置

点击该组件以显示其配置窗口。在这里,您可以设置开场问候语和智能体的输入参数(全局变量)。

模式

模式定义了工作流如何被触发。

  • 对话式:智能体通过对话被触发。
  • 任务式:智能体在没有对话的情况下启动。

开场问候语

仅限对话模式。

在对话模式下,智能体以开场问候语开始。这是智能体在对话模式下向用户发送的第一条消息,可以是一句欢迎辞或引导用户继续操作的指令。

全局变量

您可以在开始组件中定义全局变量,这些变量可以是必需的或可选的。一旦设置,用户在与智能体互动时需要为这些变量提供值。点击+ 添加变量来添加一个全局变量,每个变量具有以下属性:

  • 名称必需
    提供有关变量更多详细信息的描述性名称。
  • 类型必需
    变量的类型。
    • 单行文本:接受不含换行符的单行文本。
    • 段落文本:接受包含换行符的多行文本。
    • 下拉选项:要求用户从下拉菜单中为该变量选择一个值。您需要为下拉菜单设置至少一个选项。
    • 文件上传:要求用户上传一个或多个文件。
    • 数字:接受一个数字作为输入。
    • 布尔值:要求用户在开启和关闭之间切换。
  • 必需
    唯一的变量名。
  • 可选:一个切换开关,指示该变量是否为可选。
注意

要从客户端传入参数,请调用:

重要

如果将键类型设置为文件,请确保上传文件的令牌(token)数量不超过您的模型提供商的最大令牌限制;否则,文件中的纯文本将被截断且不完整。

注意

您可以通过设置环境变量 DOC_BULK_SIZEEMBEDDING_BATCH_SIZE 来调整文档解析和嵌入的效率。

常见问题

上传的文件是否在知识库中?

否。作为输入上传到智能体的文件不会存储在知识库中,因此不会使用 RAGFlow 内置的 OCR、DLR 或 TSR 模型进行处理,也不会使用 RAGFlow 内置的分块方法进行分块。

上传文件的文件大小限制

对于上传到智能体的文件,没有具体的文件大小限制。但是,请注意,模型提供商通常有默认或明确的最大令牌设置,范围可能从 8196 到 128k 不等:上传文件的纯文本部分将作为键值传入,但如果文件的令牌数超过此限制,字符串将被截断且不完整。

注意

/docker/.env 中的变量 MAX_CONTENT_LENGTH/docker/nginx/nginx.conf 中的 client_max_body_size 设置了每次上传到知识库或文件管理的文件大小限制。这些设置不适用于此场景。