為了確保警示和調度通知能精準@到負責人，DataWorks AI助理提供了帳號映射功能。該功能通過建立阿里雲帳號與DingTalk、飛書等IM平台帳號的關聯，解決了跨平台身份不統一的問題，將訊息中原本的“純文字名字”升級為可互動的@mention。本文將指導您通過【通道配置】完成帳號映射的設定與測試。
實現原理
AI助理通過統一的帳號映射機制，實現通知對象的精準觸達。無論是任務責任人還是輪值人員，系統都會將其身份標識解析為對應的IM帳號，從而省去了為不同情境重複配置的麻煩。
同時，對於輪值情境，AI助理會自動關聯您在DataWorks營運中心維護的【營運值班表】，實現通知對象的自動輪轉。
所有輪值人員都必須預先完成帳號映射登記，這是確保他們能被機器人@到的前提。
使用前提
已參照 使用AI助理服務 建立 AI 助理執行個體，且執行個體處於運行中狀態。
執行個體鏡像版本為 4.1.6 及以上。低於該版本時，通道卡片上不會出現 帳號映射 入口，需先升級執行個體。
已通過執行個體 基本資料 頁簽的 通道配置 完成至少一個 IM 通道的接入，接入方式分別見 AI 助理服務整合DingTalk、AI 助理服務整合飛書 和 AI 助理服務整合企業微信。
已有定時巡檢或警示任務在運行。@ 到人發生在通知環節，需要先有報告產生，任務的配置方式見 AI 助理實戰：通過自然語言實現智能資料營運 。
使用限制
按通道獨立配置：帳號映射是按IM通道獨立配置的，並非全域共用。您從哪個IM通道（如DingTalk）的配置入口進入，就只能維護該通道的身份標識。這意味著，您需要為成員在每個希望接收
@通知的通道中分別配置映射。例如：僅為某成員配置了DingTalk映射，那麼在飛書群組中將無法成功
@到該使用者。飛書與Lark的統一配置：飛書與Lark在同一個通道卡片中進行配置，並共用同一身份識別欄位（使用者Open ID / User ID）。
手機號的維護與顯示：為保護隱私，系統將始終以掩碼形式（如
138****1111）展示手機號。保留原號：編輯時，保持掩碼不變即可。
更換號碼：請直接輸入完整的新手機號碼覆蓋掩碼。
如需使用值班表作為通知對象，需要先在營運中心配置值班表，此功能需要DataWorks的版本為專業版以上。
配置步驟
步驟一：進入目標通道的帳號映射
登入 DataWorks 控制台，在左側導覽列單擊 AI 助理服務。
在執行個體列表找到目標執行個體，單擊執行個體名稱進入執行個體詳情頁。
在通道配置卡片地區找到目標通道卡片（DingTalk、企業微信 或 飛書 / Lark），並配置相應的通道配置。
完成相應的通道配置後，單擊卡片右上方的 帳號映射。
步驟二：新增帳號映射
在 帳號映射 面板左上方單擊 新增映射。
配置 新增映射 對話方塊的以下參數，然後單擊 確定。
參數
是否必填
預設值
說明
成員
是
無
搜尋並選擇該責任人對應的 RAM 使用者或角色，下拉式清單中會標註 使用者 或 角色。選中後自動帶出該成員的暱稱、賬戶名與帳號 ID，並作為這條映射的主鍵。
手機號
否
空
該成員在本通道登記的手機號，作為按手機號 @ 的通用標識。列表始終以掩碼展示；編輯時保持掩碼不變即保留原號碼，需要更換時輸入完整的新號碼。
通道 @ 標識
否
空
該成員在本通道的平台身份標識，欄位名稱隨通道變化：
DingTalk為 DingTalk使用者識別碼，可在個人詳情頁擷取。
企業微信為 企微帳號，需要企微管理員在組織架構中，在使用者詳情頁擷取。
飛書 / Lark 為 飛書使用者 Open ID / User ID，可填以
ou_開頭的 Open ID 或 User ID，擷取方式參見如何擷取不同使用者的ID。
啟用映射
否
開啟
預設開啟。關閉後這條映射不再生效，適合臨時停用某位成員的 @，無需刪除記錄。
儲存成功後列表重新整理並出現該成員。如果執行個體還接入了其他通道，返回 通道配置，在其他通道卡片上為同一成員重複上述操作。
介面只強制要求選擇成員，手機號與通道 @ 標識都不填也能儲存。兩者都為空白時，這條映射在當前通道上沒有可用的 @ 標識，建議至少填寫一項，並優先填寫通道 @ 標識——它不會因為成員更換手機號而失效。
步驟三：發送測試訊息驗證
您可以通過發送單條測試訊息，來驗證特定成員的帳號映射配置是否生效。
啟動測試
在“帳號映射”列表中找到目標成員，單擊其操作列的【測試】按鈕。
提示：如果該成員在當前通道的映射資訊（@標識或手機號）為空白，系統將阻止測試並提示您先補齊資訊。
配置並發送
在彈出的對話方塊中，粘貼目標群機器人的
Webhook地址，然後點擊“提交”。重要企業微信和飛書的智能機器人不支援Webhook，您可以在群聊中添加一個Webhook機器人來測試@訊息的發送。
同一個機器人若在多個群內，其Webhook地址各不相同。測試推送時，請確保選擇了正確的群聊地址，以免訊息錯發。
系統將向該群正式發送一條測試訊息，群內所有成員均會看到。為避免幹擾，建議提前告知群內相關人員。
驗證結果
前往對應的IM群聊，檢查測試訊息：
成功：成員被成功
@（姓名顯示為可點擊的藍色連結）。失敗：成員姓名僅為純文字，無法點擊。
故障排查
如果測試失敗（未成功
@到人），請逐一核對以下配置，修正後重新測試：啟用狀態：確保在映射列表中，該成員的【啟用映射】開關已開啟。
身份資訊：確保該成員在當前測試的通道中，【通道@標識】或【手機號】至少填寫了其中一項。
標識準確性：仔細檢查填寫的
@標識（如DingTalk使用者ID）是否完全正確，無拼字錯誤或多餘空格。Webhook有效性：確認您用於測試的
Webhook地址準確無誤，且該機器人已被正確添加到目標群聊中。
管理已有映射
帳號映射 面板的列表中，每條映射的操作列提供以下操作。
操作 | 說明 |
測試 | 向手動填寫的群機器人 Webhook 正式發送一條 @ 該成員的測試訊息，用於驗證映射是否生效。 |
禁用 / 啟用 | 臨時停用或恢複這條映射。已啟用的映射顯示 禁用，已禁用的映射顯示 啟用，切換隻影響這一條記錄的生效狀態，不改動其他資訊。 |
編輯 | 修改手機號、通道 @ 標識和 啟用映射 開關。成員不可修改；手機號顯示為掩碼時，不改動即保留原號碼。 |
刪除 | 確認對話方塊中確認後，刪除該成員在當前通道下的映射，其他通道的映射不受影響。 |
責任人離職或換人時，編輯對應映射的通道 @ 標識與手機號，或直接關閉 啟用映射 開關即可，不需要改動巡檢與警示任務本身。團隊成員變動後，用操作列的 測試 驗證一次，確認仍能真正 @ 到人。
1. 責任人
這是最核心的通知對象，系統通過智能分析來確定具體責任人。
動態責任人 （預設行為）
邏輯：AI助理在每輪巡檢時，會即時分析出問題的具體資源（如某個表、某個任務），並自動
@該資源的負責人。優點：無需預先登記，智能化、自動化、精準觸達。本輪無異常則不打擾任何人。
適用情境：絕大多數常規警示情境。
固定責任人（兜底）
邏輯：您可以在巡檢任務中通過AI助理指定一個或多個固定成員。無論哪輪巡檢、哪個資源出問題，系統都會
@這些固定成員。適用情境：作為警示的最終兜底，確保總有人收到通知，例如通知團隊負責人或群主。
2. 值班人
您可以在配置定時任務時，告知AI助理使用值班表作為通知對象，系統會引入值班體系。
邏輯：AI助理會自動讀取並關聯您在 DataWorks營運中心 中維護的原生值班表，擷取當日的“主值班人”和“備值班人”進行
@。優點：通知對象隨排班自動輪轉，無需在AI助理側重複配置。
顯示：在警示報告中，“責任人”與“值班人”會分兩行帶標籤清晰列出。
3. 建立人
當監控的資來源物件不存在責任人時，DataWorks將指定建立人作為通知對象，作為兜底策略。以Flink舉例：
針對 Flink 作業監控：當責任人映射未登記某作業時,AI 助理自動查詢該作業的建立人來 @,報告標註「（按建立者））」。
優先順序：① 責任人映射 > ② 作業建立人 > ③ 預設兜底人。您需要將相關干係人配置在帳號映射中，保證AI助理服務可以精準@到人。
查不到建立人（如無該作業讀取許可權）時，歸入預設兜底人/純文字點名，註明「未取到建立者」。
說明:Flink 監控與建立人自動 @ 能力,需先啟用 Flink 專家套件。
映射不全時的兜底行為
帳號映射不全或有歧義時，系統會降級為純文字點名，不會誤 @ 到錯的人：
情況 | 表現 |
成員未在映射表 | 群內顯示「@張三（未配置帳號映射）」純文字,不真 @ |
映射被禁用 | 視同未配置,降級純文字 |
同名/資訊衝突（如同一人多條記錄填了不同手機號） | 降級純文字,避免 @ 錯人 |
說明:報告中出現「（未配置帳號映射)」即提示您補齊該條映射。責任人離職/換人時,修改該條映射的成員或通道 ID,或直接關閉「啟用映射」開關即可,無需改動任務。
平台差異說明
DingTalk
必須提供群的 Webhook 地址才能實現 @ 通知。
機器人被添加到不同群時，會產生各自獨立的 Webhook 地址。
配置定時任務時需要手動填入對應群的 Webhook 地址，系統無法自動擷取。
飛書
應用機器人通過群 ID 即可向指定群發送帶 @ 的訊息，不需要 Webhook 地址。
指定群後即可直接 @ 群成員並觸發通知。
企業微信
企業微信有兩類機器人，能力完全不同：
對話機器人：用於互動式對話，支援兩種串連模式。
長連結模式：能主動向指定群發送 @ 訊息並觸發通知，不需要 Webhook 地址。
URL 回調模式：不能主動向指定群發送 @ 訊息。
兩種模式都不具備 Webhook 能力。
訊息推送機器人（Webhook 專用）：通過 Webhook 地址單向推送訊息，能 @ 人。
若需要通過 Webhook 發送 @ 通知，需要在群內單獨建立此類機器人。
配置建議
平台 | 配置時需要提供 |
DingTalk | 目標群的 Webhook 地址。 |
飛書 | 指定目標群即可。如需測試@功能，需要額外建立Webhook機器人。 |
企業微信 | 指定目標群即可（需確認對話機器人使用的是長連結模式，非 URL 回調模式），如需測試@功能，需要額外建立Webhook機器人。 |
常見問題
Q：一位成員需要在每個通道都配置嗎？
A：需要。帳號映射按通道分別維護，DingTalk那條填DingTalk使用者識別碼，飛書那條填 Open ID 或手機號，企業微信那條填企微帳號。
Q：修改了成員的手機號，映射會自動更新嗎？
A：不會。手機號與通道 @ 標識都需手動登記到映射，成員的連絡方式變動後需要手動編輯對應映射。為減少這類維護，建議優先填寫通道 @ 標識。