对话型工作流、任务型工作流区别 工作流包含两种类型： 对话型工作流。面向多轮交互的开放式问答场景，基于用户对话内容提取关键信息，输出最终结果。适用于客服助手、工单助手、娱乐互动等场景。 任务型工作流。面向自动化处理场景，基于输入内容直接输出结果，无中间的对话交互过程。适用于内容生成、批量翻译、数据分析等场景。 任务型工作流不支持配置输入节点、消息节点、提问器节点和Agent节点。 图1 任务型工作流 表1 区别说明 差异项 对话型工作流 任务型工作流 适用场景 客服助手、工单助手、娱乐互动等场景。 内容生成、批量翻译、数据分析等场景。 节点 支持输入节点、消息节点、提问器节点。 不支持输入节点、消息节点、提问器节点。 试运行方式 试运行界面与任务型工作流不同。 若“开始”节点有多个参数，先对除query参数外的参数进行配置，然后再以对话窗口的形式进行试运行。 若“开始”节点有多个参数，在试运行时，需要对多个输入参数同时进行配置。

知识检索节点 知识检索节点可以基于用户的输入，从指定知识库内召回匹配的信息，并将匹配结果以列表形式返回。该节点支持选择用户创建的知识库，创建步骤请详见创建知识库。 知识检索节点配置步骤如下： 拖动左侧“知识检索”节点至画布中，单击该节点以打开节点配置页面。 连接知识检索节点和其他节点。 参照表1，完成大模型节点的配置。 表1 知识检索节点配置说明 配置类型 参数名称 参数说明 参数配置 输入参数 参数名称：输入参数固定只有1个，参数名称为query且不可修改，类型是字符串，表示待知识检索的问题。 类型、值：支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点的输出变量值，限制String类型，适用于需要从前置节点输出中获取知识检索问题的场景。 输入：支持用户自定义输入问题，适用于知识检索问题固定的场景。 输出参数 知识检索节点的输出是一个对象数组，参数名是output_list，表示所有满足检索要求的知识切片。数组中对象有三个属性： document_name，知识切片所在的知识文档名称。 content，知识切片的内容。 score，知识切片的匹配度得分，output_list中的元素按照得分由高到低排序。 后续节点引用该输出参数，可以引用output_list，此时将获取全量的检索结果，包括文档名、切片内容和分数。也可以直接引用切片的属性，比如content，此时将获取output_list中第一条记录的切片内容。 知识库 知识库 支持选择用户所创建的知识库。 相关度阈值 得分低于相关度阈值的搜索结果会被过滤，可以参考知识库命中测试的相关度分值调整该阈值。 取值范围为0~1。 topk召回数量 从知识库中召回的最大切片数量，如topk召回数量为5，则得分不在前5的切片将被过滤。 取值范围为1~50。 FAQ直出阈值 知识库中有得分超过该阈值的FAQ会被召回，此时不再检索知识库内的文档。如果没有满足阈值要求的FAQ，则会继续检索知识库内的文档。可以参考知识库FAQ命中测试结果调整该阈值。 取值范围为0~1。 图1 知识检索节点配置示例 节点配置完成后，单击“确定”。 父主题： 工作流节点配置参考

测试工作流 当前仅支持post请求调用测试，也可以使用其他调测工具进行调测。 流保存成功后，单击页面右上角的“测试”。 您也可以在工作流列表中，单击工作流名称，进入工作流查看页面，单击“测试”。 在测试面板，输入参数，单击“提交测试”。 查看测试结果。 单击“查看运行历史详情”，在运行详情页面，查看本次测试过程中工作流的运行总次数、成功次数、失败次数，以及各节点的执行时长、输入参数及输出参数等，方便定位问题。

