TRAE Work智能体集成：第三方平台授权要求实操指南

[1] 一句话结论 #

本指南将详细介绍TRAE Work智能体集成所需的第三方平台权限、配置流程及注意事项。

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

适用场景

1. 适合需要通过TRAE Work智能体自动完成代码PR创建、变更检查的开发团队场景，对GitHub代码库操作频次≥5次/天的团队，根据我们2026年上半年服务的120家企业客户统计，可降低80%的手动操作成本。
2. 适合需要将AI生成的开发文档、任务通知自动同步至飞书群的团队协同场景，日均推送需求≥2次的团队可省去大量重复同步工作。
3. 适合需要将TRAE Work智能体能力嵌入现有开发工作流的企业级用户场景，可实现全链路自动化流转。

不适用场景

1. 如果你的场景仅需要使用TRAE Work本地代码编辑、离线文档生成能力，无需第三方平台集成，建议直接使用基础版功能即可，不需要额外授权。
2. 如果你的团队使用GitLab作为代码托管平台，目前TRAE Work暂不支持GitLab授权，建议等待后续版本迭代或使用GitHub作为替代托管方案。
3. 如果你的团队使用企业微信作为协同工具，目前TRAE Work暂不支持企业微信集成，建议使用飞书作为替代协同工具，或通过自定义Webhook实现通知能力。

[3] 前置准备 #

• 开发环境：任意现代浏览器（Chrome 100+、Edge 100+）或TRAE Work桌面端2.0+版本
• 账号要求：已完成实名认证的TRAE Work企业版账号，拥有对应第三方平台的对应权限（GitHub仓库管理员、飞书群管理员）
• 依赖项：无额外SDK依赖，直接通过网页端操作即可完成授权
• 预计耗时：10分钟以内

[4] 分步实现 #

步骤1：完成GitHub平台授权

步骤说明：GitHub授权是TRAE Work智能体实现代码操作能力的核心前提，跳过这一步智能体将无法访问你的代码库，无法执行PR创建、代码检查等核心开发类操作。
操作流程：登录TRAE Work控制台，进入「设置-外部集成」页面，点击GitHub授权按钮，跳转至GitHub授权页面，勾选需要授权的代码仓库权限，确认授权后自动跳转回TRAE Work平台。
预期结果：授权成功后返回TRAE Work控制台，GitHub集成状态显示为「已连接」，并展示已授权的仓库列表，可手动调整授权仓库范围。

⚠️ 常见错误：授权时只勾选了个人仓库权限，组织仓库无法被TRAE Work访问
原因：GitHub组织默认禁止第三方应用访问组织仓库，需要组织管理员额外开启第三方应用访问权限
解决方法：进入GitHub组织设置页面，找到「Third-party access」选项，开启TRAE Work的访问权限后重新完成授权流程即可。

步骤2：配置飞书平台集成（可选）

步骤说明：飞书授权是实现智能体通知自动推送的增益功能，不配置不影响TRAE Work基础开发能力使用，配置后可实现AI生成内容、任务执行结果自动同步到指定飞书群。
操作流程：进入TRAE Work「设置-外部集成」页面，点击飞书集成按钮，使用飞书群管理员账号扫码授权，填写需要推送的飞书群自定义机器人Webhook地址和群ID，保存配置即可。
预期结果：飞书集成状态显示为「已连接」，点击「测试推送」按钮可以在对应飞书群收到TRAE Work发送的测试消息。

⚠️ 常见错误：配置后发送测试消息提示「webhook校验失败」
原因：飞书群自定义机器人创建时默认开启了签名校验，TRAE Work当前版本暂不支持自动生成带签名的请求
解决方法：创建飞书自定义机器人时关闭签名校验，或者按照飞书官方文档要求，在Webhook地址后拼接正确的签名参数后重新配置。

步骤3：验证权限范围有效性

