Proposte e convalida
Panoramica
Quando ElevenAgents Architect completa una modifica, te la presenta come una proposta: un branch che contiene la modifica, test che dimostrano che funziona e una proposta di merge che richiede di unire quel branch a main. Questa pagina spiega come funziona ogni parte, dove trovarla e come una proposta passa da una conversazione al traffico live.
Cos’è una proposta
Una proposta si basa sul modello di versioning esistente:
La proposta di merge è una normale proposta di merge di ElevenAgents, dello stesso tipo che un membro del team apre manualmente. Non è un tipo di oggetto separato.
Una proposta di merge riguarda esattamente un branch di origine e un branch di destinazione, quindi una proposta contiene una sola soluzione candidata. Per confrontare alternative, chiedi ad Architect di inserire ciascuna nel proprio branch. Ogni branch avrà quindi la sua proposta e potrai suddividere il traffico tra di essi come esperimento.
Architect agisce per tuo conto, quindi una proposta di merge che apre viene registrata a tuo nome come autore. Nessun campo indica che è stata creata da Architect. Indicalo nella descrizione della proposta se il tuo team desidera saperlo.
Come viene creata una proposta
Architect crea una proposta quando gli chiedi di correggere o migliorare qualcosa, oppure quando gli fornisci un test non riuscito, un risultato di Spotlight o un problema. La sequenza completa, con gli strumenti che Architect richiama a ogni passaggio, è nell’esempio pratico. In breve:
- Architect analizza il problema, crea un branch e prepara la modifica nella tua bozza su quel branch.
- Architect scrive test e simulazioni per la modifica e li esegue nella conversazione prima di mostrarti il risultato.
- Architect apre la finestra di pubblicazione. Rivedi il diff e selezioni Pubblica, che salva la modifica come nuova versione sul branch.
- Architect apre una proposta di merge in
main, scrivendo la descrizione in base ai commit effettivi del branch e alle esecuzioni dei test. - Architect ti propone di inviare una piccola quota di traffico live al branch durante la revisione della proposta. Serve la tua approvazione.
Puoi interromperti a qualsiasi passaggio. Un branch con una versione pubblicata ma senza proposta di merge è comunque utile: puoi testarlo personalmente o aprire una proposta in seguito.
Convalida nella conversazione
Architect scrive ed esegue i test durante la creazione della modifica, non come passaggio separato che avvii successivamente. Per una correzione, un approccio utile consiste nel dimostrare che i nuovi test non riescono senza la modifica e riescono con essa. Architect può eseguire gli stessi test sul branch originale e sulla bozza che contiene la modifica.
Architect non esegue automaticamente questo controllo prima-e-dopo per ogni modifica. Chiediglielo quando è importante, ad esempio: “Mostrami la nuova simulazione che non riesce su main e riesce sul branch, poi apri una proposta.”
Un test riesce quando tutte le condizioni di successo sono soddisfatte. Per un test LLM, la risposta dell’agente soddisfa i criteri di successo. Per un test di chiamata di uno strumento, viene chiamato lo strumento previsto con i parametri previsti. Per una simulazione, la conversazione simulata soddisfa le relative condizioni di successo. Per verificare risultati instabili, chiedi ad Architect di eseguire i test più volte. Può ripetere ogni test fino a 50 volte e segnalare il tasso di successo.
Consulta Test per sapere come viene definito ogni tipo di test.
Dove trovare le proposte
Apri l’agente, poi vai su Controllo versione > Proposte. L’elenco può essere filtrato per stato, autore (Creato da) e revisore (In attesa di revisione da parte di, Revisionato da). Una proposta aperta da Architect nella tua conversazione è elencata con te come autore.
Architect restituisce anche un link alla proposta nella conversazione non appena la crea.

Anatomia di una proposta
La pagina di una proposta mostra i branch di origine e di destinazione, il suo stato, se può essere unita e quanto il branch di origine è indietro o avanti rispetto alla destinazione. Include queste schede:
Panoramica
Modifiche
Esecuzioni dei test
Conversazioni
La descrizione, una cronologia delle attività dei commit sul branch di origine, revisioni, commenti e una casella per i commenti. La barra laterale mostra i revisori, i revisori consigliati e gli eventuali problemi collegati.
Una descrizione scritta da Architect ha sempre tre sezioni: Riepilogo (ogni modifica significativa e il relativo motivo), Test (quali test sono stati eseguiti e i relativi risultati, oppure l’indicazione che non ne è stato eseguito alcuno) e Come revisionare (su cosa concentrarsi e un test da eseguire o una conversazione da provare).

