为了确保告警和调度通知能精准@到负责人，DataWorks AI助理提供了账号映射功能。该功能通过建立阿里云账号与钉钉、飞书等IM平台账号的关联，解决了跨平台身份不统一的问题，将消息中原本的“纯文本名字”升级为可交互的@mention。本文将指导您通过【通道配置】完成账号映射的设置与测试。
实现原理
AI助理通过统一的账号映射机制，实现通知对象的精准触达。无论是任务责任人还是轮值人员，系统都会将其身份标识解析为对应的IM账号，从而省去了为不同场景重复配置的麻烦。
同时，对于轮值场景，AI助理会自动关联您在DataWorks运维中心维护的【运维值班表】，实现通知对象的自动轮转。
所有轮值人员都必须预先完成账号映射登记，这是确保他们能被机器人@到的前提。
使用前提
已参照 使用AI助理服务 创建 AI 助理实例，且实例处于运行中状态。
实例镜像版本为 4.1.6 及以上。低于该版本时，通道卡片上不会出现 账号映射 入口，需先升级实例。
已通过实例 基本信息 页签的 通道配置 完成至少一个 IM 通道的接入，接入方式分别见 AI 助理服务集成钉钉、AI 助理服务集成飞书 和 AI 助理服务集成企业微信。
已有定时巡检或告警任务在运行。@ 到人发生在通知环节，需要先有报告产生，任务的配置方式见 AI 助理实战：通过自然语言实现智能数据运维 。
使用限制
按通道独立配置：账号映射是按IM通道独立配置的，并非全局共享。您从哪个IM通道（如钉钉）的配置入口进入，就只能维护该通道的身份标识。这意味着，您需要为成员在每个希望接收
@通知的通道中分别配置映射。例如：仅为某成员配置了钉钉映射，那么在飞书群组中将无法成功
@到该用户。飞书与Lark的统一配置：飞书与Lark在同一个通道卡片中进行配置，并共用同一身份标识字段（用户Open ID / User ID）。
手机号的维护与显示：为保护隐私，系统将始终以掩码形式（如
138****1111）展示手机号。保留原号：编辑时，保持掩码不变即可。
更换号码：请直接输入完整的新手机号码覆盖掩码。
如需使用值班表作为通知对象，需要先在运维中心配置值班表，此功能需要DataWorks的版本为专业版以上。
配置步骤
步骤一：进入目标通道的账号映射
登录 DataWorks 控制台，在左侧导航栏单击 AI 助理服务。
在实例列表找到目标实例，单击实例名称进入实例详情页。
在通道配置卡片区域找到目标通道卡片（钉钉、企业微信 或 飞书 / Lark），并配置相应的通道配置。
完成相应的通道配置后，单击卡片右上角的 账号映射。
步骤二：新增账号映射
在 账号映射 面板左上角单击 新增映射。
配置 新增映射 对话框的以下参数，然后单击 确定。
参数
是否必填
默认值
说明
成员
是
无
搜索并选择该责任人对应的 RAM 用户或角色，下拉列表中会标注 用户 或 角色。选中后自动带出该成员的昵称、账户名与账号 ID，并作为这条映射的主键。
手机号
否
空
该成员在本通道登记的手机号，作为按手机号 @ 的通用标识。列表始终以掩码展示；编辑时保持掩码不变即保留原号码，需要更换时输入完整的新号码。
通道 @ 标识
否
空
该成员在本通道的平台身份标识，字段名称随通道变化：
钉钉为 钉钉用户 ID，可在个人详情页获取。
企业微信为 企微账号，需要企微管理员在组织架构中，在用户详情页获取。
飞书 / Lark 为 飞书用户 Open ID / User ID，可填以
ou_开头的 Open ID 或 User ID，获取方式参见如何获取不同用户的ID。
启用映射
否
开启
默认开启。关闭后这条映射不再生效，适合临时停用某位成员的 @，无需删除记录。
保存成功后列表刷新并出现该成员。如果实例还接入了其他通道，返回 通道配置，在其他通道卡片上为同一成员重复上述操作。
界面只强制要求选择成员，手机号与通道 @ 标识都不填也能保存。两者都为空时，这条映射在当前通道上没有可用的 @ 标识，建议至少填写一项，并优先填写通道 @ 标识——它不会因为成员更换手机号而失效。
步骤三：发送测试消息验证
您可以通过发送单条测试消息，来验证特定成员的账号映射配置是否生效。
启动测试
在“账号映射”列表中找到目标成员，单击其操作列的【测试】按钮。
提示：如果该成员在当前通道的映射信息（@标识或手机号）为空，系统将阻止测试并提示您先补齐信息。
配置并发送
在弹出的对话框中，粘贴目标群机器人的
Webhook地址，然后点击“提交”。重要企业微信和飞书的智能机器人不支持Webhook，您可以在群聊中添加一个Webhook机器人来测试@消息的发送。
同一个机器人若在多个群内，其Webhook地址各不相同。测试推送时，请确保选择了正确的群聊地址，以免消息错发。
系统将向该群正式发送一条测试消息，群内所有成员均会看到。为避免干扰，建议提前告知群内相关人员。
验证结果
前往对应的IM群聊，检查测试消息：
成功：成员被成功
@（姓名显示为可点击的蓝色链接）。失败：成员姓名仅为纯文本，无法点击。
故障排查
如果测试失败（未成功
@到人），请逐一核对以下配置，修正后重新测试：启用状态：确保在映射列表中，该成员的【启用映射】开关已打开。
身份信息：确保该成员在当前测试的通道中，【通道@标识】或【手机号】至少填写了其中一项。
标识准确性：仔细检查填写的
@标识（如钉钉用户ID）是否完全正确，无拼写错误或多余空格。Webhook有效性：确认您用于测试的
Webhook地址准确无误，且该机器人已被正确添加到目标群聊中。
管理已有映射
账号映射 面板的列表中，每条映射的操作列提供以下操作。
操作 | 说明 |
测试 | 向手动填写的群机器人 Webhook 正式发送一条 @ 该成员的测试消息，用于验证映射是否生效。 |
禁用 / 启用 | 临时停用或恢复这条映射。已启用的映射显示 禁用，已禁用的映射显示 启用，切换只影响这一条记录的生效状态，不改动其他信息。 |
编辑 | 修改手机号、通道 @ 标识和 启用映射 开关。成员不可修改；手机号显示为掩码时，不改动即保留原号码。 |
删除 | 确认对话框中确认后，删除该成员在当前通道下的映射，其他通道的映射不受影响。 |
责任人离职或换人时，编辑对应映射的通道 @ 标识与手机号，或直接关闭 启用映射 开关即可，不需要改动巡检与告警任务本身。团队成员变动后，用操作列的 测试 验证一次，确认仍能真正 @ 到人。
1. 责任人
这是最核心的通知对象，系统通过智能分析来确定具体责任人。
动态责任人 （默认行为）
逻辑：AI助理在每轮巡检时，会实时分析出问题的具体资源（如某个表、某个任务），并自动
@该资源的负责人。优点：无需预先登记，智能化、自动化、精准触达。本轮无异常则不打扰任何人。
适用场景：绝大多数常规告警场景。
固定责任人（兜底）
逻辑：您可以在巡检任务中通过AI助理指定一个或多个固定成员。无论哪轮巡检、哪个资源出问题，系统都会
@这些固定成员。适用场景：作为告警的最终兜底，确保总有人收到通知，例如通知团队负责人或群主。
2. 值班人
您可以在配置定时任务时，告知AI助理使用值班表作为通知对象，系统会引入值班体系。
逻辑：AI助理会自动读取并关联您在 DataWorks运维中心 中维护的原生值班表，获取当日的“主值班人”和“备值班人”进行
@。优点：通知对象随排班自动轮转，无需在AI助理侧重复配置。
显示：在告警报告中，“责任人”与“值班人”会分两行带标签清晰列出。
3. 创建人
当监控的资源对象不存在责任人时，DataWorks将指定创建人作为通知对象，作为兜底策略。以Flink举例：
针对 Flink 作业监控：当责任人映射未登记某作业时,AI 助理自动查询该作业的创建人来 @,报告标注「（按创建者））」。
优先级：① 责任人映射 > ② 作业创建人 > ③ 默认兜底人。您需要将相关干系人配置在账号映射中，保证AI助理服务可以精准@到人。
查不到创建人（如无该作业读取权限）时，归入默认兜底人/纯文本点名，注明「未取到创建者」。
说明:Flink 监控与创建人自动 @ 能力,需先启用 Flink 专家套件。
映射不全时的兜底行为
账号映射不全或有歧义时，系统会降级为纯文本点名，不会误 @ 到错的人：
情况 | 表现 |
成员未在映射表 | 群内显示「@张三（未配置账号映射）」纯文本,不真 @ |
映射被禁用 | 视同未配置,降级纯文本 |
同名/信息冲突（如同一人多条记录填了不同手机号） | 降级纯文本,避免 @ 错人 |
说明:报告中出现「（未配置账号映射)」即提示您补齐该条映射。责任人离职/换人时,修改该条映射的成员或通道 ID,或直接关闭「启用映射」开关即可,无需改动任务。
平台差异说明
钉钉
必须提供群的 Webhook 地址才能实现 @ 通知。
机器人被添加到不同群时，会生成各自独立的 Webhook 地址。
配置定时任务时需要手动填入对应群的 Webhook 地址，系统无法自动获取。
飞书
应用机器人通过群 ID 即可向指定群发送带 @ 的消息，不需要 Webhook 地址。
指定群后即可直接 @ 群成员并触发通知。
企业微信
企业微信有两类机器人，能力完全不同：
对话机器人：用于交互式对话，支持两种连接模式。
长链接模式：能主动向指定群发送 @ 消息并触发通知，不需要 Webhook 地址。
URL 回调模式：不能主动向指定群发送 @ 消息。
两种模式都不具备 Webhook 能力。
消息推送机器人（Webhook 专用）：通过 Webhook 地址单向推送消息，能 @ 人。
若需要通过 Webhook 发送 @ 通知，需要在群内单独创建此类机器人。
配置建议
平台 | 配置时需要提供 |
钉钉 | 目标群的 Webhook 地址。 |
飞书 | 指定目标群即可。如需测试@功能，需要额外创建Webhook机器人。 |
企业微信 | 指定目标群即可（需确认对话机器人使用的是长链接模式，非 URL 回调模式），如需测试@功能，需要额外创建Webhook机器人。 |
常见问题
Q：一位成员需要在每个通道都配置吗？
A：需要。账号映射按通道分别维护，钉钉那条填钉钉用户 ID，飞书那条填 Open ID 或手机号，企业微信那条填企微账号。
Q：修改了成员的手机号，映射会自动更新吗？
A：不会。手机号与通道 @ 标识都需手动登记到映射，成员的联系方式变动后需要手动编辑对应映射。为减少这类维护，建议优先填写通道 @ 标识。