更新时间:2026-06-08 GMT+08:00
分享

规则

通过自定义规则(Rule)对智能体行为进行约束,使其更准确地理解并严格遵循相关规范。

表1 规则与其他功能的对比

对比维度

规则(Rule)

技能(Skill)

MCP Server

定义

用于约束智能体的行为方式。

用于描述如何完成特定任务。

提供外部工具的调用能力。

加载方式

在对话开始时加载到上下文中,持续参与推理。

按需加载,减少上下文占用。

不参与推理过程,按需调用外部接口。

使用场景

定义代码规范、输出格式、团队协作约定等。

例如:代码必须符合PEP8规范。

封装测试流程、开发任务、复杂业务逻辑等。

例如:执行UI自动化测试。

连接外部系统,执行具体操作。

例如:控制浏览器操作。

关键区别

控制智能体“应该怎么做”,是行为边界。

解决“如何完成任务”,是流程指导。

提供“调用工具的能力”,是执行能力。

规则分类

规则按创建方式可分为本地云端,按作用范围可分为企业级团队级项目级个人级。用户可根据具体开发场景与协作需求,选择最适合的规则进行设置,实现灵活高效的代码管理。

表2 规则分类

创建方式

作用范围

说明

本地

项目级

仅针对当前项目生效,随代码库分发,存储在本地。

规则文件存放路径:项目根目录的“./.codeartsdoer/rule”。

个人级

针对当前用户下的所有项目生效,基于个人习惯或特定偏好制定的规则,存储在本地。

规则文件存放路径:本地“%USERPROFILE%/.codeartsdoer/rule”。

云端

企业级

企业统一的规则,整个企业所有成员都可用,由企业管理员创建,存储在云端。

团队级

团队统一的规则,指定的团队可用。由企业管理员或团队管理员创建,存储在云端。

个人级

基于个人习惯或特定偏好制定的规则,仅成员本人可用,存储在云端。

若存在名称相同的规则,规则调用优先级为:云端企业级 > 云端团队级 > 本地项目级 > 本地个人级 > 云端个人级。

约束与限制

码道代码智能体基础版专业版套餐支持创建云端规则。

创建本地规则

华为云码道客户端支持创建项目级个人级两类规则,存储在本地,您可以根据开发场景与协作需求灵活选择,实现高效、精准的代码管理。

专为当前项目定制的规则配置,随代码库一并分发,确保团队成员在统一规范下协作开发,提升一致性与交付效率。

  1. 参考快速启动操作,登录华为云码道。
  2. 单击华为云码道IDE右上角的设置图标 ,进入华为云码道IDE全局设置页面。
  3. 在左侧导航栏选择“技能与规则”,进入“全部已安装”页面。
  4. 在“项目级”页签中,单击规则后的
  5. 参考表3设置本地项目级规则参数。

    图1 新建项目级规则
    表3 本地项目级规则参数说明

    参数

    说明

    规则名称

    新建规则的名称。

    命名规范:长度1~64字符,且禁止包含\/:*?"<>|特殊字符。

    适用范围

    指定规则的适用范围,即规则在哪里生效。

    • 自动应用:规则将默认应用于所有会话,包括华为云码道编辑区,系统自动识别,无需重复配置。
    • 手动触发:规则不会自动生效。用户需在对话中输入“#”,并从列表中选择特定规则,方可启用。

    规则描述

    可选,规则的描述信息,长度不超过200字符。

    内容

    规则的内容,让智能体在特定条件下自动做出一致、可预测的响应或行为。长度不超过50000字符。

  6. 单击“确定”,完成规则的创建。

    在“项目级”页签中,查看新创建的本地项目级规则。本地项目级规则创建完成后,存放在“项目根目录的“./.codeartsdoer/rule”路径下。

