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