运行代码配置说明 表1 运行代码配置参数说明 参数 是否必填项 说明 函数名称 是 选择下拉列表中的函数，一般是之前已定义保存的函数，也可以进行以下操作。 单击：可以直接在弹出的“创建函数”页面快速创建函数，参数说明如表2所示，参数配置完成后可单击“创建”保存函数。 单击：选择函数后，单击该图标可以在弹出的“编辑函数”页面中快速编辑函数，参数编辑完成后可单击“更新”保存函数。 输入参数 是 按照函数定义中指定的参数列表配置入参，即传递给函数的实际值。 输入参数或选择前序节点的输出作为输入。 节点备注 否 输入节点备注信息，方便后续查阅节点功能。 表2 创建函数参数说明 参数 说明 名称 函数名，用于调用函数。 描述 函数功能描述。 入参 输入参数。 出参 输出参数。每个变量都可在后置节点中引用。 执行语言 当前仅支持Python3.9，即运行函数的环境，请查看Python函数开发指南。 编辑源码 在源码编辑区，编写函数内部的代码运行逻辑，如图1所示，图中各模块说明如下： ①：导入模块，是Python标准库中的模块，无需修改。 ②：用户自定义导入模块。 ③：公共函数使用方法示例，提供了如何使用公共函数和mssiAuthData参数的示例，无需修改。 ④：函数定义和注释，extractRequestParam函数和handler函数是系统预置的模板代码，无需修改。 ⑤：系统方法，无需修改。 ⑥：用户自定义函数中的逻辑。 依赖包 单击“添加”，可以选择私有依赖包或公共依赖包。私有依赖包上传方法请参见管理函数依赖包，公共依赖包介绍请参见内置函数介绍。 一个函数最多添加20个依赖包。 图1 源码编辑区

响应示例 状态码： 200 ok { "dependencies" : [ { "id" : "6578de50-9a18-48fa-b84e-b2d36636e433", "owner" : "public", "link" : "https://{obs_endpoint}/functionstage-examples/fg_test_pandas_1.1.3.zip", "runtime" : "Python3.6", "etag" : "35a893d9495b3e22259b2773996bc94d-6", "size" : 31009808, "name" : "panda1.1.3" } ], "next_marker" : 43, "count" : 43 }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 dependencies Array of ListDependencyVersionsResult objects 依赖包列表 next_marker Long 下次读取位置 count Long 依赖包总数 表5 ListDependencyVersionsResult 参数 参数类型 描述 id String 依赖包版本ID owner String 依赖包拥有者，public标识为公共依赖包 link String 依赖包在obs的存储地址 runtime String FunctionGraph函数的执行环境 Python2.7: Python语言2.7版本。 Python3.6: python语言3.6版本。Python3.9: Python语言3.9版本。 Python3.10: Python语言3.10版本。Go1.x: Go语言1.x版本。Java8: Java语言8版本。Java11: Java语言11版本。Node.js6.10: Nodejs语言6.10版本。Node.js8.10: Nodejs语言8.10版本。Node.js10.16: Nodejs语言10.16版本。Node.js12.13: Nodejs语言12.13版本。Node.js14.18: Nodejs语言14.18版本。Node.js16.17: Nodejs语言16.17版本。Node.js18.15: Nodejs语言18.15版本。C#(.NET Core 2.1): C#语言2.1版本。C#(.NET Core 3.1): C#语言3.1版本。Custom: 自定义运行时。PHP7.3: Php语言7.3版本。Cangjie1.0：仓颉语言1.0版本。http: HTTP函数。Custom Image: 自定义镜像函数。 枚举值： Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 Node.js16.17 Node.js18.15 Python2.7 Python3.6 Python3.10 Go1.x C#(.NET Core 2.1) C#(.NET Core 3.1) Custom PHP7.3 Python3.9 http Custom Image Cangjie1.0 etag String 依赖包唯一标志（MD5校验值） size Long 依赖包大小 name String 依赖包名 file_name String 依赖包文件名 description String 依赖包描述。 version Long 依赖包版本号 last_modified Long 依赖包更新时间 dep_id String 依赖包ID is_shared Boolean 是否共享（已废弃） 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息

