Una inbox per ciò che aspetta te

Alle 14:10 avvii un'esecuzione gestita su Payments API e torni al tuo lavoro. Alle 14:25 l'agente si ferma su una domanda: i retry devono coprire anche le risposte 4xx dei destinatari, o solo le 5xx e i timeout? Tu sei in un'altra scheda. Come abbiamo raccontato quando le esecuzioni hanno ricevuto un ciclo di revisione, una domanda a cui nessuno risponde entro un'ora lascia che l'agente prosegua secondo il proprio giudizio, e un piano che nessuno rivede entro un'ora fa fallire l'esecuzione. Alle 15:25 l'agente decide da solo.

Non c'era niente di rotto. La pagina dell'esecuzione diceva In attesa di te per tutto il tempo. Tu non eri sulla pagina dell'esecuzione.

Le esecuzioni sono un caso di qualcosa che è diventato vero in tutto Archyl: ci sono cose che aspettano le persone. Una richiesta di modifica dell'architettura resta aperta finché qualcuno con permessi di modifica non la rivede. Un commento su un elemento di un diagramma riceve una risposta che il suo autore non vede mai. Finora c'erano due modi per scoprirlo. Andavi a guardare, oppure attivavi le notifiche via email, che rispecchiano le modifiche all'architettura di tutta l'organizzazione e ti dicono moltissimo su cui non spetta a te agire.

Archyl ora ne ha un terzo: una campanella all'estremità destra dell'header dell'app, in ogni pagina, con un contatore dei non letti. Dietro c'è una inbox che contiene solo ciò che aspetta te o ciò che risponde a qualcosa che hai fatto.

Che aspetto ha il pannello

Fai clic sulla campanella e si apre un pannello intitolato Notifiche. Ogni notifica è una riga: una frase che dice chi ha fatto cosa, un estratto, il nome del progetto e quanto tempo fa. Ecco un pomeriggio plausibile. Le frasi sono quelle che l'app mostra. I nomi, i progetti e gli estratti sono esempi.

Notifiche                                      Segna tutto come letto

● Un agente attende la tua risposta
  Should retries also cover 4xx responses from receivers, or only
  5xx and timeouts?
  Payments API · 12 min fa

● Marie Laurent ha chiesto modifiche a #14
  Billing shouldn't call the ledger database directly. Route it
  through the Ledger API container.
  Billing · 2 h fa

● Sam Okafor ha risposto in una discussione
  That queue was replaced by the outbox table in March, the
  diagram is behind.
  Checkout · 3 h fa

  La tua esecuzione dell'agente è terminata
  Document how to set up and run the service locally.
  Billing · ieri

Un clic su una riga la segna come letta e apre la pagina di cui parla: l'esecuzione, la richiesta di modifica o la discussione. Segna tutto come letto si trova nell'intestazione del pannello, e passando il mouse su una riga non letta compare un pulsante Segna come letto per quelle che vuoi togliere di mezzo senza aprirle. Quando non c'è niente, il pannello lo dice: «Niente ti sta aspettando».

Che cosa invia una notifica

Tre fonti, e l'elenco completo è abbastanza corto da poterlo stampare.

Le esecuzioni gestite dell'agente notificano la persona che ha avviato l'esecuzione.

Un'esecuzione annullata non invia nulla. Qualcuno ha scelto di fermarla, e a quel qualcuno non serve dirlo.

Le richieste di modifica dell'architettura notificano in due direzioni. Quando ne viene aperta una, vengono avvisati tutti quelli che possono modificare il progetto, tranne il suo autore. Rivedere richiede i permessi di modifica, quindi sono quelle le persone che la richiesta aspetta. Da lì in poi, l'autore viene a sapere che cosa le succede:

Le discussioni notificano le risposte. Una risposta raggiunge la persona che ha avviato la discussione e tutti quelli che vi hanno già risposto, con la risposta come estratto. Il link apre la discussione, non la singola risposta, così atterri sull'intero thread.

Una regola vale per tutte e tre: non ricevi mai notifiche delle tue stesse azioni. Approva la richiesta di modifica della tua collega e lei lo viene a sapere. Tu no.

