
# 搭建一个旅游小助手Agent
AI原生应用引擎是企业专属的一站式大模型开发及应用构建平台，无论是研发技术人员还是业务人员，都可通过简易的界面化操作快速搭建Agent。
本文以创建"旅游小助手"为例介绍如何在AI原生应用平台创建Agent。
#### Agent效果
整合天气、景点及火车票信息，为用户提供全面的旅游辅助服务。
图1火车票查询   
![](https://support.huaweicloud.com/qs-appstage/zh-cn_image_0000002341751324.png "点击放大")
图2天气查询   
![](https://support.huaweicloud.com/qs-appstage/zh-cn_image_0000002341591560.png "点击放大")
#### 准备工作
- 已购买AppStage AI原生应用引擎并完成初始化配置，具体操作请参见[快速购买AppStage AI原生应用引擎并完成初始化配置](https://support.huaweicloud.com/qs-appstage/appstage_03_0002.html)。
- 本文选用平台接入的第三方模型glm-4-0520作为思考模型和问答模型，请参考如下操作设置模型鉴权：
  1. 在AI原生应用引擎左侧导航栏选择"模型中心 \> 我的模型服务 \> 我接入的 \> 供应商模型"。
  
  2. 在模型供应商列表，在"智谱AI"模型供应商对应的"操作"列下，单击"鉴权配置"。
  
  3. 根据界面提示前往智谱AI的官网申请鉴权信息。
  
  4. 在弹框中填写模型鉴权信息，单击"保存"。
   
- 本文中Agent需要添加平台接入的第三方工具铁路查询v2、天气查询进行能力扩展，第三方工具使用前需设置鉴权，此处以设置铁路查询v2鉴权为例进行介绍，天气查询工具设置鉴权的方式相同，此处不再赘述：
  1. 在AI原生应用引擎的左侧导航栏选择"资产中心"，选择"工具"页签。
  
  2. 将鼠标光标移至"铁路查询v2"卡片上，单击"设置鉴权"。
  
  3. "设置鉴权信息"弹框中展示了工具鉴权获取方式的链接，通过界面链接获取"铁路查询v2"的鉴权信息。
     图3设置鉴权信息   
     ![](https://support.huaweicloud.com/qs-appstage/zh-cn_image_0000002375669473.png "点击放大") 
  
  4. 在"设置鉴权信息"弹框中填写鉴权信息，单击"保存"。
   
 
#### 创建Agent
1. 在AI原生应用引擎的左侧导航栏选择"Agent编排中心 \> 我的Agent"，单击"创建Agent"。
2. 在"创建Agent"页面左上角选择"单Agent（自主规划模式）"。
3. 配置Agent基础信息。您也可以单击"智能修改"，优化基础信息，自动生成Agent头像。 
   表1基础信息参数说明 
   | 参数      | 示例                                                                             | 说明                                        |
   |:---|:---|:---|
   | Agent名称 | **旅游小助手**                                                                      | 设置Agent名称，不能以数字、下划线开头，不能包含特殊字符，长度2-19个字符。 |
   | Agent描述 | **专注于为您打造个性化旅行体验，无论是探秘未知的目的地，还是精心安排的特色行程，我们都能为您提供专业建议和周到规划，让您的每一次旅行都充满惊喜与回忆。** | Agent的相关描述，长度不超过200个字符。                   |
      
   
   
4. 选择模型。 
   本文选用glm-4-0520作为思考模型和问答模型。
   
   
5. 配置Agent角色设定。您也可以单击![](https://support.huaweicloud.com/qs-appstage/zh-cn_image_0000002375589381.png)，根据Agent基础信息智能生成角色设定。
   
   在角色设定中输入希望Agent完成的任务目标、具备的组件能力以及对输出答案的要求与限制等。本文中，旅游助手设定如下：
   ```
   角色定义：
   作为旅游小助手，我的任务是整合天气、景点及火车票信息，为用户提供全面的旅游辅助服务。我需要确保用户能够轻松获取实时天气预报、热门景点推荐以及便捷的火车票查询服务，以提升旅行体验。
   工具能力：
   信息整合：能够整合各类旅游相关信息，为用户提供综合性的旅游规划建议。
   实时天气预报获取：具备通过API获取全球各地实时天气信息的能力，为用户出行提供参考。
   火车票查询：具备通过API查询火车票能力，根据客户需求和时间安排，设计合理的往返行程。
   要求与限制：
   准确性：提供的所有旅游信息必须准确无误，避免给用户造成误导。
   实时性：确保所有信息实时更新，尤其在天气和票务方面。
   用户偏好分析：在推荐景点时，需充分考虑用户的个人偏好和历史数据。
   信息安全：严格保护用户个人信息，确保隐私安全。
   ```
   
   
6. 为Agent添加技能。 
   在很多实际场景中，Agent的功能设计可能超出了单一模型的能力范围，比如需要访问外部资源（如实时数据、API服务等），或者涉及复杂的逻辑处理等，仅通过编写角色设定及添加模型，无法满足Agent要求，这时需要为Agent添加技能（工具、工作流），进行能力拓展。本文中，旅游助手需要根据实时天气设计旅游行程，需要根据火车票规划符合预算的最优旅行方案，我们需要通过为Agent添加工具来实现，此处以平台预置的查询当前天气和火车票查询工具为例。
   图4添加工具   
   ![](https://support.huaweicloud.com/qs-appstage/zh-cn_image_0000002380779676.png)
   
   
7. 为Agent添加开场白和推荐问题。 
   开场白：您好！我是旅游小助手，您的出行小帮手。我汇集了天气、景点及火车票信息，致力于为您提供全面的旅游辅助。无论是实时天气预报，还是热门景点推荐，亦或票务查询，我都将竭诚为您服务。请随时告诉我您的旅行需求，我会为您提供专业的帮助。
   单击推荐问题区域的![](https://support.huaweicloud.com/qs-appstage/zh-cn_image_0000002341591564.png)，添加推荐问题：
   - 如何根据小助手的天气预报避免旅行中的恶劣天气影响。
   
   - 推荐几个热门的旅游城市。
   
   - 如何根据实时天气预报选择最佳的旅游出行时间。
   
   
   图5对话设置   
   ![](https://support.huaweicloud.com/qs-appstage/zh-cn_image_0000002375669477.png)
   
   
8. 单击"保存"。
 
#### 体验Agent
Agent创建完成后，您可以向Agent发送消息进行测试。如果创建的Agent与您的需求存在偏差，您可以调整Agent配置，例如修改Agent的角色设定、为Agent添加工具、工作流、知识库等配置，直至满足需求。
1. 在创建Agent页面，单击"Agent预览"区域的"开始体验"。
2. 在对话框中输入问题，单击![](https://support.huaweicloud.com/qs-appstage/zh-cn_image_0000002375589385.png "点击放大")。
   
   图6Agent预览   
   ![](https://support.huaweicloud.com/qs-appstage/zh-cn_image_0000002341751332.png "点击放大")
   
   
 
#### 发布Agent
Agent发布后，用户即可通过API接口调用或Web界面进行访问。
1. 在创建Agent页面，单击"发布"。
2. 选择发布渠道并设置发布密钥，单击"发布"。 
   表2发布参数说明 
   | 参数     | 示例                                                                                                                                                                                                                                                                                                             | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   |:---|:---|:---|
   | 选择发布渠道 | **Web Url**                                                                                                                                                                                                                                                                                                    | - API：以API的方式发布Agent，发布成功后可复制API地址进行分享。  - Web Url：以Web Url的方式发布Agent，发布成功后可复制Web链接进行分享。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | 设置发布密钥 | **sk-30f4077ae94876d91\*\*\*\*\*\*\*\*2746d4895ed51412b11d6d18d6571ade8176f02**                                                                                                                                                                                                                                | 设置该密钥是确保发布分享Agent后，用户能正常调用Agent相关联的模型、工具、工作流和知识库。 输入AI原生应用引擎平台API Key，获取方式请参见[新增平台API Key](https://support.huaweicloud.com/usermanual-wiseagent/appstage_04_0704.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 部署资源   | - **选择发布方式：免费额度。**  - **节点数量：单节点部署。**   | - 选择发布方式 - 免费额度：每个租户有3个免费额度，使用免费额度发布Agent运行速度相对缓慢。  - 运行时引擎SKU额度：请参见[购买AI原生应用引擎](https://support.huaweicloud.com/usermanual-appstage/appstage_04_0005.html)进行订购，一个额度代表一个节点数量。    - 节点数量 - 使用免费额度发布，默认为单节点部署。  - 使用运行时引擎SKU额度发布，可选择多节点集群部署。     |
      
   
   
3. 发布后，在Agent列表的"复制发布地址"列，单击![](https://support.huaweicloud.com/qs-appstage/zh-cn_image_0000002341591568.png)，复制发布地址进行分享。
 
#### 相关文档
- AI原生应用引擎当前支持创建LLM模式和工作流模式两种类型的Agent，具体介绍请参见[创建并发布Agent](https://support.huaweicloud.com/usermanual-wiseagent/appstage_04_0597.html)。
- 除手动搭建Agent外，AI原生应用引擎还支持自动生成Agent，相关入门介绍请参见[自动生成美食探秘师Agent](https://support.huaweicloud.com/qs-appstage/appstage_03_0006.html)。
- Agent发布后支持通过API方式调用，请参考[调用Agent](https://support.huaweicloud.com/api-appstage/ExcuteAgent.html)。
 
