# 基于鸿蒙内置智能体从零开发HarmonyOS元服务
从零开发一款全新的HarmonyOS元服务，往往会面临开发周期长、人力投入成本高等问题，同时还需要应对来自技术、生态及工程落地层面的各类挑战。本实践以开发HarmonyOS番茄钟元服务为例，借助华为云码道代码智能体，完成鸿蒙项目初始化、代码生成与功能验证，提升开发者的开发效率与代码质量。
#### 环境要求
使用鸿蒙内置智能体开发元服务前，环境需要满足以下要求：
表1鸿蒙内置智能体的环境要求 
| 限制类别           | 具体说明                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|
| 操作系统          | - Windows：Windows 10 (x64，2019 及以上版本) / Windows 11 (x64)。  - macOS：macOS 12及以上版本，兼容ARM64（Apple Silicon）架构。   |
| 华为云码道代码智能体客户端   | 已安装26.9.1及以上版本，下载和安装步骤请参考[快速启动](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0002.html)。                                                                                                                                                                                                                                                     |
| DevEco Studio | 已安装6.0.0及以上版本，下载和安装步骤请参考[下载与安装DevEco Studio](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-software-install)。                                                                                                                                                                                                                                       |
| Python       | 已安装Python 3.x版本。                                                                                                                                                                                                                                                                                                                                                        |
| Node.js       | 已安装Node.js 21或以上版本。                                                                                                                                                                                                                                                                                                                                                      |
| Git           | 已安装Git，任意版本都可以。                                                                                                                                                                                                                                                                                                                                                            |
   
#### 准备工作
使用鸿蒙内置智能体开发番茄钟元服务后，需要在DevEco Studio的模拟器上进行运行和调试，因此请先登录DevEco Studio，并配置相关环境变量。
1. 使用**已实名认证的账号**登录DevEco Studio。
2. 在本地PC上新增一个用户变量或系统变量，以提升智能体使用HarmonyOS工具链的效率和稳定性。 
   变量名为**DEVECO_HOME**，变量值为DevEco Studio的安装目录，例如：D:\\DevEco Studio。
   
   
 
#### 使用鸿蒙内置智能体开发HarmonyOS番茄钟元服务
1. 参考[快速启动](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0002.html)中操作，打开一个空文件夹作为项目目录，并登录码道IDE。
2. 在聊天界面的输入框下方选择"自定义 \> 鸿蒙开发"，切换到鸿蒙开发智能体模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。
3. 在对话框输入以下内容，单击发送图标 ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002752565631.png)。
   
   ```
   使用ArkTS+ArkUI开发一个HarmonyOS番茄钟元服务，并在DevEco Studio模拟器上运行它。
   功能需求：
   1、核心功能：默认番茄时间25分钟，短休息5分钟，可切换。
   2、UI展示：大字体倒计时数字。三个按钮：开始、暂停、重置。
   3、计时逻辑：点击开始按钮开始倒计时，点击暂停按钮暂停计时；点击重置按钮回到初始时间。
   4、界面风格：简洁，卡片尺寸适配元服务桌面卡片，不要复杂动画，保证代码简单易懂。
   5、输出要求：提供带中文注释的完整代码和元服务配置文件module.json5需要修改的部分。
   ```
   
   
4. HarmonyOS番茄钟元服务创建期间，请根据鸿蒙内置智能体给出的信息进行相应交互。HarmonyOS番茄钟元服务创建完成后，返回如下信息，至此，一个从0到1的HarmonyOS元服务已成功开发完成。 
   当前展示的效果图仅是示例，请以最终实际生成的效果为准。
   图1HarmonyOS番茄钟元服务创建完成   
   ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002723121842.png "点击放大")
   HarmonyOS番茄钟元服务开发完成后，模拟器运行环节可能出现启动失败，此问题不影响已开发完成的元服务本身。您可依据报错信息查阅[模拟器错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-faqs)文档进行定位修复，再重新运行元服务。
   
   
5. 您还可以为该HarmonyOS番茄钟元服务增加功能，实现更丰富的交互与场景。 
   在对话框输入以下内容，单击发送图标 ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002752485737.png)，使用鸿蒙内置智能体在HarmonyOS番茄钟元服务新增一个功能。
   ```
   请帮我增加一个输入框，可以手动输入分钟数来设置番茄时长
   ```
   
   
6. 功能增加期间，请根据鸿蒙内置智能体给出的信息进行相应交互。功能增加完成后，返回如下信息。 
   当前展示的效果图仅是示例，请以最终实际生成的效果为准。
   图2功能添加成功   
   ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002723462944.png "点击放大")