文档首页/ 华为云码道CodeArts代码智能体/ 最佳实践/ 基于鸿蒙内置智能体从零开发HarmonyOS元服务
更新时间:2026-09-10 GMT+08:00
分享

基于鸿蒙内置智能体从零开发HarmonyOS元服务

从零开发一款全新的HarmonyOS元服务,往往会面临开发周期长、人力投入成本高等问题,同时还需要应对来自技术、生态及工程落地层面的各类挑战。本实践以开发HarmonyOS番茄钟元服务为例,借助华为云码道代码智能体,完成鸿蒙项目初始化、代码生成与功能验证,提升开发者的开发效率与代码质量。

环境要求

使用鸿蒙内置智能体开发元服务前,环境需要满足以下要求:

表1 鸿蒙内置智能体的环境要求

限制类别

具体说明

操作系统

  • Windows:Windows 10 (x64,2019 及以上版本) / Windows 11 (x64)。
  • macOS:macOS 12及以上版本,兼容ARM64(Apple Silicon)架构。

华为云码道代码智能体客户端

已安装26.9.1及以上版本,下载和安装步骤请参考快速启动

DevEco Studio

已安装6.0.0及以上版本,下载和安装步骤请参考下载与安装DevEco Studio

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. 参考快速启动中操作,打开一个空文件夹作为项目目录,并登录码道IDE。
  2. 在聊天界面的输入框下方选择“自定义 > 鸿蒙开发”,切换到鸿蒙开发智能体模式。右侧显示当前选用的模型,您可在下拉框中切换不同大语言模型。
  3. 在对话框输入以下内容,单击发送图标

    使用ArkTS+ArkUI开发一个HarmonyOS番茄钟元服务,并在DevEco Studio模拟器上运行它。
    
    功能需求:
    1、核心功能:默认番茄时间25分钟,短休息5分钟,可切换。
    2、UI展示:大字体倒计时数字。三个按钮:开始、暂停、重置。
    3、计时逻辑:点击开始按钮开始倒计时,点击暂停按钮暂停计时;点击重置按钮回到初始时间。
    4、界面风格:简洁,卡片尺寸适配元服务桌面卡片,不要复杂动画,保证代码简单易懂。
    5、输出要求:提供带中文注释的完整代码和元服务配置文件module.json5需要修改的部分。

  4. HarmonyOS番茄钟元服务创建期间,请根据鸿蒙内置智能体给出的信息进行相应交互。HarmonyOS番茄钟元服务创建完成后,返回如下信息,至此,一个从0到1的HarmonyOS元服务已成功开发完成。

    当前展示的效果图仅是示例,请以最终实际生成的效果为准。

    图1 HarmonyOS番茄钟元服务创建完成

    HarmonyOS番茄钟元服务开发完成后,模拟器运行环节可能出现启动失败,此问题不影响已开发完成的元服务本身。您可依据报错信息查阅模拟器错误码文档进行定位修复,再重新运行元服务。

  5. 您还可以为该HarmonyOS番茄钟元服务增加功能,实现更丰富的交互与场景。

    在对话框输入以下内容,单击发送图标 ,使用鸿蒙内置智能体在HarmonyOS番茄钟元服务新增一个功能。
    请帮我增加一个输入框,可以手动输入分钟数来设置番茄时长

  6. 功能增加期间,请根据鸿蒙内置智能体给出的信息进行相应交互。功能增加完成后,返回如下信息。

    当前展示的效果图仅是示例,请以最终实际生成的效果为准。

    图2 功能添加成功

相关文档