规则
通过自定义规则(Rule)对智能体行为进行约束,使其更准确地理解并严格遵循相关规范。
| 对比维度 | 规则(Rule) | 技能(Skill) | MCP Server |
|---|---|---|---|
| 定义 | 用于约束智能体的行为方式。 | 用于描述如何完成特定任务。 | 提供外部工具的调用能力。 |
| 加载方式 | 在对话开始时加载到上下文中,持续参与推理。 | 按需加载,减少上下文占用。 | 不参与推理过程,按需调用外部接口。 |
| 使用场景 | 定义代码规范、输出格式、团队协作约定等。 例如:代码必须符合PEP8规范。 | 封装测试流程、开发任务、复杂业务逻辑等。 例如:执行UI自动化测试。 | 连接外部系统,执行具体操作。 例如:控制浏览器操作。 |
| 关键区别 | 控制智能体“应该怎么做”,是行为边界。 | 解决“如何完成任务”,是流程指导。 | 提供“调用工具的能力”,是执行能力。 |
规则分类
规则按创建方式可分为本地与云端,按作用范围可分为企业级、团队级、项目级和个人级。用户可根据具体开发场景与协作需求,选择最适合的规则进行设置,实现灵活高效的代码管理。
| 创建方式 | 作用范围 | 说明 |
|---|---|---|
| 本地 | 项目级 | 仅针对当前项目生效,随代码库分发,存储在本地。 规则文件存放路径:项目根目录的“./.codeartsdoer/rule”。 |
| 个人级 | 针对当前用户下的所有项目生效,基于个人习惯或特定偏好制定的规则,存储在本地。 规则文件存放路径:本地“%USERPROFILE%/.codeartsdoer/rule”。 | |
| 云端 | 企业级 | 企业统一的规则,整个企业所有成员都可用,由企业管理员创建,存储在云端。 |
| 团队级 | 团队统一的规则,指定的团队可用。由企业管理员或团队管理员创建,存储在云端。 | |
| 个人级 | 基于个人习惯或特定偏好制定的规则,仅成员本人可用,存储在云端。 |
若存在名称相同的规则,规则调用优先级为:云端企业级 > 云端团队级 > 本地项目级 > 本地个人级 > 云端个人级。
约束与限制
仅码道代码智能体基础版和专业版套餐支持创建云端规则。
创建本地规则
华为云码道客户端支持创建项目级与个人级两类规则,存储在本地,您可以根据开发场景与协作需求灵活选择,实现高效、精准的代码管理。
专为当前项目定制的规则配置,随代码库一并分发,确保团队成员在统一规范下协作开发,提升一致性与交付效率。
本地个人规则根据您的使用习惯和偏好设定,华为云码道将始终遵循这些规则,在所有项目中为您提供更贴合个人风格的输出。
- 参考快速启动操作,登录华为云码道。
- 单击华为云码道IDE右上角的设置图标
,进入华为云码道IDE全局设置页面。 - 在左侧导航栏选择“技能与规则”,进入“全部已安装”页面。
- 在“个人级”页签中,单击规则后的
。 - 参考表4设置本地个人级规则参数。 图2 新建本地个人级规则
表4 本地个人级规则参数说明 参数
说明
规则名称
新建规则的名称。
命名规范:长度1~64字符,且仅允许包含字母、数字、下划线、中文、连字符(-)和点号。
适用范围
指定规则的适用范围,即规则在哪里生效。
- 自动应用:规则将默认应用于所有会话,包括华为云码道编辑区,系统自动识别,无需重复配置。
- 手动触发:规则不会自动生效。用户需在对话中输入“#”,并从列表中选择特定规则,方可启用。
类型
指定规则的存放位置,选择“本地”,表示该个人级规则存放于本地。
规则描述
可选,规则的描述信息,长度不超过200字符。
内容
规则的内容,让智能体在特定条件下自动做出一致、可预测的响应或行为。长度不超过50000字符。
- 单击“确定”,完成规则的创建。
在“个人级”页签中,查看新创建的本地个人级规则。本地个人级规则创建完成后,存放在本地“%USERPROFILE%/.codeartsdoer/rule”路径下。
华为云码道规则现已兼容AGENTS.md文件。您只需将AGENTS.md文件放置到相应目录中,华为云码道即可自动识别并应用文件中定义的规则。
| 级别 | 作用域 | 优先级规则 | 说明 |
|---|---|---|---|
| 个人级 | 当前账号下的所有项目 |
| 个人专属的AGENTS.md,基于个人习惯与偏好的定制配置。 存放位置:本地的“%USERPROFILE%/.codeartsdoer/” |
| 项目级 | 当前项目 | 项目定制的AGENTS.md,仅适用于当前项目。 存放位置:项目根目录下 |
以下通过创建项目级AGENTS.md为例,介绍如何自定义规则及其调用效果。
- 创建项目级AGENTS.md文件。 在项目根目录下创建AGENTS.md文件,以配置项目级Agent行为。请从以下两种方式中任选一种执行:
- 本地创建:在本地机器上,找到对应的项目文件夹。在项目的根目录下新建文件,命名为AGENTS.md。
- 华为云码道创建:参考快速启动中操作,登录华为云码道。进入资源管理器,定位到对应项目。在项目目录下新建文件,命名为AGENTS.md。
AGENTS.md文件配置示例如下:
# 项目级Agent行为准则 ## 1. 作用域声明 本规则仅对当前项目上下文中的对话生效。 ## 2. 核心应答约束 - 结构化表达:回答必须采用清晰的层级结构(如列表、标题、加粗),避免大段无格式文本。逻辑需层层递进,重点突出。 - 事实严谨性:严禁编造不确定信息。对于专业领域内容,需确保准确性;若信息缺失,请明确说明“无法确认”,而非猜测。 - 语气与风格:语气保持专业但亲切,适当使用轻松自然的表达。 ## 3. 强制要求 每次回答结束后,必须且仅能添加以下固定结束语,不得修改、省略或添加其他内容: 解答完毕。如果还有其他问题,欢迎随时告诉我
- 在智能体中发起对话,验证其输出效果。 由图3可知,智能体的输出严格遵循了“核心应答约束”中定义的风格要求。此外,对话末尾自动追加了“解答完毕。如果还有其他问题,欢迎随时告诉我”这一标准结束语,这说明“AGENTS.md”中的自定义规则已成功加载并生效。
创建云端规则
云端(码道代码智能体控制台)支持创建企业级、团队级与个人级三类规则,其中云端个人级规则既可在云端创建,也支持在本地创建。
创建云端规则前,请确保您已购买码道代码智能体基础版或专业版套餐。
在云端创建企业级、团队级与个人级三类规则,具体步骤如下。
- 进入码道代码智能体控制台。
- 在左侧导航栏选择“智能体设置 > 技能和规则中心”,进入技能和规则列表页面。
- 在“规则”页签,单击右上角的“新建规则”,弹出“新建规则”对话框。
- 参考表6设置规则参数。 图4 新建云端规则
表6 云端规则参数说明 参数
说明
名称
新建规则的名称。
命名规范:长度1~64字符,且仅允许包含字母、数字、下划线、中文、连字符(-)和点号。
内容
自定义一条或多条规则的内容,长度不能超过50000个字符。
例如,始终使用Python语言回答。
使用范围
指定规则的适用范围,即规则在哪里生效。
- 自动应用:规则将默认应用于所有会话,包括华为云码道编辑区,系统自动识别,无需重复配置。
- 手动触发:规则不会自动生效。用户需在对话中输入“#”,并从列表中选择特定规则,方可启用。
可用范围
- 个人:仅限成员本人使用,不会共享给其他用户。
- 企业:整个企业所有成员都可用,仅企业管理员可创建。
- 团队:指定的团队的可用,企业管理员或团队管理员可创建。
可用团队
仅“可用范围”设置为“团队”时,展示此参数。
在下拉列表中选择团队,仅展示当前账号所属团队。若尚未创建团队,请先创建团队。
标签
可选,华为云码道已预置了几类标签,请根据实际需求在下拉列表中选择。
简要描述
可选,规则的描述信息,长度不能超过1024个字符。
- 单击“确定并启用”,完成规则的创建。
在“规则”页签中,查看新创建的规则。如需立即在华为云码道客户端中查看云端创建的规则,请进入“技能与规则”下对应规则页签(企业级/团队级/个人级),单击规则后的
,同步云端规则到客户端。
- 华为云码道客户端每24小时自动同步一次云端规则。
- 华为云码道客户端仅同步已启用的规则。
账号已启用席位,若席位未启用,将导致云端个人级规则创建失败。
- 参考快速启动操作,登录华为云码道。
- 单击华为云码道IDE右上角的设置图标
,进入华为云码道IDE全局设置页面。 - 在左侧导航栏选择“技能与规则”,进入“全部已安装”页面。
- 在“个人级”页签中,单击规则后的
。 - 参考图5设置云端个人级规则参数。
表7 本地个人级规则参数说明 参数
说明
规则名称
新建规则的名称。
命名规范:长度1~64字符,且仅允许包含字母、数字、下划线、中文、连字符(-)和点号。
适用范围
指定规则的适用范围,即规则在哪里生效。
- 自动应用:规则将默认应用于所有会话,包括华为云码道编辑区,系统自动识别,无需重复配置。
- 手动触发:规则不会自动生效。用户需在对话中输入“#”,并从列表中选择特定规则,方可启用。
类型
指定规则的存放位置,选择“云端”,表示该个人级规则存放于云端。
规则描述
可选,规则的描述信息,长度不超过200字符。
内容
规则的内容,让智能体在特定条件下自动做出一致、可预测的响应或行为。长度不超过50000字符。
- 单击“确定”,完成规则的创建。
在“个人级”页签中,查看新创建的云端个人级规则。
在对话中引用规则
- 自动应用类型的规则:默认对所有会话生效(包括华为云码道编辑区),无需重复设置。 图6 规则已生效
- 手动触发类型的规则:在对话中输入“#”,然后选择已创建的规则,规则才能生效。 图7 添加上下文选择规则
图8 规则在对话中生效
管理规则
华为云码道IDE支持规则全生命周期管理,帮助用户根据业务需求高效管控与持续优化已创建的规则。
| 操作 | 具体步骤 |
|---|---|
| 编辑本地规则 | 在华为云码道IDE设置页面的/中,将鼠标悬浮在目标规则上,单击 |
| 删除本地规则 | 在华为云码道IDE设置页面的/中,将鼠标悬浮在目标规则上,单击 目标规则已从规则列表中移除,表示规则删除成功。 注意: 规则删除后,使用该规则的智能体将受到影响,且删除的规则不可恢复,请谨慎操作。 |
仅创建者可编辑、删除、启用及禁用规则。
| 操作 | 具体步骤 |
|---|---|
| 编辑云端规则 |
|
| 删除指定云端规则 |
注意: 规则删除后,使用该规则的智能体将受到影响,且删除的规则不可恢复,请谨慎操作。 |
| 启用或禁用指定云端规则 | 在码道代码智能体控制台的“技能和规则中心 > 规则”中,单击目标规则后的 已启用的规则才会同步至本地华为云码道中。 |
| 收藏或取消收藏指定云端规则 | 在码道代码智能体控制台的“技能和规则中心 > 规则”中,单击目标规则后的“收藏”/“取消收藏”,即可收藏或取消收藏该规则。 在“我收藏的”页面查看已收藏的规则。 |
| 批量删除云端规则 | |
| 批量启用或禁用云端规则 | 在码道代码智能体控制台的“技能和规则中心 > 规则”中,勾选目标规则,单击右上角的“批量启用”或“更多 > 批量禁用”,批量启用或禁用云端规则。 已启用的规则才会同步至华为云码道客户端中。 |
| 批量收藏或取消收藏云端规则 | 在码道代码智能体控制台的“技能和规则中心 > 规则”中,勾选目标规则,单击右上角的“更多 > 批量收藏”/“更多 > 批量取消收藏”,即可批量收藏或取消收藏目标规则。 在“我收藏的”页面查看已收藏的规则。 |
| 修改云端企业级/团队级规则的适用范围 | 在华为云码道IDE设置页面的/中,单击目标规则后的开关即可修改适用范围。
|
| 批量修改云端企业级/团队级规则的适用范围 |
|
相关文档
如果您需要了解规则的端到端使用示例,请参见基于自定义规则的AI绘图逻辑构建实践。本实践通过配置规则约束AI绘制sin(x)的过程,实现坐标精准、格式统一及结果可控的标准化生成。









