DataWorks:AI Assistant na prática: Configure o mapeamento de contas de IM para @-mencionar com precisão os responsáveis e a equipe de plantão

Etapa 1: Acesse o mapeamento de contas do canal de destino

1. Faça login no console do DataWorks e clique em AI Assistant service no painel de navegação à esquerda.

2. Na lista de instâncias, localize a instância de destino e clique no nome dela para acessar a página de detalhes.

3. Na área Channel Configuration, localize o cartão do canal de destino (DingTalk, WeCom ou Lark / Lark) e configure a channel integration correspondente.

4. Após concluir a configuração do canal, clique em Account Mapping no canto superior direito do cartão.

Etapa 2: Adicione um mapeamento de contas

1. No canto superior esquerdo do painel Account Mapping, clique em Add Mapping.

2. Configure os seguintes parâmetros na caixa de diálogo Add Mapping e clique em OK.

   Parameter	Required	Default value	Description
   Member	Yes	N/A	Pesquise e selecione o usuário ou função RAM correspondente ao membro responsável. A lista suspensa rotula cada entrada como User ou Role. Após selecionar um membro, o apelido, o nome da conta e o ID da conta são preenchidos automaticamente e usados como chave primária do mapeamento.
   Phone number	No	Empty	Número de telefone registrado para este membro no canal atual. Esse número serve como identificador genérico para @-menções via telefone. A lista sempre exibe o número em formato mascarado. Ao editar o mapeamento, manter o valor mascarado preserva o número original. Para alterar o número, insira o novo número completo.
   Channel @ identifier	No	Empty	Identidade da plataforma deste membro no canal atual. O nome do campo varia conforme o canal: Para DingTalk, o campo é DingTalk User ID, obtido na página de detalhes pessoais. Para WeCom, o campo é WeCom Account. Um administrador do WeCom pode obtê-lo na página de detalhes do usuário em Contacts. Para Feishu / Lark, o campo é Feishu Open ID / User ID. Você pode inserir um Open ID ou User ID que comece com ou_. Para saber como obter o ID, consulte Como obter IDs de usuário.
   Enable mapping	No	Enabled	Ativado por padrão. Quando desativado, este mapeamento deixa de ter efeito. Isso permite suspender temporariamente as @-menções para um membro sem excluir o registro.

3. Após salvar o mapeamento, a lista é atualizada e o membro aparece. Se a instância também utilizar outros canais, retorne a Channel Configuration e repita as etapas anteriores para o mesmo membro nos outros cartões de canal.

A interface exige apenas a seleção de um membro. É possível salvar um mapeamento mesmo que o número de telefone e o identificador @ do canal estejam vazios. No entanto, quando ambos estiverem vazios, esse mapeamento não terá um identificador @ utilizável no canal atual. Recomendamos preencher pelo menos um campo. Priorize o identificador @ do canal, pois ele não se torna inválido caso o membro altere seu número de telefone.

Etapa 3: Envie uma mensagem de teste para verificação

Envie uma única mensagem de teste para verificar se a configuração de mapeamento de contas de um membro específico entrou em vigor.

1. Inicie o teste

   Na lista Account Mapping, localize o membro de destino e clique no botão Test na coluna Actions.

   Dica: Se as informações de mapeamento (identificador @ ou número de telefone) deste membro no canal atual estiverem vazias, o sistema bloqueará o teste e solicitará que você complete as informações primeiro.

2. Configure e envie

   Na caixa de diálogo exibida, cole a url do Webhook do bot do grupo de destino e clique em Submit.

   Importante

   • Os bots inteligentes do WeCom e do Lark não suportam Webhooks. Adicione um bot de Webhook a um chat em grupo para testar a entrega de mensagens com @-menção.

   • Se o mesmo bot for usado em vários grupos, sua url de Webhook será diferente para cada grupo. Ao testar um envio, certifique-se de selecionar a url correta do chat em grupo para evitar o envio da mensagem para o grupo errado.

   • O sistema envia uma mensagem de teste real para o grupo, visível para todos os membros. Para evitar interrupções, notifique os membros relevantes do grupo com antecedência.

3. Verifique o resultado

   Acesse o chat em grupo de IM correspondente e verifique a mensagem de teste:

   • Sucesso: O membro foi @-mencionado com sucesso (o nome aparece como um link azul clicável).

   • Falha: O nome do membro aparece como texto simples e não pode ser clicado.

4. Solução de problemas

   Se o teste falhar (o membro não foi @-mencionado com sucesso), verifique as seguintes configurações uma a uma. Teste novamente após corrigir quaisquer problemas:

   • Status de ativação: Certifique-se de que a opção Enable Mapping para o membro esteja ativada na lista de mapeamento.

   • Informações de identidade: Garanta que pelo menos um dos campos Channel @ Identifier ou Phone Number esteja preenchido para o membro no canal testado.

   • Precisão do identificador: Verifique novamente se o identificador @ inserido (como um ID de usuário do DingTalk) está totalmente correto, sem erros de digitação ou espaços extras.

   • Validade do Webhook: Confirme se a url do Webhook usada para teste está correta e se o bot foi adicionado adequadamente ao chat em grupo de destino.