本地个人规则根据您的使用习惯和偏好设定,华为云码道将始终遵循这些规则,在所有项目中为您提供更贴合个人风格的输出。

  1. 参考快速启动操作,登录华为云码道。
  2. 单击华为云码道IDE右上角的设置图标 ,进入华为云码道IDE全局设置页面。
  3. 在左侧导航栏选择“技能与规则”,进入“全部已安装”页面。
  4. 在“个人级”页签中,单击规则后的
  5. 参考表4设置本地个人级规则参数。

    图2 新建本地个人级规则
    表4 本地个人级规则参数说明

    参数

    说明

    规则名称

    新建规则的名称。

    命名规范:长度1~64字符,且仅允许包含字母、数字、下划线、中文、连字符(-)和点号。

    适用范围

    指定规则的适用范围,即规则在哪里生效。

    • 自动应用:规则将默认应用于所有会话,包括华为云码道编辑区,系统自动识别,无需重复配置。
    • 手动触发:规则不会自动生效。用户需在对话中输入“#”,并从列表中选择特定规则,方可启用。

    类型

    指定规则的存放位置,选择“本地”,表示该个人级规则存放于本地。

    规则描述

    可选,规则的描述信息,长度不超过200字符。

    内容

    规则的内容,让智能体在特定条件下自动做出一致、可预测的响应或行为。长度不超过50000字符。

  6. 单击“确定”,完成规则的创建。

    在“个人级”页签中,查看新创建的本地个人级规则。本地个人级规则创建完成后,存放在本地“%USERPROFILE%/.codeartsdoer/rule”路径下。

华为云码道规则现已兼容AGENTS.md文件。您只需将AGENTS.md文件放置到相应目录中,华为云码道即可自动识别并应用文件中定义的规则。

表5 AGENTS.md文件级别

级别

作用域

优先级规则

说明

个人级

当前账号下的所有项目

  • 现有规则优先:当AGENTS.md中的内容与现有规则发生冲突时,以现有规则为准。
  • 项目级优先:当个人级与项目级AGENTS.md同时存在且内容冲突时,以项目级AGENTS.md为准。

个人专属的AGENTS.md,基于个人习惯与偏好的定制配置。

存放位置:本地的“%USERPROFILE%/.codeartsdoer/”

项目级

当前项目

项目定制的AGENTS.md,仅适用于当前项目。

存放位置:项目根目录下

以下通过创建项目级AGENTS.md为例,介绍如何自定义规则及其调用效果。

  1. 创建项目级AGENTS.md文件。

    在项目根目录下创建AGENTS.md文件,以配置项目级Agent行为。请从以下两种方式中任选一种执行:
    • 本地创建:在本地机器上,找到对应的项目文件夹。在项目的根目录下新建文件,命名为AGENTS.md。
    • 华为云码道创建:参考快速启动中操作,登录华为云码道。进入资源管理器,定位到对应项目。在项目目录下新建文件,命名为AGENTS.md。

    AGENTS.md文件配置示例如下:

    # 项目级Agent行为准则
    ## 1. 作用域声明
    本规则仅对当前项目上下文中的对话生效。
    ## 2. 核心应答约束
    - 结构化表达:回答必须采用清晰的层级结构(如列表、标题、加粗),避免大段无格式文本。逻辑需层层递进,重点突出。
    - 事实严谨性:严禁编造不确定信息。对于专业领域内容,需确保准确性;若信息缺失,请明确说明“无法确认”,而非猜测。
    - 语气与风格:语气保持专业但亲切,适当使用轻松自然的表达。
    ## 3. 强制要求
    每次回答结束后,必须且仅能添加以下固定结束语,不得修改、省略或添加其他内容:
    解答完毕。如果还有其他问题,欢迎随时告诉我

  2. 在智能体中发起对话,验证其输出效果。

    图3可知,智能体的输出严格遵循了“核心应答约束”中定义的风格要求。此外,对话末尾自动追加了“解答完毕。如果还有其他问题,欢迎随时告诉我”这一标准结束语,这说明“AGENTS.md”中的自定义规则已成功加载并生效。
    图3 自定义规则已成功加载并生效

创建云端规则

云端(码道代码智能体控制台)支持创建企业级团队级个人级三类规则,其中云端个人级规则既可在云端创建,也支持在本地创建。

创建云端规则前,请确保您已购买码道代码智能体基础版专业版套餐。

