# 搭建第一个智能体 #### 案例概述 本章节将引导您手动搭建一个"百科资讯助手"。通过全流程的实操讲解，带您探索如何在AgentArts上从零开发单智能体并了解其开发逻辑，直观感受AgentArts的敏捷构建能力。 在信息获取日益碎片化的今天，用户常有快速查询实时资讯与专业百科知识的复合需求。该"百科资讯助手"通过集成Daily News（全球动态）与《本草纲目》百科等多项技能，能够实现从全球热点追踪到传统中医典籍检索的跨维度信息整合。通过本次实践，您不仅能打造出一款连接实时动态与经典智慧的实用工具，更将掌握一套通过多技能组合扩展单智能体服务边界的构建方法论。 图1效果展示 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341555.png "点击放大") #### 操作流程 手动搭建一个百科资讯助手，仅需四步即可快速搭建您的专属智能体应用。 图2使用模板快速搭建智能体应用流程 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421551.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/versatile/#/home/overview)，参考[开通AgentArts](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0000.html)开通服务。 #### 步骤一：创建单智能体 1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)。 2. 在总览页单击"快速创建智能体"卡片中的"立即创建"。 图3快速创建智能体 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341515.png "点击放大") 3. 填写智能体的"名称"与"描述"，赋予智能体基本的身份标识，填写完成后单击"确定"跳转至"单智能体配置"界面。 图4快速创建智能体 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538541718.png "点击放大") 表1快速创建智能体 | 参数 | 配置示例 | |:---|:---| | 名称 | 百科资讯助手 | | 描述 | 一款集合了实时动态与百科检索的综合助手。 | #### 步骤二：配置单智能体 通过为单智能体调整提示词、配置模型、技能、对话体验等，扩展单智能体的能力边界，配置过程中可在预览调试界面不断调整智能体的效果。 1. 进入"单智能体配置"界面后，系统将根据您已填写的"名称"和"描述"，自动为该单智能体生成头像和提示词。 提示词（Prompt）是驱动智能体执行任务的"指令说明书"。通过设定人设、任务边界及输出格式，结构化的提示词能确保智能体生成符合预期且具备特定风格的高质量内容。 图5单智能体信息与提示词 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421471.png "点击放大") 更多操作说明 - 如需调整头像和提示词，可参考[表2]。 表2更多操作说明 | 配置项 | 更多操作说明 | |:---|:---| | 头像 | 如需更换头像，可单击头像手动上传本地图片，也可单击![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538541836.png)按钮使用AI生成。 | | 提示词 | 为提升配置效率，平台提供以下功能支持： - ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341529.png)智能优化提示词：只能优化现有提示词，快速一键替换。 - ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341493.png)引用模板：选择多种场景的官方预置或保存在组件库中的提示词，快速引用替换。 - ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538541852.png)角色指令模板：单击将结构化编写框架直接嵌入提示词编辑框中，快速构建逻辑严密的自定义指令。 - ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341535.png)保存到模板：将当前提示词编辑框中的提示词保存在组件库中形成模板，实现多场景下的快速复用与沉淀。 | 2. 配置模型。模型是智能体的"大脑"，用于为智能体提供推理能力。 单击"模型"参数的下拉框，本例选择使用"DeepSeek-V3"模型，您也可以根据需求配置其他大模型体验，单击"![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341547.png)"图标可按需进行模型参数调整。更多说明请参考[选择并配置模型](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0017.html)。 3. 配置"资讯与百科"技能。技能是智能体的"能力工具箱"，本案例需添加"Daily News"MCP服务与"本草纲目"插件，为智能体引入实时资讯获取与专业百科检索能力。 添加"Daily News"MCP服务 1. 单击"技能 \> MCP服务"配置右侧的"![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341501.png)"图标，右侧弹出"添加MCP服务"窗口。 2. 单击"创建MCP \> 平台模板创建"，快速选用官方预置的MCP服务。 3. 在"选择服务"步骤，搜索关键词，找到并单击"Daily News"MCP服务，单击"下一步"。 图6选择时间MCP服务器 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421605.png "点击放大") 4. 进入"服务配置"步骤，可查看该MCP服务的详细信息，单击"安装"，等待MCP服务完成安装。 如果未配置FunctionGraph服务的授权，请先单击"选择安装方式"下提示框中的"单击此处"完成授权。授权成功后，该提示消息将不再显示。 5. 待提示"创建MCP成功"，且MCP服务卡片状态显示为"已部署"时，即可勾选该MCP服务并单击"确定"。 图7添加MCP服务 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341477.png "点击放大") 6. 完成"Daily News"MCP服务的添加。 图8成功添加时间MCP服务器 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538541846.png "点击放大") 7. 添加后，可在右侧"预览调试"窗口尝试对话，例如提问智能体"请提供最新的实时热点咨询"，查看智能体回答时是否调用了该MCP服务。 图9调用MCP工具 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538381880.png "点击放大") 添加"本草纲目"插件 1. 单击"技能 \> 插件"配置右侧的"![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341523.png)"图标，右侧弹出"添加插件工具"窗口。 2. 切换至"插件广场"页签，快速选用官方预置的插件工具。 3. 在列表中找到"本草纲目"插件，单击卡片展开插件详情，并单击"添加"。 图10添加插件工具 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421627.png "点击放大") 4. 确认无误后，单击右下角的"确定"，即可完成插件的添加。 图11成功添加本草纲目插件 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421467.png "点击放大") 5. 添加后，可在右侧"预览调试"窗口尝试对话，例如提问智能体"人身的作用是什么"，查看智能体回答时是否调用了该MCP服务。 图12调用MCP工具 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341559.png "点击放大") 更多配置说明 - 如果希望智能体拥有更强大的功能，可参考[表3]按需添加其他配置项，以生成更符合您需求的专属智能体。 **注意：**部分MCP服务或插件涉及"鉴权"配置。由于其调用的是第三方平台服务，需要先前往对应的官方平台注册并获取专用的API Key（密钥）或Token，并将其回填至平台配置中，以获得该服务的使用许可。 表3智能体配置更多说明 | 配置项 || 说明 | |:---|---|:---| | 技能 | 工作流 | 工作流是智能体执行任务的逻辑编排体系，定义任务的先后顺序、分支判断及自动化处理流程，使智能体执行固定的业务流程。添加前须确保已提前完成工作流的编排与发布，详情请参考[为应用添加工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0023.html)。 **应用示例：添加"每日简报"工作流，使智能体按固定逻辑执行：获取当前天气 -\> 检索今日头条新闻 -\> 结合本草纲目提供节气养生建议。** | | 知识库 || 知识库是智能体的"外挂书架"，使智能体能够在处理任务时检索并引用知识库中的内容回答问题。添加知识库前需确保已提前完成创建与配置，并建议在"提示词"中明确写出优先基于知识库进行回答，详情请参考[知识库介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0148.html)。 **应用示例：** **添加"世界历史百科"知识库，使智能体在回答新闻背景时，能引用历史资料进行深度解读。** | | 记忆 | 用户变量 | 用户变量相当于智能体的"记事本"，添加变量后可在"提示词"中以{{memory.用户变量名}}格式引用，配置变量后智能体会自动识别并动态存储与变量匹配的内容，能让智能体回答更加个性化。关于用户变量的更多介绍请参考[为应用添加记忆](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0026.html)。 **应用示例：添加"关注领域"变量，记录用户感兴趣的新闻类别（如：科技、财经），使智能体在后续推送中更加个性化。** | | 记忆 | 入参变量 | 入参变量用于在API调用时向智能体传入外部信息，通常用于固定组件参数或注入确定性的业务上下文。添加的变量可在工作流、插件、MCP 服务的入参配置处引用，也可在"提示词"中以{{input.入参变量名}}格式引用。关于用户变量的更多介绍请参考[为应用添加记忆](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0026.html)。 **应用示例：添加"关注领域"变量，将值固定为"科技"，智能体在回复时将始终围绕科技领域的内容进行回答。** | 4. 完成MCP服务和插件的添加后，建议修改提示词，在"任务描述"中新增以下内容，确保智能体明确各项技能的调用时机： ``` 根据用户的咨询需求，调用“Daily News”MCP服务获取最新的全球动态，或检索“本草纲目”插件获取专业的中医百科知识，为用户提供实时资讯与百科查询结果。 ``` 5. 提升对话体验。为智能体配置"开场白"和"推荐问题"，能够帮助用户迅速了解该智能体的功能和用途，明确如何与智能体应用进行有效交互。 单击"开场白"和"推荐问题"右侧的"![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538541874.png)"图标，智能生成符合该单智能体的开场白和推荐问题，可在右侧"预览调试"窗口中查看效果。 图13提升对话体验 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421611.png "点击放大") - 追问：智能体回答完用户问题后，将根据配置的追问规则和上下文自动生成的3个追问问题，能有效引导用户进行多轮对话。 - 音色：智能体在语音交互或朗读文本时使用的声音，可以根据智能体的使用场景从音色库中选择符合该智能体人设的声音。 - 显示引用和归属：在单智能体配置并使用了联网搜索或知识库等工具时，开启该功能，模型生成的回答将包含引用来源，帮助核实信息的准确性与时效性。 6. 平台已默认开启"内容审核配置"，可单击"![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341505.png)"图标自定义配置敏感词的过滤、替换和兜底回复，保护智能体使用过中用户免受不良信息的影响。 "安全护栏"配置能够识别并阻止旨在操纵或滥用系统的Prompt攻击，同时也能过滤包含敏感信息的输入和输出，但**内容审核配置和安全护栏无法同时开启** ，选择其一开启即可**。** #### 步骤三：调试单智能体 在"预览调试"模块与智能体实时对话，可直观观察其执行过程并验证响应效果是否符合预期。根据反馈不断优化配置，确保"百科咨询助手"符合使用预期。 1. 在"单智能体配置"界面右侧的"预览调试"模块，直接输入问题进行问答调试。支持上传文件和使用语音进行提问。 2. 调试过程中，可参考[表4]的调试功能说明。 表4预览调试功能 | 预览调试功能 | 说明 | |:---|:---| | ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538381804.png)删除 | 删除当前界面上的所有对话内容，回归至开场白界面，不会清除上下文记忆。 | | ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538541800.png)记忆 | 查看调试过程中已配置的变量信息，支持对变量进行重置。 | | ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002538381932.png "点击放大")调试 | 选择对话，查看其运行结果和调用详情。 | | ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341595.png "点击放大")展开 | 展开预览调试板块，专注智能体调试对话过程。 | 3. 在对话框中输入以下问题，查看智能体回答效果。 ``` 请提供最新的科技热点资讯，并根据当前的节气，从《本草纲目》中推荐一项养生建议。 ``` 4. 智能体已能通过"Daily News"MCP服务获取并汇总当天的全球科技动态，同时成功调用"本草纲目"插件检索出匹配节气的养生方剂。 功能验证结果显示智能体能够调度多项技能，回答内容与预设的资讯及百科能力契合。 图14查看智能体效果 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569341541.png "点击放大") #### 分享单智能体 1. 完成智能体调试后，单击"单智能体配置"界面右上角的"提交版本"按钮。 2. 系统将默认以单击提交版本的时间填写版本名称，按需修改版本名称和版本描述后，单击"确定"。 3. 弹窗提示"版本提交成功"，单击"分享"进入"渠道管理"界面。 - 调用方式 已提交版本的智能体应用支持以API的形式分享调用，单击"查看API"弹出API详情页，提供详细的API描述文档与示例代码供您参考。更多操作请参考[通过API调用单智能体应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0038.html)。 图15API调用 ![](https://support.huaweicloud.com/qs-agentarts0/zh-cn_image_0000002569421559.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_0000002538381884.png)"，可查看当前单智能体发布历史记录。 #### 相关文档 - 除手动搭建单智能体外，AgentArts还支持使用资产中心模板快速搭建智能体，相关开始使用介绍请参见[使用模板搭建智能体](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0001.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)。