Na página de usuário Gerenciar fluxos de trabalho, é possível gerenciar e conferir informações sobre os fluxos de trabalho ativos e inativos do agente da Análise de conversas 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 perfil somente se um administrador do Looker tiver concedido a você a permissão chat_with_agent e a permissão see_schedules ou create_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. Dependendo de quando você criou os fluxos de trabalho, as informações são exibidas na guia Fluxos de trabalho ou Fluxos de trabalho legados.
Workflows
A guia Agentic Workflows mostra os Agentic Workflows ativos e desativados criados no Looker 26.14 ou em versões mais recentes.
| Coluna | Definição |
|---|---|
| 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. |
| Agente de dados | Se a fonte de dados associada ao fluxo de trabalho for um agente de dados, o nome do agente que criou o fluxo de trabalho. |
| Proprietário | O nome do usuário que criou o fluxo de trabalho. |
| Destino | O destino para onde a notificação do fluxo de trabalho é enviada. As opções são e-mail ou Slack. |
| Frequência | A frequência com que o fluxo de trabalho é executado. |
| 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. |
Fluxos de trabalho legados
| 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 foram atendidas. Essa coluna mostra ícones de aviso ou erro relacionados a alertas 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 de erro 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 de usuário ou quando um administrador do Looker desativa o fluxo. Ao desativar o fluxo de trabalho, as notificações serão pausadas para todos os destinatários. |
| 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 Gerenciar fluxos de trabalho para a instância do Looker nesta página. |
Gerenciar fluxos de trabalho para a instância do Looker
O gerenciamento de fluxo de trabalho pode envolver as seguintes tarefas:
- Gerenciar o status
- Visualizar os metadados na página Detalhes
- Monitorar a atividade na página Atividade
- Modificar as condições e os limites
Em linha com cada fluxo de trabalho, há um menu Opções com estas seleções:
Workflows
- Editar fluxo de trabalho
- Histórico
- Excluir
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.
Clique em Histórico para abrir a página Execuções de fluxo de trabalho com o histórico do fluxo de trabalho selecionado.
Clique em Excluir para remover o fluxo de trabalho. Se você escolher excluir o fluxo de trabalho, será necessário confirmar a escolha.
Fluxos de trabalho legados
- 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 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 do fluxo de trabalho.
Em algumas circunstâncias, um proprietário do 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
- Solução de problemas de mensagens de erro ou avisos
- Como resolver falhas na entrega de notificações
Para desativar um fluxo de trabalho, siga estas etapas:
- Na página do usuário Gerenciar fluxos de trabalho, encontre o fluxo de trabalho que precisa ser desativado.
- Selecione o menu Opções do fluxo de trabalho.
- 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 mostra um resumo das configurações e da configuração do fluxo de trabalho. As informações exibidas dependem de quando o fluxo de trabalho foi criado: no Looker 26.14 ou em uma versão mais recente (guia Fluxos de trabalho) ou antes da 26.14 (guia Fluxos de trabalho legados).
Workflows
Ao selecionar Ver fluxo de trabalho no menu Opções ou clicar no nome do fluxo de trabalho na guia Fluxos de trabalho, é possível ver e editar as seguintes configurações de configuração do fluxo de trabalho:
- Fonte de dados: a fonte de dados subjacente do fluxo de trabalho, seja um agente (agente de dados) ou análises detalhadas específicas (como
purchases). - Fluxo de trabalho: o nome do fluxo de trabalho.
- Gatilho: a programação ou condição que inicia o fluxo de trabalho:
- Repetir: a frequência de execução (por exemplo, Minutos, Por hora, Diariamente, Semanalmente ou Mensalmente).
- Dia: o dia da semana ou do mês em que o fluxo de trabalho é executado.
- Horário: o horário específico do dia em que o fluxo de trabalho é executado.
- Diretivas: as diretivas e instruções detalhadas em linguagem natural que o agente executa durante cada execução do fluxo de trabalho.
- Destino: as opções de entrega dos resultados da execução do fluxo de trabalho. Cada execução cria uma nova conversa visível na Análise de conversas. Outras opções de entrega incluem:
- E-mail: envia o resumo narrativo em linguagem natural, as tabelas de dados e os relatórios em PDF para os destinatários de e-mail especificados.
- Slack: envia o resumo narrativo, os blocos de dados e os relatórios em PDF para canais do Slack ou mensagens diretas designados.
- Lista de destinatários: adicione ou remova endereços de e-mail de destinatários individuais ou destinos do Slack.
Clique em Salvar mudanças para salvar as modificações na configuração do fluxo de trabalho.
Fluxos de trabalho legados
Quando você seleciona um fluxo de trabalho na guia Fluxos de trabalho legados, a página Detalhes mostra informações sobre alertas e programações legados:
- 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 do 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 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:
- Selecione o menu Opções do fluxo de trabalho e clique em Ver fluxo de trabalho.
- Clique no nome do fluxo de trabalho.
Na página Detalhes, é possível realizar as seguintes tarefas:
- Selecione o campo de texto para adicionar contexto sobre o fluxo de trabalho.
- Selecione o menu Mais e a opção Analisar daqui para abrir uma análise predefinida com a consulta de fluxo de trabalho.
- Selecione Testar agora para executar uma consulta de fluxo de trabalho instantaneamente, sem precisar esperar a frequência especificada do fluxo. Se as condições do fluxo de trabalho forem atendidas, uma notificação será enviada ao proprietário e a todos os destinatários adicionais.
Clique em Concluído para fechar a página Detalhes.
Monitorar a atividade do fluxo de trabalho
Acessar o histórico de um fluxo de trabalho oferece várias vantagens importantes:
- Verifique a execução e o sucesso da entrega:
- Confirme se as execuções programadas ou as verificações de limite ocorreram no prazo.
- Confira o status de cada execução (Concluída, Em execução ou Erro / Falha).
- Verifique os métodos de entrega e confirme se as notificações chegaram aos destinos pretendidos (e-mail ou Slack).
- Diagnosticar e resolver erros:
- Inspecione mensagens de erro detalhadas para resolver problemas como:
- Permissões de usuário ausentes (acesso ao modelo).
- Agentes de dados excluídos ou análises detalhadas inacessíveis.
- Domínios de e-mail externos ou canais do Slack não autorizados.
- Tempos limite de conexão intermitentes ou atrasos na remoção da fila.
- Condições de acionamento da auditoria e atualização de dados:
- Verificações de condição: confira se as condições de limite foram atendidas ou excedidas durante cada execução de avaliação.
- Atualização de dados: identifique se os dados do banco de dados subjacente mudaram entre as execuções (Atualizado: Sim ou Não), ajudando a evitar ou diagnosticar alertas de fluxo de trabalho desatualizados.
- Monitoramento de performance:
- Acompanhe a duração do tempo de execução da consulta ao longo do tempo para identificar degradação de performance, consultas lentas ou gargalos no banco de dados.
- Auditabilidade e compliance:
- Mantenha um registro claro de entregas de relatórios automatizados, listas de destinatários e registros de execução em toda a equipe ou instância do Looker.
O Looker executa uma consulta de fluxo de trabalho na frequência especificada. Para fluxos de trabalho acionados, ele verifica se as condições foram atendidas. Os resultados dessas verificações se tornam o histórico do fluxo de trabalho. Para fluxos de trabalho legados, esse histórico pode ser visto na página Atividade. Para fluxos de trabalho, esse histórico pode ser acessado na página Execuções de fluxo de trabalho no painel de administração. O Looker executa uma consulta de fluxo de trabalho na frequência especificada. Para fluxos de trabalho acionados, ele verifica se as condições foram atendidas. Os resultados dessas verificações se tornam o histórico do fluxo de trabalho. Para fluxos de trabalho legados, esse histórico pode ser visto na página Atividade. Para fluxos de trabalho, esse histórico pode ser acessado na página Execuções de fluxo de trabalho no painel de administração.
Workflows
Para acessar a página Execuções de fluxo de trabalho, selecione a opção Histórico no menu Opções da página de usuário Gerenciar fluxos de trabalho. Para acessar a página Execuções de fluxo de trabalho, você precisa ter um papel que contenha a permissão see_schedules.
Workflows legado
Para fluxos de trabalho legados, 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:MM05/30 18:25 |
| Tempo de execução | Quanto tempo a consulta do 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. |
|
| 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 |
|
| 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:MMExemplo: 05/25 16:01 |
| Condição atendida | Um booleano que indica se as condições do fluxo de trabalho foram atendidas ou não |
|
| Gatilho | O valor de 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 |
|
Na página Atividade, você pode realizar as seguintes tarefas:
- Confira a frequência com que a consulta de fluxo de trabalho verifica as condições.
- Confira o histórico do fluxo de trabalho.
- Use o botão Testar agora para executar uma consulta de fluxo de trabalho instantânea. Se o fluxo de trabalho 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.
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, quando aplicável, aparecem quando você mantém o ponteiro 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 para dispositivos móveis, 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 enviada. 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 manter o ponteiro sobre esse ícone, a mensagem Alerta desatualizado aparece.
Há algumas explicações possíveis para a falta de mudanças nos dados entre as consultas. Se o aviso persistir, converse 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.
Modificar condições de fluxo de trabalho
Em algumas circunstâncias, um proprietário do fluxo de trabalho ou admin do Looker pode precisar modificar manualmente a configuração do fluxo de trabalho, 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 da métrica 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:
- Na página do usuário Gerenciar fluxos de trabalho, selecione o menu Opções do fluxo de trabalho que você quer modificar.
- Selecione Editar fluxo de trabalho, que abre a caixa de diálogo de edição do fluxo de trabalho.
- Faça as mudanças nas configurações do fluxo de trabalho.
- Para fluxos de trabalho legados, selecione Salvar alerta para salvar as mudanças. Para fluxos de trabalho, selecione Salvar 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.
Recursos relacionados
- Visão geral da análise conversacional
- Configurações de administrador - Workflows
- Criar um fluxo de trabalho de agente acionado
- Criar um fluxo de trabalho agentic programado