DataWorks:AI アシスタントの実践：IM アカウントマッピングを設定し、担当者や当番メンバーを正確に @メンション

ステップ 1：ターゲットチャネルのアカウントマッピングへの移動

1. DataWorks コンソールにログインし、左側のナビゲーションペインで [AI Assistant Service] をクリックします。

2. インスタンスリストでターゲットインスタンスを見つけ、インスタンス名をクリックしてインスタンス詳細ページに移動します。

3. [チャネル設定] エリアで、ターゲットチャネルカード ( DingTalk、WeCom、または Lark ) を見つけ、対応するチャネル統合を設定します。

4. チャネル設定が完了したら、カードの右上隅にある [アカウントマッピング] をクリックします。

ステップ 2：アカウントマッピングの追加

1. [アカウントマッピング] パネルの左上隅で、[マッピングを追加] をクリックします。

2. [マッピングを追加] ダイアログボックスで次のパラメータを設定し、[OK] をクリックします。

   パラメータ	必須	デフォルト値	説明
   メンバー	はい	該当なし	担当メンバーに対応する RAM ユーザーまたはロールを検索して選択します。ドロップダウンリストでは、各エントリに[ユーザー]または[ロール]のラベルが表示されます。メンバーを選択すると、ニックネーム、アカウント名、アカウント ID が自動的に入力され、マッピングの主キーとして使用されます。
   電話番号	いいえ	空	現在のチャネルでこのメンバーに登録されている電話番号。この番号は、電話番号による @メンションの汎用識別子として使用されます。リストには常にマスクされた形式で番号が表示されます。マッピングを編集する際、マスクされた値を変更しない場合、元の番号が保持されます。番号を変更するには、新しい完全な電話番号を入力してください。
   チャネル @ 識別子	いいえ	空	現在のチャネルにおけるこのメンバーのプラットフォーム上の ID。フィールド名はチャネルによって異なります。 DingTalk の場合、フィールドは[DingTalk ユーザーID]で、個人詳細ページから取得できます。 WeCom の場合、フィールドは[WeCom アカウント]です。WeCom の管理者は、[連絡先] のユーザー詳細ページから取得できます。 Lark/Feishu の場合、フィールドは[Lark/Feishu Open ID / User ID]です。ou_ で始まる Open ID または User ID を入力できます。ID の取得方法については、「ユーザーIDの取得方法」をご参照ください。
   マッピングを有効化	いいえ	有効	デフォルトで有効になっています。無効にすると、このマッピングは無効になります。これにより、レコードを削除せずに、メンバーの @メンション を一時的に停止できます。

3. マッピングを保存すると、リストが更新され、メンバーが表示されます。インスタンスで他のチャネルも使用している場合は、[チャネル設定] に戻り、他のチャネルカードで同じメンバーに対して上記の手順を繰り返してください。

UI では、メンバーを選択するだけで済みます。電話番号とチャネル @ 識別子の両方が空の場合でも、マッピングを保存できます。ただし、両方が空の場合、このマッピングには現在のチャネルで使用可能な @識別子 がありません。少なくとも 1 つのフィールドを入力することを推奨します。チャネル @ 識別子を優先してください。メンバーが電話番号を変更しても無効になりません。

ステップ 3：検証のためのテストメッセージ送信

単一のテストメッセージを送信して、特定のメンバーのアカウントマッピング設定が有効かどうかを検証できます。

1. テストを開始する

   [アカウントマッピング] リストでターゲットメンバーを見つけ、[操作] 列の [テスト] ボタンをクリックします。

   ヒント：現在のチャネルでこのメンバーのマッピング情報 ( @識別子 または電話番号) が空の場合、システムはテストを実行できず、最初に情報を入力するように促します。

2. 設定して送信する

   表示されるダイアログボックスで、ターゲットグループボットの Webhook URL を貼り付け、[送信] をクリックします。

   重要

   • WeCom と Lark/Feishu のスマートボットは Webhook をサポートしていません。Webhook ボットをグループチャットに追加して、@メンション メッセージ配信をテストできます。

   • 同じボットが複数のグループで使用されている場合、Webhook URL はグループごとに異なります。テスト送信の際は、正しいグループチャット URL を選択して、間違ったグループにメッセージを送信しないようにしてください。

   • システムは実際のテストメッセージをグループに送信し、すべてのグループメンバーに表示されます。混乱を避けるため、事前に関連するグループメンバーに通知してください。

3. 結果を検証する

   対応する IM グループチャットに移動し、テストメッセージを確認します。

   • 成功：メンバーが正常に @メンション されます (名前がクリック可能な青いリンクとして表示されます)。

   • 失敗：メンバー名がプレーンテキストとして表示され、クリックできません。

4. トラブルシューティング

   テストが失敗した場合 (メンバーが正常に @メンション されない場合)、次の設定を 1 つずつ確認し、問題を修正した後に再度テストしてください。

   • 有効化ステータス：マッピングリストで、メンバーの[マッピングを有効化]トグルがオンになっていることを確認してください。

   • ID 情報：テスト対象のチャネルで、メンバーの[チャネル @ 識別子]または[電話番号]フィールドの少なくとも 1 つが入力されているか確認してください。

   • 識別子の正確性：入力した @識別子 (DingTalk ユーザーID など) が正確で、誤字や余分なスペースがないことを再確認してください。

   • Webhook の有効性：テストに使用した Webhook URL が正しく、ボットがターゲットグループチャットに正しく追加されていることを確認してください。