在云端创建企业级团队级个人级三类规则,具体步骤如下。

  1. 进入码道代码智能体控制台
  2. 在左侧导航栏选择“智能体设置 > 技能和规则中心”,进入技能和规则列表页面。
  3. 在“规则”页签,单击右上角的“新建规则”,弹出“新建规则”对话框。
  4. 参考表6设置规则参数。

    图4 新建云端规则
    表6 云端规则参数说明

    参数

    说明

    名称

    新建规则的名称。

    命名规范:长度1~64字符,且仅允许包含字母、数字、下划线、中文、连字符(-)和点号。

    内容

    自定义一条或多条规则的内容,长度不能超过50000个字符。

    例如,始终使用Python语言回答。

    使用范围

    指定规则的适用范围,即规则在哪里生效。

    • 自动应用:规则将默认应用于所有会话,包括华为云码道编辑区,系统自动识别,无需重复配置。
    • 手动触发:规则不会自动生效。用户需在对话中输入“#”,并从列表中选择特定规则,方可启用。

    可用范围

    • 个人:仅限成员本人使用,不会共享给其他用户。
    • 企业:整个企业所有成员都可用,仅企业管理员可创建
    • 团队:指定的团队的可用,企业管理员或团队管理员可创建

    可用团队

    仅“可用范围”设置为“团队”时,展示此参数。

    在下拉列表中选择团队,仅展示当前账号所属团队。若尚未创建团队,请先创建团队

    标签

    可选,华为云码道已预置了几类标签,请根据实际需求在下拉列表中选择。

    简要描述

    可选,规则的描述信息,长度不能超过1024个字符。

  5. 单击“确定并启用”,完成规则的创建。

    在“规则”页签中,查看新创建的规则。如需立即在华为云码道客户端中查看云端创建的规则,请进入“技能与规则”下对应规则页签(企业级/团队级/个人级),单击规则后的 ,同步云端规则到客户端。

    • 华为云码道客户端每24小时自动同步一次云端规则。
    • 华为云码道客户端仅同步已启用的规则

账号已启用席位,若席位未启用,将导致云端个人级规则创建失败。

  1. 参考快速启动操作,登录华为云码道。
  2. 单击华为云码道IDE右上角的设置图标 ,进入华为云码道IDE全局设置页面。
  3. 在左侧导航栏选择“技能与规则”,进入“全部已安装”页面。
  4. 在“个人级”页签中,单击规则后的
  5. 参考图5设置云端个人级规则参数。

    图5 新建云端个人级规则
    表7 本地个人级规则参数说明

    参数

    说明

    规则名称

    新建规则的名称。

    命名规范:长度1~64字符,且仅允许包含字母、数字、下划线、中文、连字符(-)和点号。

    适用范围

    指定规则的适用范围,即规则在哪里生效。

    • 自动应用:规则将默认应用于所有会话,包括华为云码道编辑区,系统自动识别,无需重复配置。
    • 手动触发:规则不会自动生效。用户需在对话中输入“#”,并从列表中选择特定规则,方可启用。

    类型

    指定规则的存放位置,选择“云端”,表示该个人级规则存放于云端。

    规则描述

    可选,规则的描述信息,长度不超过200字符。

    内容

    规则的内容,让智能体在特定条件下自动做出一致、可预测的响应或行为。长度不超过50000字符。

  6. 单击“确定”,完成规则的创建。

    在“个人级”页签中,查看新创建的云端个人级规则。

在对话中引用规则

  • 自动应用类型的规则:默认对所有会话生效(包括华为云码道编辑区),无需重复设置。
    图6 规则已生效
  • 手动触发类型的规则:在对话中输入“#”,然后选择已创建的规则,规则才能生效。
    图7 添加上下文选择规则
    图8 规则在对话中生效

管理规则

华为云码道IDE支持规则全生命周期管理,帮助用户根据业务需求高效管控与持续优化已创建的规则。

表8 管理本地规则

操作

具体步骤

编辑本地规则

