内置智能体

智能体（Agent）是面向多样化开发场景的编程助手。华为云码道代码智能体内置了多款开箱即用的智能体，这些智能体无需手动创建，即拿即用，旨在为多种开发场景提供高效的编程辅助。

内置主智能体

内置主智能体包括系统内置和码道内置两类，二者均为华为云码道代码智能体内置的主智能体，不支持用户删除，具体区别如表2所示。

表1 内置主智能体列表
名称	创建者	说明
智能体	系统内置	华为云码道代码智能体的核心功能模块，支持理解开发者复杂需求并自主规划执行路径。适用于端到端开发任务场景（如需求分析→代码生成→测试验证），实现全流程自动化，显著提升研发效率。
AgentTeam	系统内置	多智能体协作引擎，采用“Leader智能编排 + Teammate自主执行”架构。将复杂任务拆解为可并行子任务，由多个专业AI-Agent像真实团队一样分工协作，全程事件驱动、可视化追踪，无需人工干预。 AgentTeam仅支持在码道Agent Space中使用，详细介绍请参见多任务并行。
智能问答	系统内置	基于大语言模型的交互式知识助手，支持自然语言提问与精准答案返回。
鸿蒙开发	码道内置	有状态的鸿蒙系统开发协调器，可从原始需求启动开发流程，或从中间产物恢复执行；在需要时执行确定性项目脚手架搭建，随后将规格定义、方案规划、代码编写、构建编译、评审及自测阶段任务委派给鸿蒙开发智能体执行。

表2 系统内置和码道内置的区别
操作端	系统内置	码道内置
控制台	仅支持编辑操作，可编辑智能体名称和描述信息。	支持编辑、启用和关闭操作。关闭后，客户端将不展示该智能体。
客户端	在“设置”页面的“智能体 > 系统内置”中展示，仅支持查看。智能体展示在聊天界面输入框下方的“内置”列表中。	在“设置”页面的“智能体 > 企业级”中展示，支持开启和关闭操作。关闭后，聊天界面输入框下方将不展示该智能体。智能体展示在聊天界面输入框下方的“自定义”列表中。

内置子智能体

在华为云码道代码智能体中，子智能体是主智能体的AI助手，用于处理特定类型的工作，并将结果返回给主代理。子智能体主要用于以下场景：

长链路复杂任务：适用于流程冗长、逻辑复杂的任务，由子智能体自主拆解任务、规划执行步骤并分布落地，例如全链路代码开发。
上下文隔离：通过子智能体隔离子任务上下文，避免主代理上下文冗余、Token膨胀及上下文溢出问题，例如批量数据解析。
垂直领域专业能力：各子智能体可配置专属角色提示词与私有知识库，形成领域专家能力，提升专业推理精度与任务准确率，例如安全审计专家子智能体。
权限隔离：为不同子智能体独立配置访问权限，实现敏感数据、私有知识库、高低危接口、文件资源及项目数据的权限隔离，保障数据与系统安全，例如数据删除、系统指令等高风险操作权限隔离。

表3 内置子智能体列表
名称	说明
general	通用智能体，用于研究复杂问题和执行多步骤任务。
explore	代码库探索智能体，专门用于快速查找文件、搜索代码关键词、回答代码库相关问题。
spec-task-agent	根据需求和设计生成实现任务。
spec-requirement-agent	基于项目描述和上下文生成EARS格式需求。
spec-design-agent	生成综合技术设计，将需求（做什么）转化为架构（如何做）。
developer-test-agent	专门用于单元测试生成、修复、覆盖率优化和审查的智能体。通过指令唤起的调用方式：在聊天界面的输入框中输入指令即可调用，示例：使用developer-test-agent为某个文件的某个方法生成单元测试。
bug-fix-agent	从用户报告的问题描述和相关产物中解析软件问题，专注于问题分析、故障定位和补丁实现。
hmos-build-fixer	自动构建HarmonyOS项目、诊断工具链阻塞、解析编译错误、修复源代码问题并重试直到构建成功。
hmos-logic-coder	执行HarmonyOS ArkTS应用契约，不重新打开设计选择。
rule-generator	规则生成器。

约束与限制

使用鸿蒙开发智能体前，环境需要满足以下要求：

