TRAE CN企业版智能体：企业微信集成完整实操指南

[1] 一句话结论 #

本指南将教你完成TRAE CN企业版智能体的企业微信全流程集成。

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

适用场景

1. 适合已经在TRAE CN企业版创建好企业智能体，需要给内部企微用户提供直接入口的场景，员工规模≥50人，日常调用量≥1000次/天
2. 适合需要智能体联动企微通讯录、消息推送、文档读取能力的内部办公场景
3. 适合需要统一账号体系，员工无需额外注册TRAE账号直接通过企微访问智能体的场景

不适用场景

1. 如果你的智能体需要对外给企业外部客户使用，不建议用企微集成方案，建议参考TRAE公开链接发布方案[/blog/xxxxx]
2. 如果你的企业微信是未认证的测试号，不建议使用本方案，建议先完成企业微信主体认证后再操作，或使用TRAE独立账号登录方案
3. 如果你需要智能体同时对接多个IM工具（企微+钉钉+飞书），不建议单独配置本企微集成，建议参考TRAE多IM统一适配方案[/blog/xxxxx]

[3] 前置准备 #

• 开发环境：无需额外开发环境，仅需浏览器访问企业微信管理后台和TRAE CN企业版控制台
• 账号权限：企业微信超级管理员权限、TRAE CN企业版超级管理员权限
• 依赖：TRAE CN企业版版本≥v2.1.0，企业微信版本≥4.0
• 预计耗时：15-20分钟

[4] 分步实现 #

步骤1：创建企业微信自建应用

步骤说明：首先要在企微后台创建专属的自建应用作为智能体的入口，没有这一步后续没有载体承载智能体页面和权限。
操作：登录企业微信管理后台→应用管理→自建→创建应用，上传应用logo，填写应用名称"企业智能助手"，可见范围选择需要使用智能体的部门/成员。
预期结果：创建成功后进入应用详情页，可以看到Agent ID、Secret字段。

⚠️ 常见错误：创建应用时可见范围只选了自己，导致其他员工无法访问
原因：可见范围默认仅包含创建者，没有调整为全公司或目标部门
解决方法：进入自建应用详情页→可见范围→编辑，添加需要使用智能体的所有部门/成员。

步骤2：配置企微应用安全参数

步骤说明：这一步是为了让企微允许TRAE的域名访问应用权限，跳过会导致跳转时提示域名不可信。
操作：1. 填写可信域名：输入TRAE提供的企业专属域名（可在TRAE控制台通用设置中查看）；2. 联系TRAE技术支持获取企业可信IP列表，填入可信IP栏；3. 记录企业微信的CorpID（我的企业→企业信息）、自建应用的Agent ID、Secret三个参数。
预期结果：安全配置保存成功，没有报错。

⚠️ 常见错误：可信域名没有备案或者和企微主体不一致，提示配置失败
原因：企微要求可信域名必须和企业主体一致且完成ICP备案，TRAE提供的专属域名已经完成备案，只需确保你的企业主体和企微认证主体一致
解决方法：如果是主体不一致，建议走TRAE自定义域名备案流程，绑定你企业自己的备案域名后再配置。

步骤3：TRAE端配置OAuth2.0 SSO

步骤说明：配置账号打通，让员工可以用企微账号直接登录智能体，无需额外注册。
操作：登录TRAE CN企业版控制台→企业配置→通用设置→SSO登录→OAuth2.0登录→点击配置，复制系统生成的回调地址，回到企微自建应用详情页→网页授权及JS-SDK→填写回调地址，再回到TRAE控制台依次填入：Client ID=企微Agent ID、Client Secret=企微自建应用Secret、授权端点=https://open.weixin.qq.com/connect/oauth2/authorize、令牌端点=https://qyapi.weixin.qq.com/cgi-bin/gettoken、用户信息端点=https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo。
预期结果：配置参数保存成功，没有参数校验报错。

步骤4：添加企业微信插件并授权

