手动搭建烹饪助手单智能体

案例概述

本章节将引导您手动搭建一个“家庭烹饪助手”。通过全旅程的实操讲解，带您探索如何在AgentArts上开发单智能体并了解其开发逻辑，直观感受AgentArts的敏捷构建能力。

在日常生活中，面对厨房中零散的食材以及“今日吃什么”的频繁困扰，该“家庭烹饪助手”能够通过对进餐时段与食材组合的智能分析，快速生成简单、营养且可操作的家庭菜谱。通过本次实践，您不仅能打造出一款贴合生活需求的实用工具，更将掌握一套可复用、可扩展的单智能体构建方法论。

图1 效果展示

操作旅程总览

手动搭建一个家庭烹饪助手，仅需四步即可快速搭建您的专属智能体应用。

图2 使用模板快速搭建智能体应用流程

准备工作

在使用AgentArts智能体平台前，需要参考如下内容，提前申请华为账号并完成实名认证。

1. 进入华为云官网，单击页面右上角的“注册”。
2. 参考注册华为账号并开通华为云中操作，完成注册。
3. 注册成功后，进行实名认证。
   • 个人账号：个人实名认证
   • 企业账号：企业实名认证

   如果您使用的是IAM用户，也可使用该账户开通AgentArts服务。

4. 登录AgentArts智能体平台，开通服务。

步骤一：创建单智能体

1. 登录AgentArts智能体平台，默认选择“个人空间”。
2. 在总览页单击“快速创建智能体”卡片中的“立即创建”。
   图3 快速创建智能体
   

3. 填写智能体的“名称”与“描述”，赋予智能体基本的身份标识，填写完成后单击“确定”跳转至“单智能体配置”界面。
   图4 快速创建智能体
   

   表1 快速创建智能体

   参数	配置示例
   名称	家庭烹饪助手
   描述	专为家庭打造的智慧烹饪助手。能根据当前进餐时段与现有食材，快速生成简单、营养的家庭菜谱。

步骤二：配置单智能体

通过为单智能体调整提示词、配置模型、技能、对话体验等，扩展单智能体的能力边界，配置过程中可在预览调试界面不断调整智能体的效果。

1. 进入“单智能体配置”界面后，系统将根据您已填写的“名称”和“描述”，自动为该单智能体生成头像和提示词。

   提示词（Prompt）是驱动智能体执行任务的“指令说明书”。通过设定人设、任务边界及输出格式，结构化的提示词能确保智能体生成符合预期且具备特定风格的高质量内容。

   图5 单智能体信息与提示词
   

   更多操作说明

   • 如需调整头像和提示词，可参考表2。

     表2 更多操作说明

     配置项	更多操作说明
     头像	如需更换头像，可单击头像手动上传本地图片，也可单击按钮使用AI生成。
     提示词	为提升配置效率，平台提供以下功能支持： 智能优化提示词：只能优化现有提示词，快速一键替换。 引用模板：选择多种场景的官方预置或保存在组件库中的提示词，快速引用替换。 角色指令模板：单击将结构化编写框架直接嵌入提示词编辑框中，快速构建逻辑严密的自定义指令。 保存到模板：将当前提示词编辑框中的提示词保存在组件库中形成模板，实现多场景下的快速复用与沉淀。

2. 配置模型。模型是智能体的“大脑”，用于为智能体提供推理能力。

   单击“模型”参数的下拉框，本例选择使用“DeepSeek-V3”模型，您也可以根据需求配置其他大模型体验，单击图标可按需进行模型参数调整。

