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

规则

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

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

对比维度

规则(Rule)

技能(Skill)

MCP Server

定义

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

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

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

加载方式

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

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

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

使用场景

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

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

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

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

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

例如:控制浏览器操作。

关键区别

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

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

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

华为云码道代码智能体支持创建本地云端两种类型的规则:本地规则在客户端创建,云端规则在控制台创建,其中云端个人级规则既可在云端创建,也支持在本地客户端创建。

本章节介绍在客户端管理规则的操作,如需在控制台管理云端规则,请参考管理技能和规则中心

本地规则分类

表2 本地规则分类

作用范围

适用对象

存放路径

说明

项目级

当前项目

项目根目录的“./.codeartsdoer/rule”

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

个人级

当前用户的所有项目

%USERPROFILE%/.codeartsdoer/rule

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

约束与限制

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

创建本地规则

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

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

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

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

    参数

    说明

    规则名称

    新建规则的名称。

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

    适用范围

    指定规则的适用范围,即规则生效的场景。

    • 自动应用:规则将默认应用于所有会话,由系统自动识别。
    • 手动触发:规则不会自动生效。用户需在聊天窗口的输入框中输入“#”,或单击 选择“添加上下文”,再选择“Rules”并从列表中选择特定规则,方可启用。

    规则描述

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

    内容

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

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

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

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

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

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

    参数

    说明

    规则名称

    新建规则的名称。

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

    适用范围

    指定规则的适用范围,即规则生效的场景。

    • 自动应用:规则将默认应用于所有会话,由系统自动识别。
    • 手动触发:规则不会自动生效。用户需在聊天窗口的输入框中输入“#”,或单击 选择“添加上下文”,再选择“Rules”并从列表中选择特定规则,方可启用。

    类型

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

    规则描述

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

    内容

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

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

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

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

表5 AGENTS.md文件级别

级别

作用域

存放位置

优先级规则

说明

个人级

当前用户的所有项目

%USERPROFILE%/.codeartsdoer/

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

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

项目级

当前项目

项目根目录下

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

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

  1. 通过以下任意一种方式在项目根目录下创建AGENTS.md文件。

    • 本地创建:在本地机器上,找到对应的项目文件夹。在项目的根目录下新建文件,命名为AGENTS.md。
    • 华为云码道代码智能体创建:参考快速启动中操作,登录码道IDE。进入资源管理器,定位到对应项目。在项目目录下新建文件,命名为AGENTS.md。

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

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

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

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

    图3 自定义规则已成功加载并生效

如果你使用的是企业版(新版套餐)或原个人版/体验版/基础版/专业版(旧版套餐),请确保账号已启用席位,若席位未启用,会导致云端个人级规则创建失败。

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

    图4 个人级规则
    表6 个人级规则参数说明

    参数

    说明

    规则名称

    新建规则的名称。

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

    适用范围

    指定规则的适用范围,即规则生效的场景。

    • 自动应用:规则将默认应用于所有会话,由系统自动识别。
    • 手动触发:规则不会自动生效。用户需在聊天窗口的输入框中输入“#”,或单击 选择“添加上下文”,再选择“Rules”并从列表中选择特定规则,方可启用。

    类型

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

    规则描述

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

    内容

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

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

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

在对话中引用规则

  • 自动应用类型的规则:默认对所有会话生效,由系统自动识别。
  • 手动触发类型的规则:在聊天输入框中输入“#”,或单击 选择“添加上下文”,再选择“Rules > 已创建的规则名称”,规则才能生效。
    图5 添加上下文选择规则

管理本地规则

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

表7 管理本地规则

操作

具体步骤

编辑本地规则

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

删除本地规则

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

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

注意:

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

相关文档

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

相关文档