Perché non è un feed di attività

Il modo ovvio di costruire tutto questo è prendere la cronologia delle modifiche che Archyl già registra e mostrarla sotto una campanella. Non l'abbiamo fatto, di proposito.

La cronologia di un'organizzazione è per lo più il lavoro degli altri che procede bene. Qualcuno ha rinominato un container, qualcuno ha aggiunto una relazione, la discovery ha proposto dodici componenti e un collega li ha approvati. È tutto vero e quasi niente ha bisogno di te. Metti tutto questo sotto un contatore dei non letti e il contatore smette di significare qualcosa. La maggior parte di noi ha una campanella così in qualche altro strumento, con sopra un numero che abbiamo smesso di leggere da tempo.

Per questo la inbox ha un test stretto per ciò che entra. O la cosa è bloccata finché non agisci (la domanda di un agente, un piano, una richiesta di modifica che puoi rivedere), oppure è la risposta a qualcosa che hai avviato tu (una revisione della tua richiesta, la fine della tua esecuzione, una risposta nella tua discussione). Una modifica che non supera nessuno dei due test non ottiene una riga.

La vista ampia esiste ancora e non è cambiata. Le notifiche via email e la pagina Cronologia restano il posto per l'attività di tutta l'organizzazione. La inbox è l'altra metà: la parte indirizzata a te.

Alcuni dettagli

Ogni organizzazione ha la propria inbox. Se appartieni a due, la campanella conta ed elenca quella in cui ti trovi in quel momento.

Le frasi seguono la tua lingua, gli estratti no. L'app è disponibile in nove lingue, e la frase di ogni riga viene resa nella lingua della tua interfaccia. Una notifica memorizza ciò che è successo, non una stringa inglese già pronta, quindi un revisore che lavora in francese e un autore che lavora in giapponese leggono ciascuno «ha chiesto modifiche» nella propria lingua. L'estratto sono le parole di qualcuno, e resta nella lingua in cui sono state scritte.

Ciò che una notifica copia è protetto come la sua fonte. Una riga ripete il titolo di una richiesta di modifica o un pezzo di un commento. Dove questi sono cifrati a riposo, come avviene su Archyl Cloud, la copia nella inbox è cifrata allo stesso modo.

Il contatore funziona in polling, non in push. Il contatore dei non letti si aggiorna ogni 30 secondi, e di nuovo quando torni sulla scheda. Una nuova notifica può quindi impiegare fino a mezzo minuto per comparire sulla campanella. Per «un revisore vuole modifiche» è abbastanza presto, e risparmia a ogni scheda aperta una connessione di lunga durata. Segnare qualcosa come letto aggiorna subito il contatore nel tuo browser.

Che cosa non fa ancora

Le richieste di modifica aperte da un agente tramite il server MCP non notificano i revisori. Una richiesta aperta nell'app lo fa. Quella che un agente apre tramite MCP compare nell'elenco del progetto, e la campanella di nessuno si muove.

Nessuna impostazione per tipo. Non puoi disattivare un tipo di notifica. L'elenco qui sopra è ciò che ricevi.

Nessuna @menzione. Nominare qualcuno in un commento non gli invia una notifica. Oggi vengono a sapere delle risposte solo le persone già presenti in una discussione. Le menzioni sono il prossimo punto della roadmap per la inbox, e non diamo loro una data.

Dove trovarla

Non c'è niente da configurare. La campanella è all'estremità destra dell'header, e resterà vuota finché qualcosa non sarà indirizzato a te. Il modo più rapido per vederla funzionare: avvia un'esecuzione gestita su un profilo con Rivedi prima il piano attivato, passa a un'altra pagina e aspetta il contatore.

Se avvii le esecuzioni dalla chat, questo si affianca agli aggiornamenti nel thread anziché sostituirli. Un'esecuzione avviata da Slack o Teams continua a riferire nel suo thread, e chi l'ha avviata riceve anche la riga nella inbox.

Letture correlate: rivedere un agente mentre lavora, per i piani e le domande su cui un'esecuzione resta in attesa, e le richieste di modifica dell'architettura, per il workflow di revisione che queste notifiche seguono.