3. 配置“时间感知”技能。技能是智能体的“能力工具箱”，本案例需添加时间MCP服务用于补齐模型无法感知实时时间的短板，确保“家庭烹饪助手”按进餐时段精准匹配菜谱。
   1. 单击“MCP服务”右侧的“”图标，右侧弹出“添加MCP服务”窗口。
   2. 单击“创建MCP > 平台模板创建”，快速选用官方预置的MCP服务。
   3. 在“选择服务”步骤，搜索“时间感知”关键词，找到并单击“时间MCP服务器”，单击“下一步”。
      图6 选择时间MCP服务器
      
   4. 进入“服务配置”步骤，先单击“选择安装方式”下注意样式中的“单击此处”按键获取FunctionGraph服务的授权，根据弹窗提示完成授权，单击“安装”，等待MCP服务完成安装。
      图7 MCP时间服务配置
      
   5. 提示成功安装后，勾选已安装的“时间MCP服务器”，单击“确定”。
      图8 成功添加时间MCP服务器
      
   6. 修改提示词，在“任务描述”中输入以下内容，确保智能体知道何时调用时间感知能力。

      根据用户提供的食材组合，并且调用时间MCP服务器，获取当前的提问时间，生成符合家庭烹饪条件的菜谱。

      更多配置说明

      • 如果希望智能体拥有更强大的功能，可以参考表3完成其他配置项，以生成更符合您需求的专属智能体。

        表3 智能体配置更多说明

        配置项		说明
        技能	插件	插件是一种工具集，一个插件即是一个API工具，用于为智能体配备更多特定技能，添加插件后须在“提示词”中明确写出在什么情况下使用哪个技能。 应用示例：集成营养分析插件，在生成菜谱的同时，精准计算出整道菜的卡路里、营养素等信息。
        	工作流	工作流是智能体执行任务的逻辑编排体系，定义任务的先后顺序、分支判断及自动化处理流程，使智能体执行固定的业务流程。添加工作流前，须确保已完成编排工作流操作。 应用示例：添加早餐推荐工作流，使智能体应用固定执行“问候 -> 收集早餐偏好 -> 推荐早餐菜谱”的工作流。
        知识库		知识库是智能体的“外挂书架”，添加知识库后须在“提示词”中明确写出优先基于知识库进行回答，使智能体能够在处理任务时精准检索并引用知识库中的内容回答问题。详情请参考知识库介绍。 应用示例：添加川菜知识库，提供地道川菜推荐和辣度控制建议。
        记忆	变量	记忆中的变量相当于智能体的“记事本”，添加变量后须在“提示词”中以{{变量名}}格式引用，配置变量后智能体会自动识别并存储与变量匹配的内容，能让智能体回答更加个性化。 应用示例：添加过敏变量，记录对话中提及的过敏食材，当生成菜谱时必须避开这些食材。

4. 提升对话体验。为智能体配置“开场白”和“推荐问题”，能够帮助用户迅速了解该智能体的功能和用途，明确如何与智能体应用进行有效交互。

   单击“开场白”和“推荐问题”右侧的“”图标，智能生成符合该单智能体的开场白和推荐问题，可在右侧“预览调试”窗口中查看效果。

   图9 提升对话体验
   
   • 追问：智能体回答完用户问题后，将根据配置的追问规则和上下文自动生成的3个追问问题，能有效引导用户进行多轮对话。
   • 音色：智能体在语音交互或朗读文本时使用的声音，可以根据智能体的使用场景从音色库中选择符合该智能体人设的声音。

5. 平台已默认开启“内容审核配置”，可单击“”图标自定义配置敏感词的过滤、替换和兜底回复，保护智能体使用过中用户免受不良信息的影响。

   “安全护栏”配置能够识别并阻止旨在操纵或滥用系统的Prompt攻击，同时也能过滤包含敏感信息的输入和输出，但内容审核配置和安全护栏无法同时开启，选择其一开启即可。

步骤三：调试单智能体

在“预览调试”模块与智能体实时对话，可直观观察其执行过程并验证响应效果是否符合预期。根据反馈不断优化配置，确保“家庭烹饪助手”符合使用预期。

1. 在“单智能体配置”界面右侧的“预览调试”模块，直接输入问题进行问答调试。支持上传文件和使用语音进行提问。
2. 调试过程中，可参考表4的调试功能说明。

   表4 预览调试功能

   预览调试功能	说明
   删除	删除当前界面上的所有对话内容，回归至开场白界面，不会清除上下文记忆。
   变量	查看调试过程中已配置的变量信息，支持对变量进行重置。
   调试	选择对话，查看其运行结果和调用详情。
   展开	展开预览调试板块，专注智能体调试对话过程。

3. 在对话框中输入以下问题，查看智能体回答效果。

   厨房里有2个鸡蛋、1个番茄和1块牛肉，请根据当前时间生成适合的菜谱。

4. 智能体已能通过时间MCP服务器实时获取实时时间并输出晚餐建议，功能验证结果与预设效果契合。
   图10 查看智能体效果
   

相关文档

• 除手动搭建单智能体外，AgentArts还支持使用资产中心模板快速搭建智能体，相关开始使用介绍请参见使用资产中心模板搭建单智能体。
• 除单智能体外，AgentArts平台还支持更高阶的工作流（Workflow）编排，可参考手动搭建知识库问答工作流通过一个示例深度体验其精细的逻辑控制能力。