1. Membros responsáveis

Este é o destino de notificação mais crítico. O sistema determina o membro responsável específico por meio de análise inteligente.

• Membros responsáveis dinâmicos (comportamento padrão)

  • Lógica: Durante cada ciclo de inspeção, o AI Assistant analisa em tempo real os recursos específicos com problemas (como uma tabela ou tarefa). Em seguida, @-menciona automaticamente o proprietário desse recurso.

  • Vantagens: Nenhum pré-registro é necessário. O processo é inteligente, automatizado e direcionado com precisão. Se nenhuma exceção for encontrada no ciclo atual, ninguém é perturbado.

  • Cenário aplicável: A maioria dos cenários de alerta de rotina.

• Membros responsáveis fixos (fallback)

  • Lógica: Especifique um ou mais membros fixos em uma tarefa de inspeção através do AI Assistant. Independentemente do ciclo de inspeção ou do recurso com problema, o sistema @-menciona esses membros fixos.

  • Cenário aplicável: Serve como fallback definitivo para alertas. Garante que alguém sempre receba a notificação — por exemplo, o líder da equipe ou o proprietário do grupo.

2. Membros de plantão

Ao configurar uma tarefa agendada, instrua o AI Assistant a usar shift schedules como destino de notificação. O sistema então introduz o mecanismo de rotação de turnos.

• Lógica: O AI Assistant lê e associa automaticamente as escalas de plantão nativas mantidas no Operation Center do DataWorks. Ele recupera o membro de plantão principal e o membro de plantão reserva do dia atual para @-mencioná-los.

• Vantagem: O destino da notificação gira automaticamente conforme a escala de plantão. Isso elimina a necessidade de configuração repetitiva no lado do AI Assistant.

• Exibição: No relatório de alerta, o membro responsável e o membro de plantão aparecem em linhas separadas com rótulos claros.

3. Criador

Quando o objeto de recurso monitorado não possui um membro responsável, o DataWorks designa o criador como destino de notificação como estratégia de fallback. O exemplo a seguir usa o Flink:

• Monitoramento de jobs do Flink: Quando nenhum mapeamento de membro responsável estiver registrado para um job, o AI Assistant consulta automaticamente o criador do job para @-mencionar. O relatório recebe a anotação "(by creator)".

• Prioridade: ① Mapeamento de membro responsável > ② Criador do job > ③ Membro de fallback padrão. Configure as partes interessadas relevantes no mapeamento de contas para garantir que o AI Assistant service possa @-mencionar a pessoa correta com precisão.

• Quando o criador não puder ser recuperado (por exemplo, devido à falta de permissão de leitura no job), a notificação retornará ao membro de fallback padrão ou a uma menção em texto simples. A anotação será "creator not found".

  Nota : O monitoramento do Flink e o recurso de @-menção automática por criador exigem que você ative primeiro o Flink Expert Suite .

Notas específicas da plataforma

DingTalk

• Forneça a url do Webhook do grupo para ativar notificações por @-menção.

• Quando um bot é adicionado a grupos diferentes, cada grupo gera sua própria url de Webhook independente.

• Ao configurar uma tarefa agendada, insira manualmente a url do Webhook do grupo de destino. O sistema não consegue obtê-la automaticamente.

Lark

• O bot do aplicativo pode enviar mensagens com @-menção para um grupo especificado por ID do grupo, sem necessidade de url de Webhook.

• Após especificar um grupo, o bot pode @-mencionar diretamente os membros do grupo e acionar notificações.

WeCom

O WeCom possui dois tipos de bots com capacidades completamente diferentes:

• Bot de chat: Usado para conversas interativas e suporta dois modos de conexão.

  • Modo de conexão longa: Pode enviar proativamente mensagens com @-menção para um grupo especificado e acionar notificações sem url de Webhook.

  • Modo de callback de url: Não pode enviar proativamente mensagens com @-menção para um grupo especificado.

  • Nenhum dos modos possui capacidades de Webhook.

• Bot de envio de mensagens (dedicado a Webhook): Envia mensagens unidirecionalmente através de uma url de Webhook e suporta @-menções.

  • Se precisar enviar notificações por @-menção via Webhook, crie esse tipo de bot separadamente no grupo.

Recomendações de configuração

• P: Um membro precisa ser configurado em todos os canais?

  R: Sim. O mapeamento de contas é mantido por canal. Insira um ID de usuário do DingTalk para o canal DingTalk, um Open ID ou número de telefone para o canal Lark e uma conta WeCom para o canal WeCom.

• P: Se eu alterar o número de telefone de um membro, o mapeamento é atualizado automaticamente?

  R: Não. Tanto o número de telefone quanto o identificador @ do canal devem ser registrados manualmente no mapeamento. Se as informações de contato de um membro mudarem, edite manualmente o mapeamento correspondente. Para reduzir essa sobrecarga de manutenção, recomendamos preencher primeiro o identificador @ do canal.