1. 担当メンバー

これは最も重要な通知ターゲットです。システムは、インテリジェント分析を通じて特定の担当メンバーを特定します。

• 動的な担当メンバー (デフォルトの動作)

  • ロジック：各点検サイクル中、AI アシスタントは問題が検出されたリソース (テーブルやタスクなど) をリアルタイムで分析し、そのリソースのオーナーを自動的に @メンション します。

  • 利点：事前登録は不要です。インテリジェントで自動化されており、通知対象を正確に絞り込みます。現在のサイクルで例外が見つからない場合、通知は送信されません。

  • 適用シナリオ：ほとんどの定型アラートシナリオ。

• 固定担当メンバー (フォールバック)

  • ロジック：AI アシスタントを通じて点検タスクで 1 人以上の固定メンバーを指定できます。どの点検サイクルでどのリソースに問題があっても、システムはこれらの固定メンバーを @メンション します。

  • 適用シナリオ：アラートの最終的なフォールバックとして機能し、必ず誰かが通知を受け取るようにします。たとえば、チームリーダーやグループオーナーなど。

2. 当番メンバー

定期タスクを設定する際、AI アシスタントに「シフトスケジュール」を通知ターゲットとして使用するように指示できます。その後、システムはシフトローテーションの仕組みを利用します。

• ロジック：AI アシスタントは、DataWorks オペレーションセンターで管理されているシフトスケジュールを自動的に読み取って関連付け、当日の主要な当番メンバーとバックアップ当番メンバーを取得して @メンション します。

• 利点：通知ターゲットはシフトスケジュールに応じて自動的にローテーションされるため、AI アシスタント側で繰り返し設定を行う必要がありません。

• 表示：アラートレポートでは、担当メンバーと当番メンバーは明確なラベルとともに別々の行に表示されます。

3. 作成者

監視対象のリソースオブジェクトに担当メンバーがいない場合、DataWorks はフォールバック戦略として作成者を通知ターゲットとして指定します。次の例では Flink を使用しています。

• Flink ジョブ監視の場合：ジョブに担当メンバーマッピングが登録されていない場合、AI アシスタントは自動的にジョブの作成者を特定して @メンション し、レポートには「(by creator)」と注釈が表示されます。

• 優先度：① 担当メンバーマッピング > ② ジョブ作成者 > ③ デフォルトのフォールバックメンバー。AI Assistant Service が適切な担当者を正確に @メンション できるようにするには、アカウントマッピングで関連する関係者を設定する必要があります。

• 作成者を取得できない場合 (たとえば、ジョブの読み取り権限がないため)、通知はデフォルトのフォールバックメンバーまたはプレーンテキストでのメンションにフォールバックし、「作成者が見つかりません」と注釈が表示されます。

  注：Flink 監視と作成者による自動 @メンション 機能には、最初に[Flink Expert Suite]を有効にする必要があります。

プラットフォーム別の注意事項

DingTalk

• @メンション 通知を有効にするには、グループの Webhook URL を提供する必要があります。

• ボットが異なるグループに追加されると、各グループは独自の Webhook URL を生成します。

• 定期タスクを設定する際は、ターゲットグループの Webhook URL を手動で入力する必要があります。システムは自動的に取得できません。

Lark/Feishu

• アプリボットは、Webhook URL なしでグループ ID によって指定されたグループに @メンション メッセージを送信できます。

• グループを指定すると、ボットはグループメンバーを直接 @メンション し、通知をトリガーできます。

WeCom

WeCom には、まったく異なる機能を持つ 2 種類のボットがあります。

• チャットボット：インタラクティブな会話に使用され、2 つの接続モードをサポートします。

  • 長時間接続モード：Webhook URL なしで、指定されたグループに @メンション メッセージを送信し、通知をトリガーできます。

  • URL コールバックモード：指定されたグループに @メンション メッセージを送信できません。

  • どちらのモードも Webhook 機能はありません。

• メッセージプッシュボット (Webhook 専用)：Webhook URL を介して一方向にメッセージを送信し、@メンション をサポートします。

  • Webhook を介して @メンション 通知を送信する必要がある場合は、グループにこのタイプのボットを個別に作成してください。

設定の推奨事項

• Q：メンバーをすべてのチャネルで設定する必要がありますか？

  A：はい。アカウントマッピングはチャネルごとに管理されます。DingTalk チャネルには DingTalk ユーザーID を、Lark/Feishu チャネルには Open ID または電話番号を、WeCom チャネルには WeCom アカウントを入力してください。

• Q：メンバーの電話番号を変更した場合、マッピングは自動的に更新されますか？

  A：いいえ。電話番号とチャネル @ 識別子の両方を、マッピングに手動で登録する必要があります。メンバーの連絡先情報が変更された場合は、対応するマッピングを手動で編集する必要があります。このメンテナンスの手間を削減するには、最初にチャネル @ 識別子を入力することを推奨します。