---
id: "fluxos.notificacoes"
titulo: "Notificações do agente"
resumo: "Deixe um agente avisar você quando algo precisa de atenção — e entenda por que às vezes o aviso não aparece."
idioma: "pt-br"
tipo: "guia"
categoria: "quadro"
aplicavelDesde: "0.0.16"
capabilities: ["notify.send"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/fluxos/notificacoes/"
fonte: "pt-br/fluxos/notificacoes.md"
caminhoPublico: "docs/publica/pt-br/fluxos/notificacoes.md"
hashFonte: "sha256:1f1f525eb1b5dff715fdfe77070b997aa43e8932dff60df1b9543d70f2b341ac"
hashDestaPagina: "sha256:1f1f525eb1b5dff715fdfe77070b997aa43e8932dff60df1b9543d70f2b341ac"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
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

```bash
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

1. **Avise sobre o que exige ação.** "Terminei" é útil quando alguém está esperando; "estou trabalhando"
   não é.
2. **Escreva o texto pensando no que você vai ler daqui a duas horas**, quando não lembrar do contexto.
3. **Não repita o mesmo aviso.** Ele será descartado, e você não saberá se foi supressão ou se o agente
   travou.
4. **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.

## Ver também

- [Automações agendadas](/docs/pt-br/fluxos/automacoes/)
- [Executar agora e ler o histórico](/docs/pt-br/fluxos/automacoes-execucoes/)