钉钉工作台接入 AI 助手：管理员配置与员工使用
将九宸 AI 助手放进企业钉钉工作台，员工点击应用后核验本人的企业身份，进入指定助手提问。本文适用于已开通企业工作台免登的组织；配置由钉钉企业管理员和九宸平台管理员共同完成。
配置前准备：九宸平台已有公网 HTTPS 地址；员工已同步或绑定平台账号；准备好可供企业员工使用的助手，并确认员工账号状态、手机号和算力额度。
一、在钉钉创建企业内部网页应用
- 管理员登录钉钉开发者后台，选择目标企业，进入企业内部应用。
- 创建或选用一个企业内部应用，进入“应用能力”，添加“网页应用”。应用名称可设为企业易识别的 AI 工作台名称。
- 记录同一应用的 Client ID（AppKey）、Client Secret（AppSecret）、AgentId 和企业 CorpId，供下一步填写。密钥只在平台配置中保存，不发送给员工，不放进工作台网址。
- 按当前钉钉接口要求开通员工免登所需权限；如需同步通讯录，先完成本栏目中的“钉钉应用授权与九宸渠道配置”和“预览、执行与核对钉钉通讯录同步”。应用可见范围与通讯录接口授权范围需要分别核对。
二、在九宸平台配置应用渠道
- 管理员打开已开通工作台配置功能的平台后台，进入“基础平台 → 系统管理 → 消息推送 → 渠道配置”。
- 新增钉钉企业应用渠道，选择“钉钉工作通知”类型，填写同一企业应用的 AppKey、AppSecret、AgentId 与 CorpId，启用后保存。群机器人渠道不能代替企业应用免登。
- 建议为工作台免登单独建立渠道，按组织配置将其设为仅用于登录，避免它同时参与默认通知推送。
- 检查员工来源映射。已有账号需要绑定到对应员工本人；不能仅凭姓名相同就替换账号，不要将员工全部绑定到管理员账号。
三、选择默认助手并生成工作台链接
- 进入“智能体管理”，选择员工点击工作台后默认使用的助手。
- 由助手创建者将可见范围设为“企业共享”。如果原助手没有编辑权限，创建自己的副本后配置；不要修改无权管理的系统助手。
- 打开该助手的分享设置，启用分享，并开启企业工作台免登及员工身份验证，关联上一步配置的钉钉渠道。工作台渠道要求助手为企业共享；“指定成员”模式不能直接当作企业共享入口。
- 保存后复制该渠道对应的工作台地址。不要只复制普通分享链接；链接应指向企业登录入口，并携带本组织的渠道和助手参数。
链接结构示例（不要原样照抄示例参数）：
https://<平台域名>/9c/dingtalk/?corpid=$CORPID$#/enterprise-login?channel_id=<渠道ID>&agent_id=<助手ID>
以平台生成的实际地址为准。corpid=$CORPID$须保留占位符原样；渠道 ID 和助手 ID 必须属于本组织。测试环境与正式环境地址不同，正式发布时应使用已验收的正式地址。
四、填写钉钉 PC 和移动端首页
- 回到钉钉应用，进入“网页应用”，编辑配置。
- 同时启用 PC 端与移动端，把同一个已生成的工作台地址分别填写到两个首页地址中并保存。
- 确认链接可通过公网 HTTPS 访问，且链接所属企业与应用 CorpId 一致。
五、发布版本并设置可见范围
- 进入“版本管理与发布”，创建新版本，填写递增的版本号和清楚的版本说明。
- 先以“仅我可见”或指定验收人员完成免登、实际问答、历史恢复及 PC/手机验证。
- 确认服务和权限正常后，按企业决策选择全体员工或指定范围，再发布版本。仅修改首页但未发布版本，不代表员工端已经生效。
- 发布后确认版本状态为“已上线”，并用目标员工账号从钉钉工作台实际打开。
六、员工从工作台提问
- 打开手机或电脑钉钉，在目标企业的工作台点击 AI 应用。
- 已有有效绑定的员工按组织安全策略登录；如要求短信验证，由员工本人完成验证。
- 首次使用的同步账号若需要设置密码，按页面提示使用本人已绑定手机号验证并设置密码；未绑定手机号或资料不符时，联系管理员核对，不要借用他人账号。
- 进入助手后输入工作问题，确认得到完整回复。之后可从历史列表打开原会话；超过自动续聊时间时，页面可能先显示新对话，请在历史中选择原会话。
七、算力与常见问题
- 组织有余额，但员工提示余额不足：先检查组织算力模式。“成员分配”模式使用各账号已分配额度；组织池充足不等于每个员工都有可用额度。管理员可按需要分配，不必先重复充值；是否改为组织共享应由企业统一决定。
- 工作台找不到应用：核对当前企业、应用版本是否上线及可见范围；“仅我可见”不会自动开放给全体员工。
- 提示从钉钉打开：应从钉钉工作台进入，不要用普通浏览器直接代替钉钉免登。
- 提示身份绑定冲突：核对员工来源和平台账号归属，交由管理员处理，不能为解决提示而扩大管理员权限或覆盖他人绑定。
- 重新打开后看到历史 JSON：确认平台已包含图文历史显示修复，更新后从历史列表重开原会话；正常界面应只显示附件、用户原文和助手回答。
- 员工权限被撤销或账号停用：应按平台提示联系管理员核实；工作台可见并不替代账号、租户和助手权限校验。
首次面向员工开放前，建议核对：PC与手机入口、员工身份、安全验证、算力额度、真实问答、刷新与历史恢复。不要将“应用已上线”或“页面能打开”单独视为全部验收通过。