URI GET /v2/{project_id}/fgs/dependencies/{depend_id}/version 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户项目 ID，获取方式请参见获取项目ID。 depend_id 是 String 依赖包的ID。 表2 Query参数 参数 是否必选 参数类型 描述 marker 否 String 上一次查询依赖包的最后记录位置，默认为"0"。 maxitems 否 String 单次查询最大条数

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 [数组元素] Array of ServiceBridgeVersion objects 表5 ServiceBridgeVersion 参数 参数类型 描述 name String 代码包名 version String 代码版本 code_url String 代码所在obs路径 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 id String 测试事件ID。 name String 测试事件名称。 content String 测试事件content。 last_modified Number 上次修改的时间。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 404 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息

URI GET /v2/{project_id}/fgs/functions/{function_urn}/events/{event_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户项目 ID，获取方式请参见获取项目ID。 function_urn 是 String 函数的URN，详细解释见FunctionGraph函数模型的描述。 event_id 是 String 测试事件ID

计费示例（无扩容包） 假设您在2023年11月01日，购买了AstroFlow专业版有效期1年，并在到期前手动续费1年，则： 第一个计费周期为：2023/11/01 15:50:04 ~ 2024/11/01 23:59:59 第二个计费周期为：2024/11/01 23:59:59 ~ 2025/11/01 23:59:59 续费时需支付的费用为AstroFlow规格套餐包年/包月的费用（费用以官网实际费用为准）。

计费示例（包含扩容包） 假设您在2023年11月01日，购买了AstroFlow专业版有效期1年，同时订购了3个单元的人数扩容包和2个单元的资源扩容包。那么1年的费用计算过程如下： 套餐费用：4980元 * 1年 = 4980元 人数扩容包费用：3000元 * 3单元 * 1年 = 9000元 资源扩容包费用：47760元 * 2单元 * 1年 = 95520元 综上，1年的费用 = 4980 + 9000 + 95520 = 109500元

计费说明 根据您选择的版本规格进行计费。当购买专业版和企业版套餐时，计费项还包括人数扩容包和资源扩容包。如您需要快速了解Astro工作流服务的具体价格，请参见Astro工作流价格详情。 表1 AstroFlow计费项 计费项 计费项说明 适用的计费模式 计费公式 套餐规格 AstroFlow提供了不同的规格套餐，请根据自身需求，购买相应的规格套餐。 基础版：满足个人及创业团队的基础需求，用户能够低门槛入门使用该产品。 专业版：满足中大企业搭建复杂业务场景的需求，提供了更多定制和集成的功能。 企业版：满足大企业搭建高性能复杂场景的需求，支持高级流程和表单的设计。 各套餐详细介绍，请参见计费模式。 包年/包月 基础版：免费。 专业版和企业版：套餐版本单价 * 购买时长。 说明： 购买一年套餐享受优化价，例如，购买时长为1年时，实付10个月。 购买时长 购买AstroFlow套餐包的时长。 基础版支持购买1~12个月。 专业版和企业版支持购买1~9个月或者1年。 人数扩容包 AstroFlow移专业版和企业版提供了人数扩容包，请根据业务需求，购买相应数量的扩容包。 人数扩容包（人数扩容50人/单元）：用于新增更多的组织用户数。不可单独购买和退订，专业版和企业版套餐到期后，扩容包将不可使用。 包年/包月 扩容包单价 * 购买时长（以主套餐有效时间折算）。 资源扩容包 AstroFlow专业版及企业版提供了资源扩容包，请根据业务需求，购买相应数量的扩容包。 资源扩容包（总数据调用次数20万/单元/每月）：提供更多的数据调用次数。不可单独购买和退订，专业版和企业版套餐到期后，扩容包将不可使用。 包年/包月 扩容包单价 * 购买时长（以主套餐有效时间折算）。

响应参数 状态码： 400 表2 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 request_id String 请求ID 最小长度：2 最大长度：512 状态码： 404 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 request_id String 请求ID 最小长度：2 最大长度：512

URI POST /v2/{project_id}/fgs/workflows/{workflow_id}/executions/{execution_id}/retry 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方式请参见获取项目ID。 最小长度：1 最大长度：64 workflow_id 是 String 函数工作流 ID 最小长度：1 最大长度：512 execution_id 是 String 函数流执行实例ID 最小长度：1 最大长度：64