Gerenciar seus fluxos de trabalho agênticos

Na página de usuário Gerenciar fluxos de trabalho, é possível gerenciar e conferir informações sobre os fluxos de trabalho de análise de conversas ativos e inativos que você criou ou para os quais foi adicionado como destinatário.

Para acessar a página de usuário Gerenciar fluxos de trabalho, selecione o menu Perfil e depois Fluxos de trabalho. Essa página aparece no menu do seu perfil somente se um administrador do Looker tiver concedido a você as permissões create_alerts e see_alerts.

Informações do fluxo de trabalho

A página do usuário Gerenciar fluxos de trabalho fornece informações sobre os fluxos de trabalho que você possui ou em que você está listado como destinatário:

Coluna Definição
Nome do fluxo de trabalho O título do fluxo de trabalho, definido pelo agente quando ele é iniciado. O agente gera um título padrão para o fluxo de trabalho com base no conteúdo da conversa. Clique no nome do fluxo de trabalho para abrir a página Detalhes dele.
Proprietário O nome do usuário que criou o fluxo de trabalho.
Tempo médio de execução A duração da consulta de fluxo de trabalho em segundos.
Condição atendida Um Sim ou Não que indica se as condições do fluxo de trabalho foram atendidas na última execução da consulta. Um símbolo -- é mostrado se a consulta de fluxo de trabalho ainda não foi executada ou se foi executada, mas não foi possível determinar se as condições do fluxo de trabalho foram atendidas. Essa coluna mostra ícones de aviso ou erro relacionados a avisos ou erros que aparecem quando a consulta de fluxo de trabalho é executada ou a notificação de fluxo de trabalho é entregue. Mantenha o ponteiro do mouse sobre o ícone de aviso ou erro para conferir a mensagem associada, se aplicável.

Um ícone de aviso com um alerta de fluxo de trabalho desatualizado indica que os dados no bloco do painel não mudaram entre as duas consultas de fluxo de trabalho mais recentes. Leia mais sobre essa mensagem na seção Mensagens de erro e aviso de alerta nesta página.
Frequência A frequência com que o fluxo de trabalho é executado para verificar se as condições foram atendidas ou excedidas.
Status Essa coluna indica se o fluxo de trabalho está ativo ou desativado.

Um fluxo de trabalho é marcado como Desativado quando um usuário desativa o próprio fluxo na página dele ou quando um administrador do Looker desativa o fluxo. Ao desativar o fluxo de trabalho, as notificações para todos os destinatários serão pausadas.
Atividade Um link que direciona você à página Atividade do fluxo de trabalho.
Menu Opções Um menu em que você pode realizar outras ações no fluxo de trabalho. Saiba mais na seção Opções de gerenciamento de fluxo de trabalho nesta página.

Gerenciar fluxos de trabalho para a instância do Looker

O gerenciamento de fluxo de trabalho pode envolver as seguintes tarefas:

Em linha com cada fluxo de trabalho, há um menu Opções com estas seleções:

  • Ver fluxo de trabalho
  • Editar fluxo de trabalho
  • Desativar fluxo de trabalho (se o fluxo de trabalho estiver ativo)
  • Ativar fluxo de trabalho (se o fluxo de trabalho estiver desativado)

Clique em Ver fluxo de trabalho para abrir a página Detalhes.

Clique em Editar fluxo de trabalho para abrir e modificar as configurações dele. Clique em Salvar fluxo de trabalho para salvar as mudanças ou em Cancelar para fechar a janela de edição sem salvar.

Gerenciar o status de um fluxo de trabalho

Não é possível excluir um fluxo de trabalho de forma permanente, mas é possível controlar se ele está ativo. Quando o Status de um fluxo de trabalho é Ativo, a consulta continua sendo executada de acordo com a frequência especificada no fluxo para verificar se as condições foram atendidas. Se as condições forem atendidas, os destinatários do fluxo de trabalho vão receber uma notificação pelo método especificado no fluxo. Quando o Status de um fluxo de trabalho é Desativado, nenhuma consulta de fluxo de trabalho é executada e nenhuma notificação é enviada. A página Detalhes de um fluxo de trabalho desativado não mostra resultados na visualização.

