Notificações do agente
Deixe um agente avisar você quando algo precisa de atenção — e entenda por que às vezes o aviso não aparece.
Um agente que termina um trabalho longo, ou que precisa de uma decisão, tem como avisar você: ele pede uma notificação de desktop.
O comando
elyra notify "Testes verdes, pronto para revisão"elyra notify "Precisa de uma decisão sobre a migração" --title "orq-2-4"O texto é o corpo do aviso; --title é opcional. O comando dispara a notificação e segue — ele não
espera nada.
Por que a notificação às vezes não aparece
Um agente que avisa e não é ouvido é pior do que um agente que não avisa, porque quem espera acha que o silêncio significa “ainda trabalhando”. Os motivos mais comuns de supressão:
| Motivo | O que aconteceu |
|---|---|
| Você já está olhando aquele terminal | O aviso não aparece de propósito: você está ali, o aviso seria ruído |
| Texto repetido em poucos segundos | O mesmo texto é entregue uma vez só; repetições próximas são descartadas |
| Notificações desligadas | O interruptor geral dos alertas está desligado |
| O canal daquela fonte está desligado | Alertas têm controle por fonte; o do agente é o interruptor geral |
| Nada mudou, mas a janela está escondida | A janela minimizada acende o ponto de atenção na bandeja em vez de mostrar o banner |
| Sem área de trabalho para notificar | Num ambiente sem sessão gráfica, não há onde mostrar a notificação |
O ponto de atenção na bandeja existe porque um banner que você não vê não avisa nada — e ele se apaga quando a janela volta.
Uma decisão de desenho que vale conhecer
Notificação de agente não tem interruptor próprio. Um agente só notifica quando alguém mandou — ele não decide avisar por conta própria. Por isso o controle é o interruptor geral: desligado, nenhum aviso de agente passa.
Ao mesmo tempo, o agente divide a mesma tabela de repetição com os avisos que o próprio app gera (terminais e conclusão de tarefas). Isso evita dois avisos para o mesmo momento — um do app dizendo que o agente terminou e outro do agente dizendo a mesma coisa.
Como usar bem
- Avise sobre o que exige ação. “Terminei” é útil quando alguém está esperando; “estou trabalhando” não é.
- Escreva o texto pensando no que você vai ler daqui a duas horas, quando não lembrar do contexto.
- Não repita o mesmo aviso. Ele será descartado, e você não saberá se foi supressão ou se o agente travou.
- Um aviso por assunto. Dois assuntos importantes no mesmo texto viram um aviso que você vai reabrir e reler.
Escopo e limites
- O aviso não carrega contexto. Ele diz o que o agente escreveu; abrir o terminal é o que dá o contexto.
- Notificação não é registro. Ela é efêmera: o que precisa durar vai para a conversa, para o quadro ou para o comentário da tarefa.