使用工作流规划旅游行程

场景介绍

工作流体现的是一个具体的业务场景，通过一系列不同功能节点中的触发事件和执行动作编排而成，AI原生应用引擎通过将传统工具API和大模型编排在一起实现复杂的工作流。工作流可在用户创建Agent时调用，Agent使用过程中，当起始节点触发，后续动作即可自动执行，完成一系列复杂的任务。

本实践中，工作流主要完成如下任务：根据用户输入的城市，获取该城市的实时天气及实时空气质量，调用大模型生成旅游规划，将旅游规划内容作为整个工作流的输出。同时，还支持以短信的形式发送温馨提醒到用户手机。

旅游规划工作流全景图

图1 旅游规划工作流

准备工作

本实践选用平台预置的开源模型chatglm3-6b作为旅游规划模型，首次使用该模型服务API需要订购免费的“ChatGLM3-6B大模型服务API在线调用”资源，订购操作请参见购买AppStage。

构建旅游规划工作流

1. 在AI原生应用引擎的左侧导航栏，选择“Agent编排中心 > 我的工作流”。
2. 在“我的工作流”页面，单击“创建工作流”。
3. 在“基本信息”对话框，设置工作流名称、描述，单击“确认”。
   • 工作流名称：旅游规划。
   • 描述：本应用实时更新天气预报、空气质量检测，为您规划旅游行程并发送贴心提醒，让您的出行准备轻松无忧。

4. 在工作流构建页面，添加节点和执行动作，并配置各节点输入、输出参数。
   1. 配置起始节点。

      起始节点是工作流的入口，可以接受和存储初始化参数，当Agent调用工作流时，会提取起始节点入参，并初始化工作流实例，随后按照工作流定义的逻辑顺序执行各个节点。

      在请求体参数列表中，单击操作列的，定义string类型的变量city，用于存储用户输入的城市名称；定义array类型的变量phoneNumber，用于存储Agent问答时用户输入手机号。

      图2 配置起始节点
      
   2. 添加“实时天气”节点。
      此节点可根据用户输入的城市名称，获取对应城市的实时天气。

      1. 在“起始节点”下单击“ > 添加执行动作”，在“工具节点”页签中选择“华为天气”，执行动作选择为“实时天气”。
      2. 配置输入参数，选择起始节点的变量city作为输入参数。
      图3 配置实时天气节点
      
   3. 添加“实时查询空气质量”节点。
      此节点可根据城市名称，获取对应城市的实时空气质量。

      1. 在“实时天气”节点下单击“ > 添加执行动作”，在“工具节点”页签中选择“华为空气质量”，执行动作选择为“实时查询空气质量”。
      2. 配置输入参数，选择“实时天气”节点的输出参数“城市”，作为该节点的输入。
         图4 配置实时查询空气质量节点
         
   4. 添加“chat”节点。
      向大模型输入指令，要求大模型根据查询到的实时天气和实时空气质量生成旅游规划。

      1. 在“实时查询空气质量”节点下单击“ > 添加执行动作”，在“基础节点”页签中选择“LLM”，执行动作选择为“chat”。
      2. 配置输入参数，请参见表1。

         表1 LLM节点输入参数配置说明

         参数	说明
         模型服务调用ID	对于平台预置的模型服务，可以在资产中心选择“大模型”页签，单击模型卡片进入模型详情页面，查看模型服务调用ID。 此处选择资产中心预置的第三方模型chatglm3-6b，模型服务调用ID为platform:chatglm3-6b。
         消息	角色：user，表示用户向大模型提问。 对话内容：在对话内容中将前置节点查询到的城市、实时天气和实时空气质量输入给大模型，要求大模型生成旅行规划。

         图5 chat节点输入参数配置
         
      3. 在节点实例区域，单击“新增实例”，填写实例名称、描述及API Key。

         实例是节点的鉴权方式，如果未新增实例，节点就无法调通。

         您可以单击“获取API key”跳转至“我的凭证”页面获取API Key，具体介绍请参见新增平台API Key。

         图6 新增实例
         
   5. 添加“遍历集合元素”节点。
      起始节点中定义的phoneNumber为array格式变量，可以存储多个手机号，此节点用于对phoneNumber进行遍历以便向每个手机号发送短信。

      1. 在“chat”节点下单击“ > 添加执行动作”，在“基础节点”页签中选择“控制”，执行动作选择为“遍历集合元素”。
      2. 配置输入参数，选择起始节点的变量phoneNumber作为输入参数。
         图7 遍历集合元素节点配置
         
   6. 添加“发送短信”节点。
      此节点用于向遍历到的每一个手机号发送短信。

      1. 在“遍历集合元素”节点下单击“ > 添加执行动作”，在“工具节点”页签中选择“华为短信”，执行动作选择为“发送短信”。
      2. 配置输入参数。

         收件人：选择为编辑集合元素节点的循环内容。

         短信内容：结合前置节点查询到的城市、实时天气和实时空气质量结果，自定义温馨提醒。

         图8 发送短信节点配置
         
   7. 添加“构造JSON对象”节点。
      chat节点的输出消息内容为字符串类型，结束节点的响应体中只接受对象或数组类型。因此，在将chat输出的内容传递给结束节点前，需要添加“构造JSON对象”，将基本类型组装成对象。

      1. 在“遍历集合元素”区域下方，单击“ > 添加执行动作”，在“基础节点”页签中选择“JSON构造器”，执行动作选择为“构造JSON对象”。
      2. 配置输入参数，将chat节点输出的对话内容作为输入。
         图9 构造JSON对象节点配置
         
   8. 添加“结束节点”。
      结束节点是整条工作流的输出返回。

      1. 在“构造JSON对象”节点下单击“ > 添加执行动作”，在“基础节点”页签中选择“结束”，执行动作选择为“结束节点”。
      2. 配置输入参数，选择回答模式为“由Agent生成回答”，响应体选择为“构造JSON对象”节点的响应体。
         表示Agent调用工作流时，Agent会将chat节点的消息内容进行总结，然后返回给用户。

         图10 结束节点配置
         

5. 配置完成后，单击“保存”。
6. 在“流保存成功”弹框中单击“确定”，立即开启流，启用后的工作流才能进行测试以及在创建Agent时调用。

测试工作流

1. 在工作流列表中，单击工作流名称，进入工作流查看页面。
2. 单击“测试”，在测试面板，输入city和phoneNumber，单击“提交测试”。
   图11 测试
   

3. 查看测试结果。
4. 单击“查看运行历史详情”，在运行详情页面，查看本次测试过程中工作流的运行总次数、成功次数、失败次数，以及各节点的执行时长、输入参数及输出参数等，方便定位问题。