搭建一个旅游小助手Agent

Agent效果

整合天气、景点及火车票信息，为用户提供全面的旅游辅助服务。

图1 火车票查询

图2 天气查询

准备工作

• 已购买AppStage AI原生应用引擎并完成初始化配置，具体操作请参见快速购买AppStage AI原生应用引擎并完成初始化配置。
• 本文选用平台接入的第三方模型glm-4-0520作为思考模型和问答模型，请参考如下操作设置模型鉴权：
  1. 在AI原生应用引擎左侧导航栏选择“模型中心 > 我的模型服务 > 我接入的 > 供应商模型”。
  2. 在模型供应商列表，在“智谱AI”模型供应商对应的“操作”列下，单击“鉴权配置”。
  3. 根据界面提示前往智谱AI的官网申请鉴权信息。
  4. 在弹框中填写模型鉴权信息，单击“保存”。
• 本文中Agent需要添加平台接入的第三方工具铁路查询v2、天气查询进行能力扩展，第三方工具使用前需设置鉴权，此处以设置铁路查询v2鉴权为例进行介绍，天气查询工具设置鉴权的方式相同，此处不再赘述：
  1. 在AI原生应用引擎的左侧导航栏选择“资产中心”，选择“工具”页签。
  2. 将鼠标光标移至“铁路查询v2”卡片上，单击“设置鉴权”。
  3. “设置鉴权信息”弹框中展示了工具鉴权获取方式的链接，通过界面链接获取“铁路查询v2”的鉴权信息。
     图3 设置鉴权信息
     
  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角色设定。您也可以单击，根据Agent基础信息智能生成角色设定。

   在角色设定中输入希望Agent完成的任务目标、具备的组件能力以及对输出答案的要求与限制等。本文中，旅游助手设定如下：

   角色定义：
   作为旅游小助手，我的任务是整合天气、景点及火车票信息，为用户提供全面的旅游辅助服务。我需要确保用户能够轻松获取实时天气预报、热门景点推荐以及便捷的火车票查询服务，以提升旅行体验。
   工具能力：
   信息整合：能够整合各类旅游相关信息，为用户提供综合性的旅游规划建议。
   实时天气预报获取：具备通过API获取全球各地实时天气信息的能力，为用户出行提供参考。
   火车票查询：具备通过API查询火车票能力，根据客户需求和时间安排，设计合理的往返行程。
   要求与限制：
   准确性：提供的所有旅游信息必须准确无误，避免给用户造成误导。
   实时性：确保所有信息实时更新，尤其在天气和票务方面。
   用户偏好分析：在推荐景点时，需充分考虑用户的个人偏好和历史数据。
   信息安全：严格保护用户个人信息，确保隐私安全。

6. 为Agent添加技能。

   在很多实际场景中，Agent的功能设计可能超出了单一模型的能力范围，比如需要访问外部资源（如实时数据、API服务等），或者涉及复杂的逻辑处理等，仅通过编写角色设定及添加模型，无法满足Agent要求，这时需要为Agent添加技能（工具、工作流），进行能力拓展。本文中，旅游助手需要根据实时天气设计旅游行程，需要根据火车票规划符合预算的最优旅行方案，我们需要通过为Agent添加工具来实现，此处以平台预置的查询当前天气和火车票查询工具为例。

   图4 添加工具
   

7. 为Agent添加开场白和推荐问题。

   开场白：您好！我是旅游小助手，您的出行小帮手。我汇集了天气、景点及火车票信息，致力于为您提供全面的旅游辅助。无论是实时天气预报，还是热门景点推荐，亦或票务查询，我都将竭诚为您服务。请随时告诉我您的旅行需求，我会为您提供专业的帮助。

   单击推荐问题区域的，添加推荐问题：

   • 如何根据小助手的天气预报避免旅行中的恶劣天气影响。
   • 推荐几个热门的旅游城市。
   • 如何根据实时天气预报选择最佳的旅游出行时间。
   图5 对话设置
   

8. 单击“保存”。

体验Agent

Agent创建完成后，您可以向Agent发送消息进行测试。如果创建的Agent与您的需求存在偏差，您可以调整Agent配置，例如修改Agent的角色设定、为Agent添加工具、工作流、知识库等配置，直至满足需求。

1. 在创建Agent页面，单击“Agent预览”区域的“开始体验”。
2. 在对话框中输入问题，单击。
   图6 Agent预览
   

发布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。
   部署资源	选择发布方式：免费额度。 节点数量：单节点部署。	选择发布方式 免费额度：每个租户有3个免费额度，使用免费额度发布Agent运行速度相对缓慢。 运行时引擎SKU额度：请参见购买AI原生应用引擎进行订购，一个额度代表一个节点数量。 节点数量 使用免费额度发布，默认为单节点部署。 使用运行时引擎SKU额度发布，可选择多节点集群部署。

3. 发布后，在Agent列表的“复制发布地址”列，单击，复制发布地址进行分享。

相关文档

• AI原生应用引擎当前支持创建LLM模式和工作流模式两种类型的Agent，具体介绍请参见创建并发布Agent。
• 除手动搭建Agent外，AI原生应用引擎还支持自动生成Agent，相关入门介绍请参见自动生成美食探秘师Agent。
• Agent发布后支持通过API方式调用，请参考调用Agent。