文档首页/ 华为云码道（CodeArts）代码智能体/ 用户指南（IDE）/ 智能体/ 自定义智能体

更新时间：2026-05-29 GMT+08:00

自定义智能体

智能体（Agent）是面向多样化开发场景的编程助手。华为云码道不仅内置了多种智能体，还支持自定义智能体功能。在自定义智能体中，通过灵活配置提示词（Prompt）、技能（Skill）及工具集，您可以打造专属助手，从而更高效地应对复杂开发任务。

约束与限制

表1 约束与限制
限制类别	具体说明
实例权限	仅基础版和企业版支持创建云端智能体。

自定义智能体分类

自定义智能体按创建方式分为本地和云端两类，按作用范围则划分为企业级、团队级、项目级和个人级。请结合具体的开发场景和协作需求，选择最适合的智能体类型进行创建。

表2 自定义智能体分类
创建方式	作用范围	说明
本地	项目级	仅针对当前项目生效，随代码库分发，存储在本地。存储路径：项目根目录的“./.codeartsdoer/agents”
本地	个人级	针对当前用户下的所有项目生效，存储在本地。存储位置：本地的“~/.codeartsdoer/agents/”
云端	企业级	企业全员可用的智能体，由企业管理员创建并存储于云端。当开发者登录华为云码道客户端时，系统会自动将该用户权限范围内可见的云端智能体缓存至本地“~/.codeartsdoer/cache/enterprise/agents/”路径下。
	团队级	仅限指定团队使用，由企业管理员或团队管理员创建，存储于云端。当开发者登录华为云码道客户端时，系统会自动将该用户权限范围内可见的云端智能体缓存至本地“~/.codeartsdoer/cache/team/agents/”路径下。
	个人级	仅创建者可用，存储在云端。当开发者登录华为云码道客户端时，系统会自动将该用户权限范围内可见的云端智能体缓存至本地“~/.codeartsdoer/cache/user/agents/”路径下。

创建自定义智能体

华为云码道支持创建本地和云端两种类型的智能体。当用户登录华为云码道时，系统会在本地缓存用户在云端可见的智能体。之后，每24小时，这些本地缓存的云端智能体会自动刷新一次，以确保与云端信息保持同步。您也可以在华为云码道客户端的设置页面，手动单击“刷新”来刷新一次本地缓存可见的云端智能体。

参考快速启动操作，登录华为云码道IDE。
单击华为云码道IDE右上角的设置图标，进入华为云码道IDE全局设置页面。
在设置页面的左侧导航栏中，选择“智能体”。
单击“创建智能体”，进入创建智能体页面。

设置智能体参数，单击“创建”。

图1 创建本地自定义智能体
点击放大

表3 创建智能体参数说明
参数	说明
智能体头像	自定义智能体头像已预置了多种风格，请按需选择。
智能体名称	新建自定义智能体的名称。命名规范：长度2~20字符，由中文、英文字母、数字、下划线和中划线（-）组成，且必须以中文或英文字母开头。
作用域	定义自定义智能体的使用范围。项目级：该智能体只在当前项目可用，其他项目无法调用。个人级：该智能体在当前用户的所有项目中均可调用。
智能体类型	选择智能体的工作模式，影响其行为逻辑和能力边界。主/子智能体：既可以被主智能体调用，也可以主动调用子智能体。主智能体：独立运行处理用户请求，不能被其他主智能体、子智能体调用。子智能体：可被其他主智能体调用来执行特定任务。
描述	简要说明这个智能体能做什么，帮助用户理解其功能，长度不能超过5000个字符。
提示词	设定智能体的角色、语气、工作流程、规则规范等系统指令，相当于给AI的“人设+行为准则”。
技能	为智能体关联技能，使其具备执行某些专业任务的能力。说明：华为云码道对智能体关联的技能数量没有硬性限制，建议不要超过20个，确保获得最优使用体验。
MCP工具	为智能体接入外部工具或服务，让它能够与外界进行交互，例如获取实时信息、操作软件等。说明：支持最多添加80个MCP工具，建议同时启用的工具数量控制在8个以内，启用3个可获得最优使用体验。仅当“作用域”设置为“项目级”时，才显示该配置项。
内置工具	智能体本身自带的、开箱即用的工具。阅读：检索并查看文件内容。编辑：对文件进行新增、修改或删除操作。终端：在命令行环境中执行系统命令。预览：实时预览生成的前端页面效果。访问网页：抓取并读取网页内容。

验证自定义智能体。