在华为云码道IDE设置页面的技能与规则 > 项目级 > 规则/技能与规则 > 个人级 > 规则中,将鼠标悬浮在目标规则上,单击 ,即可对规则进行编辑。

删除本地规则

在华为云码道IDE设置页面的技能与规则 > 项目级 > 规则/技能与规则 > 个人级 > 规则中,将鼠标悬浮在目标规则上,单击 ,即可对规则进行删除。

目标规则已从规则列表中移除,表示规则删除成功。

注意:

规则删除后,使用该规则的智能体将受到影响,且删除的规则不可恢复,请谨慎操作。

仅创建者可编辑、删除、启用及禁用规则。

表9 管理云端规则

操作

具体步骤

编辑云端规则

  1. 在码道代码智能体控制台的“技能和规则中心 > 规则”中,查看目标规则的状态。
    • 如果为已启用,需先禁用该规则,然后才能执行编辑操作。
    • 如果为已禁用,执行下一步编辑规则。
  2. 单击目标规则后的“编辑”,即可对规则进行修改。

删除指定云端规则

  1. 在码道代码智能体控制台的“技能和规则中心 > 规则”中,查看目标规则的状态。
    • 如果为已启用,需先禁用该规则,然后才能执行删除操作。
    • 如果为已禁用,执行下一步删除规则。
  2. 单击目标规则后的“删除”,即可对规则进行删除。

    目标规则已从规则列表中移除,表示规则删除成功。

注意:

规则删除后,使用该规则的智能体将受到影响,且删除的规则不可恢复,请谨慎操作。

启用或禁用指定云端规则

在码道代码智能体控制台的“技能和规则中心 > 规则”中,单击目标规则后的 / ,启用或禁用云端规则。

已启用的规则才会同步至本地华为云码道中。

收藏或取消收藏指定云端规则

在码道代码智能体控制台的“技能和规则中心 > 规则”中,单击目标规则后的“收藏”/“取消收藏”,即可收藏或取消收藏该规则。

在“我收藏的”页面查看已收藏的规则。

批量删除云端规则

  1. 在码道代码智能体控制台的“技能和规则中心 > 规则”中,查看目标规则的状态。
    • 如果为已启用,需先禁用该规则,然后才能执行删除操作。
    • 如果为已禁用,执行下一步删除规则。
  2. 勾选目标规则,单击右上角的“更多 > 批量删除”,弹出确认批量删除对话框。
  3. 输入“DELETE”或单击“一键键入”,然后单击“确定”,完成规则的批量删除。

    目标规则已从规则列表中移除,表示规则删除成功。

批量启用或禁用云端规则

在码道代码智能体控制台的“技能和规则中心 > 规则”中,勾选目标规则,单击右上角的“批量启用”或“更多 > 批量禁用”,批量启用或禁用云端规则。

已启用的规则才会同步至华为云码道客户端中。

批量收藏或取消收藏云端规则

在码道代码智能体控制台的“技能和规则中心 > 规则”中,勾选目标规则,单击右上角的“更多 > 批量收藏”/“更多 > 批量取消收藏”,即可批量收藏或取消收藏目标规则。

在“我收藏的”页面查看已收藏的规则。

修改云端企业级/团队级规则的适用范围

在华为云码道IDE设置页面的技能与规则 > 企业级 > 规则/技能与规则 > 团队级 > 规则中,单击目标规则后的开关即可修改适用范围。

  • :规则适用范围为“手动触发”,需要您手动触发才能生效。
  • :规则适用范围为“自动应用”,由系统自动识别并触发生效。

批量修改云端企业级/团队级规则的适用范围

  1. 在华为云码道IDE设置页面的技能与规则 > 企业级 > 规则/技能与规则 > 团队级 > 规则中,单击右上角的
  2. 勾选目标规则,选择右上角的“开启”或“关闭”,批量修改规则的适用范围。

相关文档

如果您需要了解规则的端到端使用示例,请参见基于自定义规则的AI绘图逻辑构建实践。本实践通过配置规则约束AI绘制sin(x)的过程,实现坐标精准、格式统一及结果可控的标准化生成。

相关文档