TRAE Work企业智能体配置：4步搞定自定义触发规则

[1] 一句话结论 #

本指南将教你完成TRAE Work企业智能体自定义配置与触发规则部署，适配内部协作场景。

[2] 适用场景与不适用场景 #

适用场景

1. 企业研发团队规模10人以上，需要统一代码规范检查触发规则的场景
2. 需要定时执行代码审计、日报汇总等周期性协作任务的场景
3. 有代码推送、工单提交等事件触发智能体自动执行任务需求的场景

不适用场景

1. 个人开发者单项目使用，不需要企业级共享规则的场景，建议直接用本地自定义提示词即可
2. 触发规则复杂度超过5个分支条件的复杂工作流场景，建议参考火山引擎函数计算+工作流产品方案
3. 需要对接企业外部非MCP标准第三方系统的场景，建议使用企业版自定义集成能力

[3] 前置准备 #

• TRAE Work 3.3.91及以上版本，支持MCP工具调用
• 企业管理员账号，拥有智能体发布、规则配置权限
• 已完成TRAE IDE/桌面端安装，项目使用Git管理
• 预计配置耗时30分钟

[4] 分步实现 #

步骤1：创建企业专属智能体

步骤说明：先创建可共享的智能体实体，是后续配置触发规则的基础，跳过的话无法绑定规则。
操作：登录TRAE IDE，输入@点击「创建智能体」，选择「企业专属智能体」，配置头像、名称、系统提示词（示例："你是团队代码审查助手，所有输出必须符合团队Java编码规范"），勾选需要调用的内置工具，点击「保存并发布」。
预期结果：智能体创建成功，企业所有成员在@列表可看到该智能体。

⚠️ 常见错误：创建智能体时选择了个人智能体，其他成员看不到
原因：个人智能体仅当前账号可见，企业专属智能体才会共享给全员
解决方法：删除原有智能体，重新选择「企业专属智能体」类型创建并发布

步骤2：配置全局协作规则

步骤说明：全局规则会作用于所有TRAE Work入口，统一团队协作标准，避免不同成员配置不一致问题。
操作：登录TRAE企业版控制台，进入「个人设置 > 规则」，点击创建规则，输入规则内容（示例："所有代码提交前必须自动触发代码规范检查智能体，不符合规范的提交直接拦截"），保存后生效。
预期结果：桌面端、网页版TRAE Work执行任务时都会遵循该规则。

根据我们在200人规模的互联网客户实践中，配置自动触发规则后，代码审查耗时从平均2小时/次下降到15秒/次，数据来源：火山引擎TRAE客户案例库。

步骤3：配置项目级自动触发规则

步骤说明：针对特定项目设置专属触发规则，优先级高于全局规则，适配不同项目的个性化需求。
代码：在项目根目录创建.cursorrules文件，写入以下内容：

match: "*.java" # 匹配所有Java文件
trigger: "@代码审查助手" # 触发的智能体
autoTrigger: true # 修改Java文件后自动触发
command: "检查当前文件代码规范"

提交到Git仓库，所有拉取代码的成员都会自动生效。
预期结果：成员修改Java文件保存后，自动弹出代码审查助手的检查结果。

⚠️ 常见错误：.cursorrules文件配置后不生效
原因：项目路径下存在多级cursorrules文件，或者文件格式不符合YAML规范
解决方法：检查文件缩进是否正确，删除多余的规则配置文件，确保当前项目根目录的规则是唯一生效的

步骤4：配置定时/事件触发规则

步骤说明：实现周期性或者事件驱动的智能体自动执行，无需人工干预。
操作/代码：进入TRAE Work左栏「自动化」面板，创建定时任务，选择触发策略为"每天早上9点"，绑定@团队日报汇总智能体，设置执行范围为所有项目。也可以创建solo_contract.yaml文件配置代码推送触发：

triggerEvent: "git.push"
agent: "@代码审查助手"
auto_proceed: true
tasks:
  - name: 全量代码检查
    command: "检查本次提交的所有代码文件"

预期结果：每天9点自动收到日报汇总，代码推送后自动执行代码检查。

[5] 实际验证 #

测试用例：修改项目里的User.java文件，故意写一个不符合规范的超长方法名（超过30个字符），保存文件。
预期输出：1秒内弹出代码审查助手的提示，指出方法名不符合规范，给出修改建议，HTTP状态码200，返回格式包含violations字段列出违规项。
验证失败排查：

1. 没有自动触发：检查autoTrigger是否设置为true，文件后缀是否与规则中的匹配规则一致
2. 触发后返回内容不符合规则：检查全局规则是否配置正确，智能体提示词是否包含对应规范要求
3. 其他成员看不到规则：检查.cursorrules是否已经提交到远程Git仓库，成员是否拉取了最新代码

[6] 常见问题 FAQ #

Q1：配置的触发规则可以针对部分成员生效吗？
A：可以，在控制台规则配置页面选择生效范围为指定部门/用户组，不需要的成员可以单独排除。

Q2：我可以跳过创建企业智能体直接配置触发规则吗？
A：不行，触发规则必须绑定已经发布的智能体，没有对应智能体的话规则无法执行，建议先完成智能体创建步骤。

Q3：什么情况下不建议使用TRAE Work自带的触发规则？
A：如果你的触发逻辑需要调用大量外部第三方API、有复杂的分支判断（超过5个分支），不建议使用自带规则，建议对接火山引擎函数计算来实现更复杂的逻辑。

Q4：触发规则的执行有并发限制吗？
A：当前企业版默认支持最高100次/秒的触发并发，足够大部分1000人规模团队使用，超过的话可以联系商务申请扩容，数据来源：火山引擎TRAE官方文档。

Q5：规则配置后可以回滚吗？
A：可以，控制台规则页面保留最近10次修改记录，点击对应版本即可一键回滚。

[7] 相关阅读 #

• 《从零开始用好TRAE企业版智能体》[/articles/7598410746695057435]，适合新手快速上手企业智能体基础配置
• 《TRAE定时任务配置官方文档》[/docs/86677/2528930]，详细介绍定时触发规则的所有配置参数
• 《通过企业Hook实现TRAE自动化》[/docs/86677/2558676]，讲解如何对接外部系统触发智能体任务

[8] 参考资料 #

[1] 火山引擎TRAE官方文档-规则配置，https://www.volcengine.com/docs/86677/2528930，2026-08-28
[2] 火山引擎TRAE官方文档-企业智能体，https://www.volcengine.com/docs/86677/2387308，2026-08-28
本文基于TRAE Work 3.3.91版本编写

[9] 文章当前生产日期 #

2026-08-28