Uma Caixa de Entrada para o Que Espera por Você

Às 14:10 você inicia uma execução gerenciada na Payments API e volta ao seu próprio trabalho. Às 14:25 o agente para em uma pergunta: as novas tentativas também devem cobrir respostas 4xx dos destinatários, ou só 5xx e timeouts? Você está em outra aba. Como descrevemos quando as execuções ganharam um ciclo de revisão, uma pergunta que ninguém responde em uma hora deixa o agente seguir com o próprio julgamento, e um plano que ninguém revisa em uma hora faz a execução falhar. Às 15:25 o agente decide sozinho.

Nada estava quebrado. A página da execução dizia Aguardando você o tempo todo. Você não estava na página da execução.

As execuções são um caso de algo que se tornou verdade em todo o Archyl: coisas esperam por pessoas. Uma solicitação de mudança de arquitetura fica aberta até que alguém com permissão de edição a revise. Um comentário em um elemento de diagrama recebe uma resposta que o autor nunca vê. Até agora havia duas formas de descobrir. Você ia olhar, ou ativava as notificações por e-mail, que espelham as mudanças de arquitetura de toda a organização e contam muita coisa sobre a qual não cabe a você agir.

O Archyl agora tem uma terceira: um sino na extremidade direita do cabeçalho do app, em todas as páginas, com um contador de não lidas. Atrás dele há uma caixa de entrada que guarda só o que espera por você ou o que responde a algo que você fez.

Como é o painel

Clique no sino e um painel com o título Notificações se abre. Cada notificação é uma linha: uma frase dizendo quem fez o quê, um trecho, o nome do projeto e há quanto tempo. Aqui está uma tarde plausível. As frases são as que o app mostra. Os nomes, os projetos e os trechos são exemplos.

Notificações                                    Marcar tudo como lido

● Um agente aguarda sua resposta
  Should retries also cover 4xx responses from receivers, or only
  5xx and timeouts?
  Payments API · há 12 min.

● Marie Laurent pediu alterações em #14
  Billing shouldn't call the ledger database directly. Route it
  through the Ledger API container.
  Billing · há 2 h

● Sam Okafor respondeu em uma discussão
  That queue was replaced by the outbox table in March, the
  diagram is behind.
  Checkout · há 3 h

  Sua execução de agente terminou
  Document how to set up and run the service locally.
  Billing · ontem

Clicar em uma linha a marca como lida e abre a página de que ela trata: a execução, a solicitação de mudança ou a discussão. Marcar tudo como lido fica no cabeçalho do painel, e passar o cursor sobre uma linha não lida mostra um botão Marcar como lida para as que você quer limpar sem abrir. Quando não há nada, o painel diz isso: "Nada está esperando por você".

O que envia uma notificação

Três fontes, e a lista completa é curta o bastante para imprimir.

As execuções gerenciadas de agente notificam a pessoa que iniciou a execução.

Uma execução cancelada não envia nada. Alguém escolheu pará-la, e esse alguém não precisa ser avisado.

As solicitações de mudança de arquitetura notificam em duas direções. Quando uma é aberta, todos que podem editar o projeto são avisados, exceto o autor. Revisar exige permissão de edição, então essas são as pessoas por quem ela espera. A partir daí, o autor fica sabendo o que acontece com ela:

As discussões notificam sobre respostas. Uma resposta chega à pessoa que iniciou a discussão e a todos que já responderam nela, com a resposta como trecho. O link abre a discussão, não a resposta isolada, então você cai na conversa inteira.

Uma regra vale para as três: você nunca é notificado das suas próprias ações. Aprove a solicitação de mudança da sua colega e ela fica sabendo. Você não.

Por que não é um feed de atividade

O jeito óbvio de construir isso é pegar o histórico de mudanças que o Archyl já registra e mostrá-lo debaixo de um sino. Não fizemos isso, de propósito.

O histórico de uma organização é, em sua maior parte, o trabalho de outras pessoas indo bem. Alguém renomeou um container, alguém adicionou um relacionamento, a descoberta propôs doze componentes e um colega os aprovou. Tudo isso é verdade e quase nada disso precisa de você. Coloque isso debaixo de um contador de não lidas e o contador deixa de significar alguma coisa. A maioria de nós tem um sino assim em alguma outra ferramenta, com um número em cima que paramos de ler há muito tempo.

Por isso a caixa de entrada tem um teste estreito para o que entra. Ou a coisa está bloqueada até você agir (a pergunta de um agente, um plano, uma solicitação de mudança que você pode revisar), ou é a resposta a algo que você começou (uma revisão da sua solicitação, o fim da sua execução, uma resposta na sua discussão). Uma mudança que não passa em nenhum dos dois testes não ganha uma linha.

A visão ampla continua existindo e não mudou. As notificações por e-mail e a página Histórico continuam sendo o lugar para a atividade de toda a organização. A caixa de entrada é a outra metade: a parte endereçada a você.

Alguns detalhes

Cada organização tem a sua própria caixa de entrada. Se você pertence a duas, o sino conta e lista a daquela em que você está no momento.

As frases seguem o seu idioma, os trechos não. O app está disponível em nove idiomas, e a frase de cada linha é renderizada no idioma da sua interface. Uma notificação armazena o que aconteceu, não uma string pronta em inglês, então um revisor que trabalha em francês e um autor que trabalha em japonês leem cada um "pediu alterações" no próprio idioma. O trecho são as palavras de alguém, e fica no idioma em que foram escritas.

O que uma notificação copia é protegido como a sua origem. Uma linha repete o título de uma solicitação de mudança ou um pedaço de um comentário. Onde esses dados são criptografados em repouso, que é o caso no Archyl Cloud, a cópia na caixa de entrada é criptografada do mesmo jeito.

O contador é consultado por polling, não enviado por push. O contador de não lidas é atualizado a cada 30 segundos, e de novo quando você volta para a aba. Uma notificação nova pode, portanto, levar até meio minuto para aparecer no sino. Para "um revisor quer alterações" isso é cedo o bastante, e poupa cada aba aberta de manter uma conexão de longa duração. Marcar algo como lido atualiza o contador na hora no seu próprio navegador.

O que ela ainda não faz

Solicitações de mudança abertas por um agente pelo servidor MCP não notificam os revisores. Uma solicitação aberta no app notifica. Uma que um agente abre pelo MCP aparece na lista do projeto, e o sino de ninguém se mexe.

Sem configurações por tipo. Você não pode desligar um tipo de notificação. A lista acima é o que você recebe.

Sem @menções. Citar alguém em um comentário não notifica essa pessoa. Hoje só quem já está em uma discussão fica sabendo das respostas. As menções são o próximo item do roadmap da caixa de entrada, e não estamos colocando uma data nelas.

Onde encontrar

Não há nada para configurar. O sino fica na extremidade direita do cabeçalho, e vai continuar vazio até que algo seja endereçado a você. O jeito mais rápido de vê-lo funcionar: inicie uma execução gerenciada em um perfil com Revisar o plano primeiro ativado, mude para outra página e espere o contador.

Se você inicia execuções pelo chat, isto fica ao lado das atualizações no thread em vez de substituí-las. Uma execução iniciada pelo Slack ou pelo Teams continua reportando no próprio thread, e quem a iniciou também recebe a linha na caixa de entrada.

Leitura relacionada: revisar um agente enquanto ele trabalha, para os planos e as perguntas pelos quais uma execução espera, e solicitações de mudança de arquitetura, para o fluxo de revisão que essas notificações seguem.