自定义智能体创建后，在对应类别页签中（如“项目级”），可查看到已创建的智能体，且状态为已开启（如图2）。同时，在聊天界面的输入框中，单击“智能体”，在自定义智能体列表中正常显示智能体（如图3）。
图2 查看已创建的智能体

 图3 显示创建的自定义智能体

如果您创建的是子智能体，则不会在自定义智能体中显示。

仅基础版和企业版支持创建云端自定义智能体。

进入码道代码智能体控制台。
在左侧导航栏中，选择“智能体设置 > 智能体中心”，进入智能体中心页面。
单击“新建智能体”，进入新建建智能体页面。

设置智能体参数，单击“创建并启用”。

表4 创建智能体参数说明
参数	说明
智能体头像	自定义智能体头像已预置了多种风格，请按需选择。
智能体名称	新建自定义智能体的名称。命名规范：长度2~20字符，由中文、英文字母、数字、下划线和中划线（-）组成，且必须以中文或英文字母开头。
智能体类型	选择智能体的工作模式，影响其行为逻辑和能力边界。主/子智能体：既可以被主智能体调用，也可以主动调用子智能体。主智能体：独立运行处理用户请求，不能被其他主智能体、子智能体调用。子智能体：可被其他主智能体调用来执行特定任务。
描述	简要说明这个智能体能做什么，帮助用户理解其功能，长度不能超过5000个字符。
可见范围	定义自定义智能体的可见范围，创建后不可修改。个人：仅创建者可用。企业：企业全员可用，仅企业管理员可创建。团队：仅指定团队可用，企业管理员或团队管理员可创建。
可用团队空间	指定可使用该智能体的团队，仅展示当前账号所属团队。 “可见范围”设置为“团队”时，才会显示该配置项。
提示词	设定智能体的角色、语气、工作流程、规则规范等系统指令，相当于给AI的“人设+行为准则”。
内置工具	智能体本身自带的、开箱即用的工具。阅读：检索并查看文件内容。编辑：对文件进行新增、修改或删除操作。终端：在命令行环境中执行系统命令。预览：实时预览生成的前端页面效果。访问网页：抓取并读取网页内容。
技能	为智能体关联技能，使其具备执行某些专业任务的能力。说明：华为云码道对智能体关联的技能数量没有硬性限制，建议不要超过20个，确保获得最优使用体验。

查看创建的智能体。
- 返回智能体中心，在智能体列表中可查看到已创建的智能体。
  图4 在智能中心查看目标智能体
- 在华为云码道IDE设置页面的“智能体”中，单击刷新图标，进行手动刷新。刷新完成后，进入目标页签（如个人级），即可查看到目标智能体。
  图5 在华为云码道IDE查看目标智能体

使用自定义智能体

在聊天界面的输入框下方选择自定义的智能体（如Python调试专家），切换到自定义智能体模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。

如果没有正常显示华为云码道的聊天窗口，请在顶部菜单栏的右上方，单击展开AI侧栏图标，即可打开华为云码道。

图6 选择自定义的智能体
在聊天界面的输入框中，输入相关指令（如输入一段包含错误的Python代码片段），单击发送图标或使用“Enter”快捷键发送。
查看智能体执行结果。

智能体会自动检测代码片段中包含的语法或逻辑错误，并提供准确的修复建议及修正后的代码。
图7 智能体执行结果

设置自定义智能体使用的默认模型

自定义智能体创建后，其模型使用遵循以下规则：主智能体默认沿用系统内置智能体的模型（假设，智能体选用GLM-5作为大语言模型，则自定义模型使用的模型则为GLM-5，如图8），子智能体则直接继承调用它的主智能体所使用的模型。如果需要修改自定义智能体默认使用的模型，可通过修改自定义智能体的配置文件来实现。

图8 智能体默认使用的模型
点击放大

进入自定义智能体配置文件所在目录。

以项目级自定义智能体为例，在本地机器上，进入项目目录的“./codeartsdoer/agents/”。您也可以直接在华为云码道IDE工具的资源管理器中定位到对应目录。其他类型的自定义智能体Markdown文件存放路径，请参见表2。
图9 进入配置文件所在目录

打开自定义智能体的Markdown文件，增加model参数并保存文件（Windows/Linux：“Ctrl+S”；macOS:“Command(⌘)+S”）。

在华为云码道中，通过配置model字段为自定义智能体指定默认模型。您可以针对特定任务动态切换最优模型，从而平衡性能与成本。例如，在规划阶段采用轻量级高速模型以提升响应速度，而在实现阶段则调用高能力模型以确保执行质量。

