# 搭建第一个智能体 #### 案例概述 本章节将引导您手动搭建一个"百科资讯助手"。通过全流程的实操讲解，带您探索如何在AgentArts上从零开发单智能体并了解其开发逻辑，直观感受AgentArts的敏捷构建能力。 在信息获取日益碎片化的今天，用户常有快速查询实时资讯与专业百科知识的复合需求。该"百科资讯助手"通过集成Daily News（全球动态）与《本草纲目》百科等多项技能，能够实现从全球热点追踪到传统中医典籍检索的跨维度信息整合。通过本次实践，您不仅能打造出一款连接实时动态与经典智慧的实用工具，更将掌握一套通过多技能组合扩展单智能体服务边界的构建方法论。 图1效果展示 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002609418273.png "点击放大") #### 操作视频 #### 操作流程 手动搭建一个百科资讯助手，仅需三步即可快速搭建您的专属智能体应用。 图2手动搭建智能体应用流程 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002553687771.png) | 操作步骤 | 说明 | |:---|:---| | [准备工作] | 注册华为账号并开通华为云、完成实名认证，开通AgentArts服务。 | | [步骤一：创建单智能体] | 跟随总览页指引，创建并填写单智能体的名称和描述，赋予百科资讯助手清晰的角色身份与功能定位。 | | [步骤二：配置单智能体] | 通过调整提示词、配置模型、添加MCP服务与插件，为智能体注入逻辑推理、实时资讯获取及专业百科检索等核心能力。 | | [步骤三：调试单智能体] | 在预览调试窗口进行实时对话验证，确保百科资讯助手能够准确调用各项技能并生成符合预期的答复。 | #### 准备工作 在使用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/agentarts/#/home/overview)，参考[开通AgentArts](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)开通服务。 #### 步骤一：创建单智能体 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在总览页单击快速创建智能体卡片中的"手动创建"。 图3快速创建智能体 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002557164211.png "点击放大") 3. 填写智能体的"名称"与"描述"，赋予智能体基本的身份标识，填写完成后单击"确定"跳转至单智能体配置界面。 图4快速创建智能体 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522858390.png "点击放大") 表1快速创建智能体 | 参数 | 配置示例 | |:---|:---| | 名称 | 百科资讯助手 | | 描述 | 一款集合了实时动态与百科检索的综合助手。 | #### 步骤二：配置单智能体 通过为单智能体设置提示词、配置模型、技能、对话体验等，扩展单智能体的能力边界，配置过程中可在预览调试界面不断调整智能体的效果。 1. 进入单智能体配置界面，为智能体设置头像、提示词。 提示词（Prompt）是驱动智能体执行任务的"指令说明书"。通过设定人设、任务边界及输出格式，结构化的提示词能确保智能体生成符合预期且具备特定风格的高质量内容。 图5单智能体信息与提示词 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002581440889.png) 更多操作说明 - 如需调整头像和提示词，可参考[表2]。 表2更多操作说明 | 配置项 | 更多操作说明 | |:---|:---| | 头像 | 如需更换头像，可单击头像手动上传本地图片，也可单击![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522607844.png)按钮使用AI生成。 | | 提示词 | 为提升配置效率，平台提供以下功能支持： - ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522447834.png)智能优化提示词：智能优化现有提示词，快速一键替换。 - ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002553567755.png)引用模板：选择多种场景的官方预置或保存在组件库中的提示词，快速引用替换。 - ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002553687775.png)角色指令模板：单击将结构化编写框架直接嵌入提示词编辑框中，快速构建逻辑严密的自定义指令。 - ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522607846.png)保存到模板：将当前提示词编辑框中的提示词保存在组件库中形成模板，实现多场景下的快速复用与沉淀。 | 2. 配置模型。模型是智能体的"大脑"，用于为智能体提供推理能力。 单击"模型"参数的下拉框，本例选择使用DeepSeek-V4-Flash模型，您也可以根据需求配置其他大模型体验，单击![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522447836.png)图标可按需进行模型参数调整。更多说明请参考[选择并配置模型](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0017.html)。 3. 配置"资讯与百科"技能。技能是智能体的"能力工具箱"，本案例需添加Daily NewsMCP服务与本草纲目插件，为智能体引入实时资讯获取与专业百科检索能力。 如果希望智能体拥有更强大的功能，可参考[为应用添加工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0023.html)、[为应用添加知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0025.html)、[为应用添加记忆](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0026.html)按需添加其他配置项，以生成更符合您需求的专属智能体。 添加"Daily News"MCP服务 1. 创建"Daily News"MCP服务。 1. 登录[魔塔社区](https://modelscope.cn/home)，并完成注册。 2. 登录成功后，选择MCP广场页签，并搜索Daily News。 图6搜索Daily News ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002551001346.png "点击放大") 3. 单击Daily News卡片查看详情，并获取服务配置信息，失效后支持重置服务。 图7服务配置 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002550843482.png "点击放大") 图8重置服务 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002583283281.png "点击放大") 4. 获取免费资源部署信息。 图9获取部署信息 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002550844546.png "点击放大") 5. 返回AgentArts平台，单击"技能 \> MCP服务"右侧的"![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002583365171.png "点击放大")"图标，右侧弹出"添加MCP服务"窗口。 6. 单击"创建MCP \> 空白创建"，在空白创建页面，定义服务名称为"Daily News"，服务描述为"基于 MCP 协议的新闻获取服务器，支持热点新闻获取和新闻搜索功能。"。 7. 选择安装方式为"Http"，MCP服务配置为"JSON编辑"，并在json输入框中输入[3.a.iv]的配置信息，鉴权方式选择"无需鉴权"，并单击"安装"。 图10输入配置信息 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002628388394.png "点击放大") 2. 待提示"创建MCP成功"，且MCP服务卡片状态显示为"部署成功"时，即可勾选该MCP服务并单击"确定"。 图11添加MCP服务 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002550844542.png) 3. 完成"Daily News"MCP服务的添加。 图12成功添加MCP服务 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002551004192.png) 4. 添加成功后，可在提示词模块修改人设与回复逻辑，指示智能体使用"Daily News"MCP服务来优先回答问题，如[图13]所示。 提示词新增人设描述如下： ``` 用户交互时，请优先使用“Daily News”进行查询。 ``` 图13修改回复逻辑1 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002583500685.png) 5. 添加成功后，在右侧"预览调试"窗口尝试对话，例如提问智能体"请提供最新的实时热点资讯"，查看智能体回答时是否调用了该MCP服务。 图14调用MCP工具 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522855494.png "点击放大") 添加"本草纲目"插件 1. 单击"技能 \> 插件"配置右侧的"![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002553769593.png)"图标，右侧弹出"添加插件工具"窗口。 2. 切换至"插件广场"页签，快速选用官方预置的插件工具。 3. 在列表中找到"本草纲目"插件，单击卡片展开插件详情，并单击"添加"。 图15添加插件工具 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002583490735.png "点击放大") 4. 确认无误后，单击右下角的"确定"，即可完成插件的添加。 图16成功添加本草纲目插件 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002553769559.png "点击放大") 5. 添加成功后，在右侧"预览调试"窗口尝试对话，例如提问智能体"人参的作用是什么"，查看智能体回答时是否调用了该插件。 图17调用插件工具 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522695472.png "点击放大") 4. 完成MCP服务和插件的添加后，建议修改提示词，在"任务描述"中新增以下内容，确保智能体明确各项技能的调用时机： ``` 根据用户的咨询需求，调用“Daily News”MCP服务获取最新的全球动态，或检索“本草纲目”插件获取专业的中医百科知识，为用户提供实时资讯与百科查询结果。 ``` 5. 提升对话体验。为智能体配置"开场白"和"推荐问题"，能够帮助用户迅速了解该智能体的功能和用途，明确如何与智能体应用有效交互。 单击"开场白"和"推荐问题"右侧的"![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002553567759.png)"图标，智能生成符合该单智能体的开场白和推荐问题，可在右侧"预览调试"窗口中查看效果。 图18提升对话体验 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002523774118.png "点击放大") - 追问：智能体回答完用户问题后，将根据配置的追问规则和上下文自动生成的3个追问问题，能有效引导用户进行多轮对话。 - 引用和归属：在单智能体配置并使用了联网搜索或知识库等工具时，开启该功能，模型生成的回答将包含引用来源，帮助核实信息的准确性与时效性。 6. 平台已默认开启"内容审核配置"，可单击![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522607850.png)图标自定义配置敏感词的过滤、替换和兜底回复，保护智能体使用过程中用户免受不良信息的影响。 #### 步骤三：调试单智能体 在"预览调试"模块与智能体实时对话，可直观观察其执行过程并验证响应效果是否符合预期。根据反馈不断优化配置，确保"百科资讯助手"符合使用预期。 1. 在"单智能体配置"界面右侧的"预览调试"模块，直接输入问题进行问答调试。支持上传文件和使用语音进行提问。 2. 调试过程中，可参考[表3]的调试功能说明。 表3预览调试功能 | 预览调试功能 | 说明 | |:---|:---| | ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522447840.png)删除 | 删除当前界面上的所有对话内容，回归至开场白界面，不会清除上下文记忆。 | | ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002553687781.png "点击放大")调试 | 选择对话，查看其运行结果和调用详情。 | | ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522607852.png "点击放大")展开 | 展开预览调试板块，专注智能体调试对话过程。 | 3. 在对话框中输入以下问题，查看智能体回答效果。 ``` 请提供最新的科技热点资讯，并根据当前的节气，从《本草纲目》中推荐一项养生建议。 ``` 4. 智能体已能通过"Daily News"MCP服务获取并汇总当天的全球科技动态，同时成功调用"本草纲目"插件检索出匹配节气的养生方剂。 功能验证结果显示智能体能够调度多项技能，回答内容与预设的资讯及百科能力契合。 图19查看智能体效果 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002553776497.png "点击放大") #### 提交单智能体 1. 完成智能体调试后，单击"单智能体配置"界面右上角的"提交版本"按钮。 2. 系统将默认以单击提交版本时的时间填写版本名称，按需修改版本名称和版本描述后，单击"确定"。 随后，弹窗提示"部署成功"，则智能体搭建成功。 ![](https://support.huaweicloud.com/qs-agentarts/public_sys-resources/note_3.0-zh-cn.png) 智能体创建完成后，如果需要通过API调用，则需要将提交的版本部署至实例，具体操作请参考[发布并部署应用为API服务](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0031.html)。 图20提交版本 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002613584031.png "点击放大") #### 更多操作 - 在左侧导航栏中选择"开发中心 \> 智能体管理"**，**单击目标应用，选择"渠道管理"页签，可查看应用的调用方式，同时支持将应用分享至多个渠道。 - 在左侧导航栏中选择"开发中心 \> 智能体管理"**，** 单击目标应用，单击"渠道管理"界面右上角的版本历史图标"![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002658346840.png)"，可查看当前单智能体发布历史记录。 #### 相关文档 - 除手动搭建单智能体外，AgentArts还支持使用资产中心模板快速搭建智能体，相关开始使用介绍请参见[使用模板搭建智能体](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0001.html)。 - 除单智能体外，AgentArts平台还支持更高阶的工作流（Workflow）编排，可参考[搭建知识库问答工作流](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0003.html)通过一个示例深度体验其精细的逻辑控制能力。 - 更多AgentArts的进阶使用实践请参见[AgentArts最佳实践](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0001.html)。