# 搭建文件解析工作流 #### 场景介绍 大模型本身不具备直接读取和解析文件的能力，无法处理文件字节流等原始数据。为弥补这一限制，支持工具调用（Function Calling）的模型可以通过插件接入外部工具API，从而拓展能力边界。资产中心提供了丰富的插件，例如文件解析插件能够将指定链接对应的文件内容解析为纯文本，供大模型进一步理解和处理。 本文将演示如何在工作流中配置文件解析插件节点，实现对word文件的自动解析与内容提取。 #### 效果展示 上传需要解析的word文件，如[图1]所示，文件解析效果如[图2]所示。 图1上传word文件 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389521.png) 图2效果展示 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389525.png "点击放大") #### 工作流设计 重点介绍工作流中的一些主要节点，每个节点负责特定的任务。以下是各个节点的功能和设计思路。 - 开始节点：作为工作流的入口，开始节点负责接收用户输入的问题以及word文件。 - 插件节点-文件解析：该节点将文件内容解析为纯文本。 - 大模型节点：根据解析后的文本，回答用户的问题。 - 结束节点：展示大模型节点针对文件解析结果生成的回复。 图3文件解析工作流全景 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549393.png "点击放大") #### 操作步骤 搭建工作流详细步骤如下： #### 步骤一：创建工作流 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 单击左侧导航栏"开发中心 \> 智能体管理 "，单击左上角"工作流"页签，进入工作流应用管理界面，单击右上角"创建工作流"。 3. 选择创建"对话型工作流"，在对应的创建页面，配置工作流相关信息，具体如[图4]所示，参数如[表1]所示。 图4创建工作流 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949778.png "点击放大") 表1参数说明 | 参数名称 | 示例 | 说明 | |:---|:---|:---| | 名称 | 文件解析 | 支持中英文、数字、下划线、中划线和空格，长度 2\~64字符，但不允许以空格开头或结尾。 | | 描述 | 文件解析 | 描述工作流的功能，可直观呈现给用户，长度0\~1024个字符。 | 4. 配置完成后单击"立即创建"，进入工作流编排页面。 #### 步骤二：添加插件节点 1. 单击开始节点和大模型节点中间的![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549401.png)，添加插件节点，选择来自插件广场的"文件解析"插件，单击"添加"，如[图5]所示。 该插件用于解析word文件。 图5添加插件 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549405.png "点击放大") 添加完成后，工作流如[图6]所示。 图6文件解析工作流 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789924.png "点击放大") #### 步骤三：配置工作流节点 工作流各个核心节点的配置方式如下： 表2节点配置说明 | 节点类型 | 说明 | 示例 | |:---|:---|:---| | 开始节点 | 添加一个必选的输入参数，即用户需要解析的word文件。 - 参数名称：doc - 参数类型：File/Doc - 描述：待解析的doc文件 - 必填：勾选。 | ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789918.png "点击放大") | | 插件节点-文件解析 | 此节点用来解析word文件。 **输入参数：**file_url，引用开始节点的doc。其余参数保持默认值即可。 | ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789906.png "点击放大") | | 大模型节点 | 此节点通过用户提示词将问题和文件解析结果输入给大模型，大模型会自动总结文件信息，并生成对应的回复。 - **模型配置**：选择合适的模型。 - **输入参数：** - query，引用开始节点的query。 - content，引用"文件解析"插件节点的content。 - **提示词配置：** - 系统提示词：定义一段系统提示词，如下所示。 ``` 你是一名专业的文档分析助手，擅长理解和处理各类文档。 规则： 1. 严格基于文档内容作答，不编造信息 2. 如文档内容不足以完成用户指令，请明确说明 3. 输出使用清晰的结构化格式（分点、表格等） 4. 涉及数字、日期、金额等关键信息时，保持原文精确引用 ``` - 用户提示词：引用当前的输入参数query，即引用用户的原始输入。 ``` 请根据以下用户指令处理文档内容。 用户指令：{{query}} 文档内容：{{content}} ``` | ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549411.png "点击放大") | | 结束节点 | 此节点用于展示大模型节点针对文件解析结果生成的回复。 - **输入参数：**result，引用大模型节点的raw_output。 - **指定回复：** ``` {{result}} ``` | ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949780.png "点击放大") | #### 步骤四：调试工作流 1. 配置完成后，在工作流编排界面单击右上角![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389519.png)，在试运行配置中的doc框中，上传需要解析的word文件，如[图7]所示。配置完成后单击"开始运行"。 图7上传word文件 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549399.png) 2. 在"试运行"对话框中，输入"请解析"，效果如[图8]所示。 图8效果展示 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389525.png "点击放大") #### 步骤五：提交版本 1. 工作流试运行成功后，在工作流编排页面，单击右上角"提交版本"。 2. 输入版本号与版本描述，如[图9]所示。 图9提交版本 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949378.png "点击放大") #### 相关文档 - 编排工作流时，画布相关的详细操作介绍，请参见[创建工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0047.html)。 - 在创建和运行工作流时，可能会遇到的常见问题，请参见《[常见问题](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0001.html)》。 - 工作流创建完成后，如果需要通过API调用，则需要将提交的版本部署至实例，具体操作请参考[发布并部署工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0053.html)。