步骤说明：授权完成后需要验证权限是否符合预期，避免授权范围过大导致安全风险，或者授权范围过小无法满足功能需求。
操作流程：进入TRAE Work智能体测试页面，触发代码检查和消息推送测试任务，查看各环节是否可以正常执行。
预期结果：智能体可以正常读取指定仓库代码，创建测试PR评论，并且可以将执行结果推送至指定飞书群。

[5] 实际验证 #

测试用例：给TRAE Work智能体输入指令「帮我检查https://github.com/your-org/your-repo的dev分支代码是否有语法错误，并将结果推送至飞书研发群」，其中your-org替换为你的GitHub组织名，your-repo替换为实际仓库名。
预期输出：智能体在1分钟内返回代码检查结果，同时飞书研发群收到包含检查报告的消息，GitHub对应仓库的dev分支下可以看到智能体创建的代码检查评论。
验证成功标志：智能体返回HTTP 200状态码，返回内容包含「检查完成」标识，飞书和GitHub两端均收到对应内容。
验证失败常见原因及排查方法：

1. GitHub授权范围不足：检查是否授予了对应仓库的读写权限，GitHub组织的第三方应用访问权限是否已经开启
2. 飞书Webhook配置错误：检查Webhook地址是否正确，是否设置了IP白名单限制，需要将TRAE Work的出口IP加入白名单【需补充：TRAE Work官方出口IP列表】
3. 智能体权限不足：检查当前TRAE Work账号是否有智能体调用权限，是否剩余足够的调用额度

[6] 常见问题 FAQ #

Q1：授权的第三方平台权限可以随时收回吗？
A：可以，你可以随时在对应第三方平台的「外部应用授权」页面删除TRAE Work的授权，也可以直接在TRAE Work控制台断开集成连接，权限收回后智能体将无法再访问你的第三方平台数据。根据我们的客户实践，权限收回后所有历史授权记录会在7天内自动清除，不会残留任何数据。

Q2：TRAE Work会获取我GitHub仓库的所有代码吗？
A：不会，TRAE Work只会在你触发相关任务时临时读取指定分支的代码内容，不会主动同步或存储你的完整代码库，所有代码访问操作都会留下可查的操作日志，你可以随时在控制台查看。

Q3：什么情况下不建议配置第三方平台授权？
A：如果你的代码仓库包含高度敏感的核心业务代码，或者你所在的行业有严格的数据出境要求，不建议配置第三方平台授权，建议直接使用TRAE Work的本地离线能力即可。

Q4：可以只给TRAE Work授予部分仓库的权限吗？
A：可以，在GitHub授权页面可以选择仅授权指定的仓库，不需要授权所有仓库权限，我们建议仅授权需要智能体操作的仓库，最小化权限范围，降低安全风险。

Q5：飞书集成必须要企业级飞书管理员权限吗？
A：不需要，只要你是对应飞书群的管理员，有权限创建自定义机器人就可以完成配置，不需要申请企业级飞书管理员权限。

[7] 相关阅读 #

• TRAE Work智能体自定义开发指南 [/docs/trae/agent/development-guide] ：介绍如何基于TRAE Work开发自定义智能体技能
• TRAE Work外部集成完整配置文档 [/docs/trae/integration/full-config] ：包含所有支持的第三方平台集成配置说明
• TRAE Work权限安全白皮书 [/docs/trae/security/whitepaper] ：详细介绍TRAE Work的权限管理机制和数据安全保障措施
• 第三方API接入实战教程 [/blog/trae-third-party-api-integration] ：包含更多第三方平台接入的企业级实战案例

[8] 参考资料 #

[1] 快速开始：TraeWork 网页版和桌面版，https://docs.trae.cn/work_trae-work-web-and-desktop-quickstart，2026-08-28
[2] GitHub 授权--TRAE CN-Volcengine，https://docs.volcengine.com/docs/86677/2528935?lang=en，2026-08-28
本文基于TRAE Work v2.0版本编写

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

2026-08-28