表4 鸿蒙开发智能体的环境要求
限制类别	具体说明
操作系统	Windows：推荐使用Windows 11 (x64)；如果使用Windows 10 (x64)，系统版本需为2019年及以上，建议升级至最新稳定版本。 macOS：macOS 12及以上版本，兼容ARM64（Apple Silicon）架构。
华为云码道代码智能体版本	已安装26.7.0及以上版本。
DevEco Studio	已安装6.0.0及以上版本，下载和安装步骤请参考下载与安装DevEco Studio。请根据实际需求，安装DevEco Studio或Command Line Tools二者之一。
Command Line Tools	已安装6.0.0及以上版本，下载和安装步骤请参考获取Command Line Tools。请根据实际需求，安装DevEco Studio或Command Line Tools二者之一。
Python	已安装Python 3.x版本。
Git	已安装Git，任意版本都可以。

前提条件

DevEco Studio或Command Line Tools安装完成后，请使用已实名认证的账号登录。
如需使用模拟器测试应用，请确保本地已下载模拟器镜像或已创建模拟器，具体操作请参考创建模拟器。

DevEco Studio或Command Line Tools安装完成后，请配置相关环境变量，提升智能体使用鸿蒙工具链的效率和稳定性。

新增一个用户变量或系统变量：变量名为HARMONYOS_SDK_HOME，变量值为DevEco Studio或Command Line Tools的安装目录，例如：D:\Tools\DevEco Studio。

在系统变量Path中添加4个变量值。

表5 为系统变量Path添加变量值
工具名称	变量值
DevEco Studio	DevEco Studio安装目录\tools\ohpm\bin DevEco Studio安装目录\tools\hvigor\bin DevEco Studio安装目录\sdk\default\openharmony\toolchains DevEco Studio安装目录\tools\node
Command Line Tools	Command Line Tools安装目录\ohpm\bin Command Line Tools安装目录\hvigor\bin Command Line Tools安装目录\sdk\default\openharmony\toolchains Command Line Tools安装目录\tool\node

图1 为系统变量Path添加DevEco Studio变量值示例
点击放大

检查环境变量是否生效。
按Win+R组合键，打开运行窗口。输入“CMD”，单击“确定”，打开命令提示符窗口。分别输入以下3个命令，返回对应版本，说明环境变量已生效。
```
C:\Users\L***8>ohpm -v
6.1.1.830
C:\Users\L***8>hvigorw -v
6.23.7
C:\Users\L***8>hdc version
Ver: 3.2.0c
```

鸿蒙开发智能体使用示例

本示例介绍如何使用鸿蒙开发智能体，从零开始创建并运行鸿蒙应用项目示例。

参考快速启动操作，打开一个空文件夹作为项目目录，并登录华为云码道代码智能体IDE。
在聊天界面的输入框下方选择“自定义 > 鸿蒙开发”，切换到鸿蒙开发智能体模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。

如果没有正常显示华为云码道代码智能体的聊天窗口，请在顶部菜单栏的右上方，单击展开AI侧栏图标，即可打开华为云码道代码智能体。
在对话框输入以下内容，单击发送图标。
```
帮我创建一个鸿蒙应用Demo，并运行它
```
鸿蒙应用Demo创建期间，请根据鸿蒙开发智能体给出的信息进行相应交互。鸿蒙应用Demo创建完成后，返回如下信息，至此，一个从0到1的鸿蒙应用已成功开发完成。

图2 鸿蒙应用Demo创建完成

鸿蒙应用Demo开发完成后，模拟器运行环节可能出现启动失败，此问题不影响已开发完成的Demo本身。您可依据报错信息查阅模拟器错误码文档进行定位修复，再重新运行应用。
您还可以为该鸿蒙应用Demo增加功能，实现更丰富的交互与场景。
在对话框输入以下内容，单击发送图标，使用鸿蒙开发智能体在鸿蒙应用Demo中新增一个主题切换功能。
```
请帮我增加一个主题切换按钮，实现明暗主题的切换
```
功能增加期间，请根据鸿蒙开发智能体给出的信息进行相应交互。功能增加完成后，返回如下信息。

图3 主题切换功能增加成功