# 使用模板搭建智能体 #### 案例概述 AgentArts资产广场为您提供了丰富的应用模板，涵盖了单智能体、工作流等多种形态的成熟资产，旨在帮助用户快速复用热门应用方案。 本章节将引导您使用AgentArts资产广场中的"城市文旅推荐"单智能体应用模板，带您在零代码环境下体验从一键复制到关键配置的全流程。针对旅行规划中信息零散、方案编制繁琐的挑战，该智能体能基于用户偏好，快速生成包含路线建议、开放时段及预算详情的专业攻略，并直接导出为.docx格式文件。 通过本次单智能体的构建实践，您将直观感受到AgentArts资产广场的便利性，掌握如何将预置资产高效转化为符合自身需求的个性化服务。 图1城市文旅推荐智能体效果预览 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421533.png "点击放大") #### 操作流程 使用AgentArts资产广场的应用模板，仅需三步即可快速搭建您的专属智能体应用。 图2使用模板快速搭建智能体应用流程 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538541710.png) | 操作步骤 | 说明 | |:---|:---| | [准备工作] | 注册华为账号并开通华为云、完成实名认证，开通AgentArts服务。 | | [步骤一：获取资产广场模板] | 访问资产广场，选择应用模板，将其预置的完整配置方案一键复制至您的工作空间中。 | | [步骤二：使用应用模板配置单智能体] | 基于应用模板的预置配置进行自定义微调，并结合调试预览窗口完成效果验证。 | #### 准备工作 在使用AgentArts智能体开发平台前，需要参考如下内容，提前申请华为账号并完成实名认证。 1. 进入[华为云官网](https://www.huaweicloud.com/)，单击页面右上角的"注册"。 2. 参考[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)中操作，完成注册。 3. 注册成功后，进行实名认证。 - 个人账号：[个人实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0077914254.html) - 企业账号：[企业实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0077914253.html) 如果您使用的是IAM用户，也可使用该账户开通AgentArts服务。 4. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，参考[开通AgentArts](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0000.html)开通服务。 #### 步骤一：获取资产广场模板 1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)。 2. 单击左侧导航栏的"资产广场"，进入资产广场界面。 资产广场为您提供一系列丰富的模板和资源工具，在这里您可以使用平台为您预置的各类应用模板和资源工具，也可以使用您所属的团队空间共享的资产，关于资产广场的更多说明请参考[资产中心介绍](https://support.huaweicloud.com/productdesc-agentarts0/agentarts_03_0028.html)。 图3资产广场 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421501.png "点击放大") 3. 在"应用模板"界面，找到"城市文旅推荐"应用模板。 图4城市文旅推荐应用模板 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421527.png "点击放大") - 立即体验：进入与城市文旅推荐单智能体应用的对话界面，体验与该智能体对话。 - 复制创建：直接将应用复制到当前空间下，进入"单智能体配置"界面。 4. 单击"立即体验"进入与"城市文旅推荐"智能体的对话界面。在对话界面，可输入问题体验该智能体的功能。 #### 步骤二：使用应用模板配置单智能体 单击右上角的"复制到当前空间"按钮，在成功复制弹窗中单击"确定"，即可直接跳转到该"单智能体配置"界面，开启您的自定义配置。 应用模板已预置了该单智能体的核心能力，支持**开箱即用** 或**按需调整**。在本例中，不会对智能体进行实际的配置调整，将重点解析各项配置的设定逻辑与调整技巧，旨在帮助您理解"为何调整"以及"如何优化"智能体表现。 表1单智能体配置界面板块介绍 | 界面板块 | ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421507.png "点击放大") | ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538381784.png "点击放大") | ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538381762.png "点击放大") | |---|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------:| | **介绍** | 配置单智能体的基本信息和提示词，定义智能体"是谁"。 - 单智能体信息：设置应用名称和应用描述。 - 提示词：定义单智能体的角色设定、任务目标和行为规范。 | 为单智能体扩展各类能力和功能模块，让它从"会说话"变成"真正能帮上忙"的智能助手。 - 模型配置：模型是智能体的"大脑"，不同模型在理解能力、推理速度、知识储备上各有特点。 - 技能：添加MCP服务、插件或工作流，为智能体添加可调用的外部能力。 - 知识库：关联专业领域的知识库，为智能体提供权威信息支撑。 - 记忆：配置可记忆的上下文信息，即变量，使智能体能够记住用户偏好等个性化信息，让对话更连贯。 - 对话体验：设置开场白、推荐问题、追问及音色，优化用户与智能体的交互感受。 - 安全：配置内容审核和安全护栏，确保智能体的回复内容合法合。 | 实时测试单智能体效果，验证"好不好用"。 在"预览调试"区域可进行对话交互，即时验证配置修改后的效果。 | 了解了三个版面的基本功能后，以下将详细介绍各配置项的作用，以及本模板已预置了哪些内容。建议配合右侧"预览调试"窗口进行实时对话，在实践中掌握配置优化的技巧。 身份与指令 - 本模板已预置了智能体的"单智能体信息"与"提示词"，使"城市文旅推荐"智能体拥有明确的身份定位和工作指令。 | 配置项 | 说明 | |:---|:---| | 单智能体信息 | 单智能体的头像、名称和描述，赋予智能体基本的身份标识，用于对外展示该智能体。 | | 提示词 | 提示词是智能体的"指令说明书"，修改提示词会直接影响智能体的回答结果。模板已预制了一套指令，规定了智能体的人设、任务和执行步骤等关键指令，让智能体知道该如何工作。 提示词与下方的"能力组件"相辅相成。虽然模型具备一定的自主判断能力，但为了确保回复的稳定性，**建议在调整能力组件后，同步在提示词中明确告知智能体在何种场景下调用特定工具**。 关于提示词的更多介绍请参考[提示词介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0176.html)。 | 能力组件 - 本模板已预置了适配的模型和文档生成插件，使"城市文旅推荐"智能体具备问答推理和生成城市文旅文档的能力。您也可以根据需求添加更多能力组件。 图5执行能力配置 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421487.png "点击放大") | 配置项 | 说明 | |:---|:---| | 模型配置 | 模型是智能体的"大脑"，决定了智能体的理解能力、推理速度和回复质量等，可以根据每个模型下方的能力标签来快速判断其是否符合需求。本模板已为您选定了适配的大模型，您也可以根据需求配置其他大模型体验。关于模型配置的更多介绍请参考[配置模型](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0017.html)。 | | 技能 | 技能是智能体的"能力工具箱"，让智能体能够调用外部服务、执行具体任务。 - 插件：插件是其中一种核心的组件类型，是与外部世界交互的一系列工具。模板已默认添加了**文档生成插件** ，使其可以直接撰写并生成.docx格式的文件。关于插件的更多介绍请参考[插件介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0123.html)。 - MCP服务：MCP服务是基于Model Context Protocol标准的通用连接器，通过标准化的接口，使智能体应用能够接入各类外部数据源与本地工具集，实现跨平台的能力扩展。关于MCP服务的更多介绍请参考[MCP介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0135.html)。 - 工作流：工作流是智能体执行任务的逻辑编排体系，定义任务的先后顺序、分支判断及自动化处理流程，适用于需要智能体执行固定业务逻辑的场景。添加工作流前需已有可用的工作流。关于工作流的更多介绍请参考[工作流介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0041.html)。 **配置说明与示例：** 添加技能后，建议在"提示词"中明确写出工具调用的指令。虽然模型具备一定的自主识别能力，但明确的指令能确保工具调用的准确率。 - 配置要求：在"提示词"的任务描述中，说明"场景+工具名+目的"。 - 示例：如添加了天气查询插件，可在提示词中补充"当用户询问天气相关问题时，请调用天气查询插件获取实时天气数据并告知用户。" - 验证是否生效：在右侧"预览调试"窗口提问，观察模型思考过程中是否显示"已调用XX工具"；或"预览调试"窗口右上角的"![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341565.png)"图标，通过调用链路确认工具执行的具体参数和返回结果。 如果未显示调用且直接回答，则需检查模型是否支持工具调用标签，或在提示词中进一步加强指令引导。 | | 知识库 | 知识库是智能体的"外挂书架"，使智能体能够在处理任务时精准检索并引用知识库中的内容回答问题。关于知识库的更多介绍请参考[知识库介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0148.html)。 **配置说明与示例：** - 配置要求：知识库需根据业务需求提前创建。添加知识库后，建议在"提示词"中明确引导智能体检索知识库。 - 示例：如添加景区知识库，可在提示词中补充"在回答用户关于景区政策、门票价格等问题时，请优先检索并参考关联知识库中的内容。如果知识库中没有相关信息，请告知用户不清楚，不要提供虚假信息。" - 验证是否生效：在右侧"预览调试"窗口提问，如果模型在思考过程中显示已调用工具；或"预览调试"窗口右上角的"![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421537.png)"图标，通过调用链路确认工具执行的具体参数和返回结果。如果模型未调用知识库或回答偏离事实，请检查提示词中是否已要求"优先参考知识库"，或尝试优化知识库内的分段描述。 | | 记忆 | 记忆中的变量相当于智能体的"记事本"，使智能体能够根据外部参数或用户偏好灵活调整回复逻辑，从而实现更具针对性的个性化服务。关于记忆的更多介绍请参考[为应用添加记忆](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0026.html)。 - 用户变量：用于存储用户在使用智能体过程中，需要持久化存储和读取的数据，如用户的语言偏好、个性化设置等，添加用户变量后可在"提示词"中以*{{memory.用户变量名}}*格式引用。 - 入参变量：用于在API调用时向智能体传入外部信息，通常用于固定组件参数或注入确定性的业务上下文。添加后可在工作流、插件、MCP服务的入参配置处引用，也可在"提示词"中以*{{input.入参变量名}}*格式引用。 **配置示例：** - 用户变量示例：添加了用户变量"user_preference"，记录用户偏好，默认值为"自然风光"，可在提示词中补充： ``` 根据用户的偏好 {{memory.user_preference}}，为其推荐合适的旅游线路。 ``` 当用户在对话中表达"我最近对历史古迹比较感兴趣"时，智能体会自动识别并将"user_preference"更新为"历史古迹"，后续推荐将围绕历史古迹类线路展开。 - 入参变量示例：添加入参变量"城市"，默认值设为"上海"。在"天气查询"插件的参数配置中引用该入参变量，并关闭"可见性"开关。配置完成后，无需在提问中提及城市名称，智能体将默认回复上海相关的天气信息。 | 对话体验 - 应用模板已预置了对话开场白、推荐问题、追问生成规则以及音色配置，用于提升与"城市文旅推荐"智能体的交互体验。关于对话体验的更多介绍请参考[提升应用对话体验](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0027.html)。 图6对话体验配置 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421479.png "点击放大") | 配置项 | 说明 | |:---|:---| | 开场白 | 开场白将在对话界面作为开场展示，可单击![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421519.png)图标AI生成开场白。 | | 推荐问题 | 推荐问题显示为对话框上方的快捷气泡，用户无需打字，用于引导用户提问，可单击![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538541730.png)图标AI生成推荐问题。 | | 追问 | 智能体回答完用户问题后，将根据配置的追问规则和上下文自动生成的3个追问问题，能有效引导用户进行多轮对话。 | | 音色 | 智能体在语音交互或朗读文本时使用的声音，可以根据智能体的使用场景从音色库中选择符合该智能体人设的声音。 | | 显示引用和归属 | 在单智能体配置并使用了联网搜索或知识库等工具时，开启"显示引用和归属"功能，模型生成的回答将包含引用来源，帮助核实信息的准确性与时效性。 | 安全配置 - 应用模板已默认开启内容审核配置，用于使用智能体过程中对敏感内容进行过滤和审核，保证智能体的使用安全。**内容审核配置和安全护栏无法同时开启。** 关于安全配置的更多介绍请参考[配置安全信息](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0027.html#section4)。 图7安全配置 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421483.png "点击放大") | 配置项 | 说明 | |:---|:---| | 内容审核配置 | 通过配置敏感词的过滤、替换和兜底回复匹配处理输入输出内容，保护用户免受不良信息的影响。 | | 安全护栏 | 开启安全护栏能够识别并阻止旨在操纵或滥用系统的Prompt攻击，同时也能过滤包含敏感信息的输入和输出，保护用户和系统免受不良影响。 | #### 分享单智能体 1. 完成智能体调试后，单击"单智能体配置"界面右上角的"提交版本"按钮。 2. 系统将默认以单击提交版本的时间填写版本名称，按需修改版本名称和版本描述后，单击"确定"。 3. 弹窗提示"版本提交成功"，单击"分享"进入"渠道管理"界面。 - 调用方式 已提交版本的智能体应用支持以API的形式分享调用，单击"查看API"弹出API详情页，提供详细的API描述文档与示例代码供您参考。更多操作请参考[通过API调用单智能体应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0038.html)。 图8API调用 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421541.png "点击放大") - 分享渠道 支持将应用分享至多个渠道，分享范围仅限"当前租户可用"，非同一账户下的用户无法打开该链接。详情请参考[发布应用为网页应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0032.html)和[发布应用至云商店](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0034.html)。 **更多操作：** 单击"渠道管理"界面右上角的版本历史图标"![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421439.png)"，可查看当前单智能体发布历史记录。 #### 相关文档 - 除通过模板搭建智能体外，AgentArts还支持手动搭建智能体，相关开始使用介绍请参见[搭建第一个智能体](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0002.html)。 - 除单智能体外，AgentArts平台还支持更高阶的工作流（Workflow）编排，可参考[搭建知识库问答工作流](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0003.html)通过一个示例深度体验其精细的逻辑控制能力。 - 更多AgentArts的进阶使用实践请参见[AgentArts最佳实践](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0001.html)。