Revisione e merge
Stati
Una proposta di merge ha uno di questi stati:
Mentre una proposta è aperta, l’ultima revisione di ciascun revisore è Approvata oppure Modifiche richieste. Non esistono stati separati “testato” o “pronto per la revisione”. I risultati dei test vengono invece mostrati nella scheda Esecuzioni dei test.
Le revisioni e i commenti vengono visualizzati nella cronologia delle attività della scheda Panoramica, insieme a ogni nuova versione salvata nel branch di origine.

Chi può approvare ed eseguire il merge
- Chiunque abbia accesso come editor all’agente può revisionare una proposta, tranne il suo autore. Poiché Architect agisce per tuo conto, non puoi approvare una proposta che Architect ha aperto nella tua conversazione. Deve farlo un membro del team.
- Una proposta può essere unita quando ha almeno un’approvazione da una persona diversa dall’autore e l’ultima revisione di nessun revisore è Modifiche richieste. Gli amministratori del workspace possono eseguire il merge senza un’approvazione.
- Il merge in un branch protetto richiede autorizzazioni di amministratore o l’approvazione di un amministratore.
Architect non può approvare, commentare, unire o chiudere una proposta di merge. Questi passaggi vengono sempre eseguiti da persone. Consulta Proposte di merge per le regole complete di revisione.
Architect può unire direttamente un branch, senza una proposta, quando glielo chiedi e il tuo ruolo consente
il merge. In modalità Approvazione richiesta chiede prima. In modalità Approvazione automatica non lo fa. Usa
la protezione del branch su main se ogni modifica deve passare attraverso una proposta revisionata.
Cosa accade durante il merge
Non è previsto un passaggio di pubblicazione separato dopo un merge. Il merge crea una nuova versione sul branch di destinazione, e quella versione serve immediatamente il traffico live per la quota di traffico ricevuta dalla destinazione. Quando la destinazione è main e non è impostata alcuna suddivisione del traffico, significa tutti gli utenti.
Il merge inoltre:
- Sposta al branch di destinazione qualsiasi quota di traffico live avuta dal branch di origine.
- Archivia il branch di origine per impostazione predefinita.
- Chiude qualsiasi altra proposta aperta dallo stesso branch.
- Risolve il problema collegato, se presente.
Rollout graduale
Prima del merge di una proposta, puoi inviare una quota di traffico live al relativo branch in modo che utenti reali testino la modifica.
Avvia la suddivisione
Chiedi ad Architect, ad esempio “Invia il 5% del traffico a questo branch.” Architect ti indica la
suddivisione finale completa, inclusa la quota di main, e chiede la tua approvazione prima di applicarla. Puoi
anche impostarla personalmente: in Controllo versione > Branch, seleziona Distribuisci sul branch.
Le quote di traffico devono sempre totalizzare il 100% e il routing è deterministico per conversazione. Modificare la quota di un branch protetto, incluso sottrarre traffico a un main protetto, richiede un amministratore. Consulta Deployment del traffico.
Proposte proattive
Architect crea proposte quando glielo chiedi o quando gli fornisci un test non riuscito, un risultato di Spotlight, un avviso o un problema. Non analizza ancora i tuoi agenti a intervalli programmati né apre proposte autonomamente.
Il percorso proattivo attuale è Spotlight, seguito da un passaggio di consegne. Spotlight monitora continuamente le conversazioni del tuo agente. Produce un riepilogo settimanale con analisi suggerite, genera avvisi in tempo reale e consiglia modifiche alla configurazione. Per trasformare un risultato di Spotlight in una proposta:
Scegli un risultato
Apri il riepilogo settimanale e rivedi i Passaggi successivi suggeriti, oppure apri un avviso in tempo reale.
Passalo a ElevenAgents Architect
Seleziona Apri in Architect su un suggerimento, Analizza con Architect sul riepilogo o Esamina con Architect su un avviso. Architect riceve il risultato e viene istruito a verificarlo rispetto alle conversazioni reali e a identificare quale branch è interessato prima di suggerire una modifica.
I problemi funzionano allo stesso modo. Il tuo agente live può segnalare problemi per la revisione durante le conversazioni e Discuti con Architect su un problema avvia un’analisi dello stesso.
Le automazioni pianificate, con report consegnati a una casella di posta di Architect, sono in fase di sviluppo. La scheda Posta in arrivo nella pagina Architect è un segnaposto per tali funzionalità.