Em algumas circunstâncias, um proprietário de fluxo de trabalho ou admin do Looker pode precisar desativar um fluxo de trabalho manualmente, incluindo:

  • Pausar temporariamente as notificações de fluxo de trabalho para reconfigurar as condições
  • Como resolver mensagens de erro ou avisos
  • Como resolver falhas na entrega de notificações

Para desativar um fluxo de trabalho, siga estas etapas:

  1. Na página do usuário Gerenciar fluxos de trabalho, encontre o fluxo de trabalho que precisa ser desativado.
  2. Selecione o menu Opções do fluxo de trabalho.
  3. Selecione Desativar fluxo de trabalho.

Você pode reativar o fluxo de trabalho a qualquer momento seguindo estas etapas e selecionando Ativar fluxo de trabalho.

Ver detalhes do fluxo de trabalho

A página Detalhes é uma caixa de diálogo que mostra um resumo das informações do fluxo de trabalho. Nela, você pode conferir o seguinte:

  • Contexto sobre quais condições acionam o fluxo de trabalho ou o que significa para ele ser acionado.
  • Uma visualização dos resultados da consulta de fluxo de trabalho.
  • O menu Mais na visualização do fluxo de trabalho, que tem uma opção para Analisar daqui. Selecione essa opção para abrir uma análise detalhada predefinida com a consulta de fluxo de trabalho.
  • O botão Testar agora, que executa uma consulta instantânea de fluxo de trabalho.

Na página do usuário Gerenciar fluxos de trabalho, é possível acessar a página Detalhes dos fluxos de trabalho que você possui ou para os quais é um destinatário de uma destas maneiras:

  1. Selecione o menu Opções do fluxo de trabalho e clique em Ver fluxo de trabalho.
  2. Clique no nome do fluxo de trabalho.

Na página Detalhes, é possível realizar as seguintes tarefas:

  1. Selecione o campo de texto para adicionar contexto sobre o fluxo de trabalho.
  2. Selecione o menu Mais e, em seguida, a opção Analisar daqui para abrir uma análise predefinida com a consulta de fluxo de trabalho.
  3. Selecione Testar agora para executar uma consulta de fluxo de trabalho instantaneamente, sem precisar esperar a frequência especificada do fluxo de trabalho. Se as condições do fluxo de trabalho forem atendidas, uma notificação será enviada ao proprietário e a outros destinatários.

Clique em Concluído para fechar a página Detalhes.

Monitorar a atividade do fluxo de trabalho

O Looker executa uma consulta de fluxo de trabalho na frequência especificada para verificar se as condições foram atendidas. Os resultados dessas verificações se tornam o histórico do fluxo de trabalho, que pode ser visto na página Atividade.

A tabela na página Atividade inclui as seguintes informações sobre cada job de consulta de fluxo de trabalho:

Título Definição Valores possíveis
Executado em O carimbo de data/hora de quando a consulta de fluxo de trabalho foi iniciada Qualquer carimbo de data/hora no formato DD/MM HH:MM

Exemplo: 05/30 18:25
Tempo de execução Quanto tempo a consulta de fluxo de trabalho levou para ser executada Qualquer duração no formato 0.81s
Fresh Um booleano que indica se a consulta de fluxo de trabalho verificou dados que mudaram entre as duas consultas de fluxo de trabalho mais recentes.
  • Yes (se os dados foram alterados)
  • No (se os dados não mudaram)
Origem A origem dos dados em que a consulta do fluxo de trabalho verificou o valor de limite indicado nas condições do fluxo de trabalho.
  • query
  • cache
  • stale cache
  • Se query, cache ou stale cache não se aplicarem, o valor Origem vai ficar em branco.
Horário de origem O carimbo de data/hora da linha do banco de dados em que a consulta de fluxo de trabalho verificou o valor de limite. Qualquer carimbo de data/hora no formato DD/MM HH:MM

Exemplo: 05/25 16:01
Condição atendida Um booleano que indica se as condições do fluxo de trabalho foram atendidas ou não
  • Yes (as condições foram atendidas)
  • No (as condições não foram atendidas)
Gatilho O valor limite que acionaria o fluxo de trabalho se fosse atingido ou excedido Qualquer valor numérico
Observadas O valor observado que atendeu ou excedeu as condições do fluxo de trabalho e o acionou Qualquer valor numérico
Status O status da consulta de fluxo de trabalho
  • Complete
  • Running
  • Not Started