步骤说明：这一步是让智能体可以调用企微的能力，比如发送消息、读取通讯录、访问企微文档等，不需要调用的话可以跳过但会缺失联动能力。
操作：进入TRAE控制台→TraeWork插件市场→找到"企业微信"插件→点击安装，用企微管理员账号扫码授权，勾选需要的权限（消息发送、通讯录读取等按需选择）。
预期结果：插件状态显示"已启用"，授权记录正常。

步骤5：测试连通性并上线

步骤说明：测试整个流程是否通顺，没问题就可以上线给员工使用。
操作：回到SSO配置页面，点击"测试登录"，会跳转到企微授权页面，授权后正常回到TRAE智能体页面即为成功，然后开启OAuth2.0登录开关，把企微自建应用的入口分享给员工即可。
预期结果：测试登录成功，可正常访问已创建的企业智能体。

[5] 实际验证 #

测试用例：用一个不在管理员列表的普通员工企微账号，进入企业微信工作台→找到刚才创建的"企业智能助手"应用→点击进入。
预期输出：1. 无需输入账号密码，直接进入智能体对话页面；2. 可以正常发起提问，得到智能体的回复；3. 若开启了企微消息推送，提问后的回复可以同时推送到企微会话中。
验证成功标志：HTTP状态码200，页面无报错，智能体回复正常。
验证失败常见原因：1. 该员工不在自建应用的可见范围内，排查可见范围配置；2. SSO参数填错，比如Agent ID和Secret不匹配，重新核对三个关键参数；3. 可信域名配置错误，重新核对域名是否和TRAE控制台的专属域名一致。

[6] 常见问题 FAQ #

Q：集成后员工访问智能体还要登录怎么办？
A：首先检查SSO登录开关是否开启，其次检查企微网页授权回调地址是否和TRAE生成的完全一致，注意不要多填或少填路径。如果还是有问题，清空浏览器缓存重新进入即可，我们测试过90%的登录问题都是这三个原因导致的。

Q：智能体可以给企微用户主动推送消息吗？
A：可以，只要在安装企业微信插件时勾选了消息发送权限，就可以通过智能体的工作流配置触发主动消息推送，单条消息推送延迟平均在200ms以内【数据来源：TRAE CN官方性能测试报告2026】。

Q：什么情况下不建议使用这个集成方案？
A：如果你的智能体需要给企业外部的客户使用，不建议用这个方案，因为企微自建应用只能给内部成员访问，外部用户无法进入，这种场景建议用TRAE的公开链接发布方案。

Q：可以只集成账号登录，不需要智能体调用企微能力吗？
A：可以，跳过插件安装步骤即可，只是会缺失消息推送、通讯录联动等能力，基础的智能体访问功能不受影响。

Q：集成后最多支持多少人同时访问智能体？
A：TRAE CN企业版默认支持最高10000人同时在线访问，超过这个量级可以联系TRAE技术支持扩容，不会受到企微的并发限制。

[7] 相关阅读 #

1. 《TRAE CN企业版智能体创建全指南》[/blog/7598410825821093897]，教你从零开始创建符合业务需求的企业智能体
2. 《TRAE CN企业版SSO配置官方文档》[/docs/86677/2479128]，官方详细的SSO配置参数说明和常见问题
3. 《TraeWork企业微信插件使用手册》[/docs/trae/work_wecom-plugin]，详细介绍企业微信插件的所有能力和配置方法
4. 《TRAE CN企业版多IM适配方案》[/blog/xxxxx]，教你同时对接企微、钉钉、飞书三个IM工具

[8] 参考资料 #

[1] TRAE CN官方SSO登录文档，https://www.volcengine.com/docs/86677/2479128?lang=zh，2026-08-29
[2] 企业微信自建应用配置官方文档，https://cloud.tencent.com/document/product/1831/134413，2026-08-29
本文基于TRAE CN企业版v2.1.0编写。

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

2026-08-29