model值的格式为“provider/model-id”，其中“provider”为模型供应商（在华为云码道中请配置为inferhub-provider），“model-id”为具体模型的ID。

如果配置的模型不存在或无权限，主智能体会自动切换至内置智能体的默认模型，子智能体则会继承主智能体的模型。

---
description: 专注于Python代码错误排查与优化，预期专业且简洁。
mode: primary
model: inferhub-provider/GLM-5.1
permission:
  skill:
    '*': deny
disable: false
scope: project
avatar: avatar1
---

表5 华为云码道系统内置模型ID
模型名	模型ID
GLM-5	Glm-5-internal
GLM-5.1	GLM-5.1
GLM-4.7	GLM-4.7-internal
GLM-4.7-ArkTS-SPARK	GLM-4.7-SFT-Harmony
DeepSeek-V3.2	deepseek-v3.2

返回华为云码道IDE设置页面，在“智能体”中单击，刷新智能体配置。

图10 刷新智能体配置
查看自定义智能体默认使用的大语言模型。

在聊天界面的输入框中，切换至目标自定义智能体后，系统将自动应用由Markdown配置文件设定的默认模型（如GLM-5.1）。
图11 默认模型切换为目标模型

管理自定义智能体

华为云码道IDE具备自定义智能体的全生命周期管理能力。用户可根据实际业务需求，对已创建的智能体进行高效管控与持续优化。

表6 管理本地自定义智能体
操作	具体步骤
启用或禁用本地自定义智能体	在华为云码道IDE设置页面的“智能体 > 项目级”/“智能体 > 个人级”页签中，单击目标智能体上的 /，即可启用或禁用该智能体。
编辑本地自定义智能体	在华为云码道IDE设置页面的“智能体 > 项目级”/“智能体 > 个人级”页签中，将鼠标悬浮在目标智能体上，单击，即可对智能体进行编辑。
删除自定义智能体	在华为云码道IDE设置页面的“智能体 > 项目级”/“智能体 > 个人级”页签中，将鼠标悬浮在目标智能体上，单击。在弹出的确认对话框中单击“确认”，即可完成删除。智能体删除后不可恢复，请确保该智能体已不再使用后再执行此操作。
从云端同步自定义智能体到本地	用户登录华为云码道客户端时，系统会将云端用户可见的智能体缓存一次到本地。之后，每24小时，这些本地缓存的云端智能体会自动刷新一次，以确保与云端信息保持同步。您也可以在“智能体”页面，单击刷新图标，进行手动刷新。
启用或禁用从云端同步到本地的自定义智能体	在华为云码道IDE设置页面的“智能体 > 企业级”/“智能体 > 团队级”页签中，单击目标智能体上的 /，即可启用或禁用该智能体。
查看从云端同步到本地的自定义智能体配置	在华为云码道IDE设置页面的“智能体 > 企业级”/“智能体 > 团队级”页签中，单击目标智能体上的查看，即可查看智能体配置详情。

仅创建者可管理云端自定义智能体。

表7 管理云端自定义智能体
操作	具体步骤
启用或禁用云端自定义智能体	进入码道代码智能体页面。在左侧导航栏中，选择“智能体设置 > 智能体中心”，进入智能体中心页面。在智能体列表中，单击目标智能体上的 /，即可启用或禁用该智能体。
编辑云端自定义智能体	进入码道代码智能体页面。在左侧导航栏中，选择“智能体设置 > 智能体中心”，进入智能体中心页面。在智能体列表中，单击目标智能体操作列的“编辑”，即可对智能体进行编辑。
复制云端自定义智能体	当您需要复用成熟配置、并行多版本迭代、团队模板共享或任务隔离等需求时，可通过复制智能体实现。进入码道代码智能体页面。在左侧导航栏中，选择“智能体设置 > 智能体中心”，进入智能体中心页面。在智能体列表中，单击目标智能体操作列的“复制”，进入复制智能体页面。根据需要调整配置（或直接保留默认），单击“创建并启用”，即可快速生成新智能体。
删除云端自定义智能体	进入码道代码智能体页面。在左侧导航栏中，选择“智能体设置 > 智能体中心”，进入智能体中心页面。在智能体列表中，单击目标智能体操作列的“删除”。在弹出的确认框中，单击“确定”，即可删除该智能体。智能体删除后不可恢复，请确保该智能体已不再使用后再执行此操作。