Na página Atividade, é possível realizar as seguintes tarefas:

  1. Confira a frequência com que a consulta de fluxo de trabalho verifica as condições.
  2. Confira o histórico do fluxo de trabalho.
  3. Use o botão Testar agora para executar uma consulta de fluxo de trabalho instantânea. Se o fluxo for acionado, uma notificação será enviada ao proprietário e a outros destinatários.

Clique em Concluído para fechar a página Atividade.

Modificar condições de fluxo de trabalho

Um proprietário do fluxo de trabalho ou admin do Looker pode precisar modificar a configuração do fluxo de trabalho manualmente em algumas circunstâncias, incluindo:

  • Ativar ou desativar a análise dos principais fatores com tecnologia do Gemini, que aparece na notificação
  • Ajustar os limites e as condições das métricas que acionam o fluxo de trabalho à medida que as necessidades da organização evoluem
  • Atualizar destinos de notificação
  • Atualização da frequência do fluxo de trabalho para melhor alinhamento com as políticas de armazenamento em cache

Para modificar as configurações de um fluxo de trabalho, siga estas etapas:

  1. Na página Gerenciar fluxos de trabalho, selecione o menu Opções do fluxo de trabalho que você quer modificar.
  2. Selecione Editar fluxo de trabalho, que abre a caixa de diálogo de edição de fluxo de trabalho.
  3. Faça as mudanças nas configurações do fluxo de trabalho.
  4. Selecione Salvar alerta para salvar as mudanças.

Efeito da exclusão de agentes, conversas, análises detalhadas ou painéis nos fluxos de trabalho

A exclusão de um agente de dados ou de uma conversa afeta o fluxo de trabalho associado das seguintes maneiras:

  • Se um usuário excluir a conversa com o agente que gera o fluxo de trabalho, ele vai continuar ativo. Todos os destinatários de notificações de fluxo de trabalho vão continuar recebendo notificações quando as condições do fluxo de trabalho forem atendidas.
  • Se um usuário excluir o agente que gera o fluxo de trabalho, ele vai continuar ativo. Todos os destinatários de notificações de fluxo de trabalho vão continuar recebendo notificações quando as condições do fluxo de trabalho forem atendidas.
  • Se um usuário excluir a Análise ou o painel que contém os dados monitorados pelo fluxo de trabalho, ele vai continuar ativo. Todos os destinatários de notificações de fluxo de trabalho vão continuar recebendo notificações quando as condições do fluxo de trabalho forem atendidas.

Mensagens de erro e aviso do fluxo de trabalho

A página do usuário Gerenciar fluxos de trabalho mostra os erros ou avisos que aparecem quando o fluxo de trabalho é executado ou a notificação é entregue. As mensagens de erro, se aplicável, aparecem quando você passa o cursor sobre o ícone de aviso ou de erro na coluna Condição atendida.

A entrega da notificação falhou com a configuração atual

Para fluxos de trabalho configurados para enviar notificações ao Slack ou ao app Looker Mobile, a mensagem de erro Notification delivery failed with existing configuration aparece quando o fluxo de trabalho determina que as condições foram atendidas, mas a notificação não pôde ser entregue. Isso pode acontecer se algo na configuração do Slack mudou desde que o fluxo de trabalho foi criado. Por exemplo, se o espaço de trabalho do Slack em que o fluxo de trabalho estava sendo entregue foi desconectado da instância do Looker, se o canal do Slack em que o fluxo de trabalho estava sendo entregue foi excluído ou se o Looker não consegue se conectar às integrações.

Aviso: consultando dados atualizados

Um ícone de aviso na coluna Condição atendida indica que os dados em que o fluxo de trabalho se baseia não mudaram entre as duas consultas mais recentes. Ao passar o cursor sobre esse ícone, a mensagem Aviso de alerta desatualizado aparece.

Há algumas explicações possíveis para a falta de mudança nos dados entre as consultas. Se esse aviso persistir, fale com seu desenvolvedor do Looker para verificar se as políticas de armazenamento em cache definidas para as análises detalhadas do agente estão alinhadas com a configuração de frequência do fluxo de trabalho.