Testare l'Azione con gli utenti ti offre l'opportunità di ricevere feedback tempestivi e di risolvere eventuali problemi tecnici o relativi all'esperienza utente prima del rilascio ufficiale.
La console di Actions supporta gli ambienti di rilascio in modo che tu possa concedere a un gruppo limitato di utenti l'accesso per testare una nuova azione o una versione più recente dell'azione esistente prima di distribuirla al pubblico.
Ciclo di vita di una release
Il seguente diagramma mostra i potenziali percorsi che il ciclo di vita di un'azione può intraprendere:
![Diagramma che mostra i possibili percorsi del ciclo di vita del rilascio di un'azione](https://developers.google.cn/static/assistant/console/images/release/release-001.png?authuser=5&hl=it)
Esistono due tipi di ambienti di rilascio di pre-produzione supportati dalla console di Actions:
Alpha: questo canale deve essere utilizzato per testare rapidamente le prime versioni dell'Azione.
- Consente di distribuire l'Azione a un piccolo gruppo di utenti senza dover superare una revisione completa da parte di Google.
- Agli utenti vengono inviati avvisi che informano che l'Azione non è stata sottoposta a una revisione da parte di Google per verificare la conformità alle norme.
- Ideale per test interni.
Beta: questo canale consente di distribuire un'azione a un gruppo limitato di utenti dopo aver superato una revisione completa da parte di Google.
- Dovresti usare questo canale per consentire agli utenti esterni alla tua organizzazione di accedere alle versioni in anteprima dell'Azione.
- Gli utenti verranno informati che l'Azione è una versione di anteprima.
- Poiché la versione beta ha superato la revisione di Google, puoi scegliere di renderla pubblica in qualsiasi momento senza un'altra revisione da parte di Google.
Confronto dell'ambiente di rilascio
La tabella riportata di seguito riassume le differenze tra i canali di deployment.
Simulatore | Alpha | Beta | Produzione | |
---|---|---|---|---|
Pubblico di destinazione | Solo sviluppatore | I primi tester nel tuo team, con amici e familiari | Tester esterni al tuo team | Tutti gli utenti dell'Assistente Google |
Richiede la revisione da parte di Google | No | No | Sì | Sì |
Chi ha accesso | Solo sviluppatore | Elenco di utenti definito dallo sviluppatore. Gli utenti devono attivare questa opzione. | Elenco di utenti definito dallo sviluppatore. Gli utenti devono attivare questa opzione. | Disponibile pubblicamente per tutti gli utenti dell'Assistente Google |
N. massimo di utenti | 1 | 20 | 200 | N/A |
Paesi in cui è disponibile la funzione | Simulatore e tutti i dispositivi con l'assistente | Tutti i dispositivi con l'assistente | Tutti i dispositivi con l'assistente | Tutti i dispositivi con l'assistente |
Generatore di azioni | Prove di supporto | Prove di supporto | Prove di supporto | Sì |
SDK Actions | Prove di supporto | Prove di supporto | Prove di supporto | Sì |
Dialogflow | Prove di supporto | Prove di supporto | Prove di supporto | Sì |
Smart home | Supportato (è necessario il collegamento dell'account) | Non supportata | Non supportata | Sì |
Modelli | Prove di supporto | Non supportata | Non supportata | Sì |
Chiamata esplicita | Prove di supporto | Prove di supporto | Prove di supporto | Sì |
chiamata implicita | Prove di supporto | Prove di supporto | Prove di supporto | Sì |
Collegamento degli account | Prove di supporto | Prove di supporto | Prove di supporto | Sì |
Gestire i test delle versioni alpha o beta
Per configurare i test per le versioni alpha o beta, procedi nel seguente modo:
- Fai clic su Gestisci alpha tester o Gestisci beta tester.
Digita gli indirizzi email dei tester, separati da virgole. Puoi specificare fino a 20 tester per gli alpha test e fino a 200 tester per i beta test.
Copia il link di attivazione per condividerlo con i tester.
Fai clic su Salva.
Devi inviare un'email di invito ai tester con un link alla versione alpha o beta dell'Azione (il link di attivazione). Per scoprire di più, vedi Ricevere feedback.
Link di attivazione
Il link di attivazione rappresenta la pagina della directory Azioni e non cambia mai. Il link indirizza i tester alla pagina della directory e visualizza la scheda di attivazione per l'ambiente idoneo. Se hai elencato gli stessi tester per le versioni alpha e beta, questi sono idonei per entrambi e vedranno prima una scheda per l'attivazione della versione alpha.
Implementare il fulfillment per una release alpha o beta
Le informazioni sul canale di rilascio non sono incluse nella richiesta HTTP inviata dall'assistente al fulfillment. Per gestire i canali di rilascio nel fulfillment, devi fornire diversi URL di fulfillment, ad esempio un URL per la versione beta e un altro per la versione di produzione dell'Azione.
Chiedi un feedback
Una volta che l'Azione è stata rilasciata sul canale delle versioni alpha o beta, devi invitare i tester condividendo il tuo link di attivazione (che è uguale all'elenco della directory dell'assistente).
Assicurati di indicare ai tester che devono:
- Scaricare l'app Assistente Google sui dispositivi mobili per eseguire gli alpha o beta test.
- Accedi all'app Assistente Google utilizzando lo stesso account che hai designato come alpha o beta tester.
Dopo che hai eseguito il deployment dell'Azione, i nuovi tester devono attendere almeno tre ore prima di poter accedere all'Azione utilizzando il link di attivazione.
Quando gli utenti fanno clic su questo link, vengono indirizzati alla pagina della directory delle azioni corrispondente. Dovrebbe fare clic sul pulsante Accetto nella parte inferiore della pagina della directory dell'azione per attivare la funzionalità come tester per la prima volta.
Dopo l'attivazione da parte del tester sul telefono, l'Azione è immediatamente disponibile su tutti i dispositivi. I tester vedranno l'azione nella sezione Le mie app dell'app Assistente Google contrassegnata con una delle seguenti modalità: Alpha, Beta o Nessun test. L'opzione Nessun test mostrerà agli utenti la versione di produzione dell'Azione, se disponibile. Se non è disponibile una versione di produzione, agli utenti non verrà fornito nulla.
best practice
- Assicurati che gli utenti possano partecipare ai test. Per partecipare a un test, i tester devono avere un account Google (@gmail.com) o un account G Suite.
- Scegli il tipo di test appropriato. Un gruppo di alpha test deve essere di piccole dimensioni e testare le versioni sperimentali meno stabili delle azioni (ad esempio all'interno dell'azienda o del team). Usa i beta test con un gruppo più ampio per testare versioni stabili delle tue azioni in prossimità della release.
- Metti a disposizione dei tester un canale per inviarti feedback. I canali Alpha e Beta sono disponibili solo per i tester. Assicurati di offrire loro la possibilità di fornire feedback via email, su un sito web, in un forum per i messaggi o tramite un altro meccanismo adatto.
- Esegui test simultanei sulla stessa azione. Puoi eseguire contemporaneamente gli alpha e i beta test.
Problemi noti
- La directory dell'assistente per il web non è supportata per l'attivazione della versione alpha o beta. Assicurati che i tester seguano il link sui propri dispositivi mobili (Android o iOS).
- Potrebbero essere necessarie alcune ore prima che le modifiche vengano pubblicate. Attendi un determinato periodo di tempo prima di condividere il link di attivazione con i tuoi utenti.
Creare una nuova release alpha o beta
Per eseguire il deployment dell'Azione sul canale di rilascio Alpha o Beta, procedi nel seguente modo:
- Nella console di Actions, fai clic su Esegui il deployment > Release.
Fai clic su Avvia nuova release.
Seleziona Alpha o Beta e fai clic su Invia.
Se richiesto, indica di aver completato i passaggi richiesti nell'elenco di controllo Requisiti per la revisione dell'azione.
Se applicabile al tuo progetto, seleziona le lingue per la release.
Fai clic su Invia.
Una volta inviata, la versione alpha o beta viene visualizzata nella sezione Gestisci le versioni.
Eseguire l'upgrade di una release esistente da alpha o beta alla versione di produzione
Le release di produzione possono essere un'implementazione completa per tutti gli utenti dell'Assistente Google o un'implementazione graduale in regioni specifiche o per una percentuale di utenti. Le implementazioni graduali aiutano a testare la stabilità del tuo progetto di azione. È preferibile distribuire il prodotto a un piccolo gruppo di utenti e apportare aumenti graduali fino a raggiungere il 100% degli utenti. In questo modo, puoi risolvere i bug prima di renderli disponibili all'intera base utenti.
Implementazione graduale
Le implementazioni graduali consentono agli sviluppatori di gestire le proprie release di produzione lanciandole a un sottoinsieme di utenti e gradualmente estendendole a tutti gli utenti. Puoi aumentare gradualmente le regioni o la percentuale di utenti nell'implementazione.
Per implementare l'Azione come implementazione graduale, segui questi passaggi:
- In Gestisci le release, seleziona la versione di cui eseguire l'upgrade all'implementazione di produzione.
- Fai clic su Gestisci deployment.
- Seleziona Esegui il deployment in produzione.
- Seleziona Implementazione graduale.
- Fai clic su Seleziona il tipo di implementazione.
Seleziona Località specificate o Percentuale di utenti. Per saperne di più su questa selezione, consulta Implementazione per località specificate o Implementazione per percentuale della base utenti.
Fai clic su Invia.
Per avanzare nella fase dell'implementazione, consulta la pagina Procedere con l'implementazione di una release.
Implementazione completa
Se selezioni questa opzione, il progetto di azione viene rilasciato a tutti gli utenti in tutti i paesi target.
Per eseguire il deployment dell'azione come implementazione completa, segui questi passaggi:
- In Gestisci le release, seleziona la versione di cui eseguire l'upgrade all'implementazione di produzione.
Fai clic su Gestisci deployment.
Seleziona Esegui il deployment in produzione.
Seleziona Implementazione completa.
Fai clic su Invia.
Creare una nuova release di produzione senza alpha o beta test
Le release di produzione possono essere un'implementazione completa per tutti gli utenti dell'Assistente Google o un'implementazione graduale in regioni specifiche o per una percentuale di utenti. Le implementazioni graduali aiutano a testare la stabilità del tuo progetto di azione. È preferibile distribuire il prodotto a un piccolo gruppo di utenti e apportare aumenti graduali fino a raggiungere il 100% degli utenti. In questo modo, puoi risolvere i bug prima di renderli disponibili all'intera base utenti.
Implementazione graduale
Le implementazioni graduali consentono agli sviluppatori di gestire le proprie release di produzione lanciandole a un sottoinsieme di utenti e gradualmente estendendole a tutti gli utenti. Puoi aumentare gradualmente le regioni o la percentuale di utenti nell'implementazione.
Per implementare l'Azione come implementazione graduale, segui questi passaggi:
- Nella console di Actions, fai clic su Esegui il deployment > Release.
Fai clic su Avvia nuova release.
Seleziona Produzione.
Se richiesto, indica di aver completato i passaggi richiesti nell'elenco di controllo Requisiti per la revisione dell'azione.
Se applicabile al tuo progetto, seleziona le lingue per la release.
Seleziona Implementazione graduale.
Fai clic su Seleziona il tipo di implementazione.
Seleziona Località specificate o Percentuale di utenti. Per saperne di più su questa selezione, consulta Implementazione per località specificate o Implementazione per percentuale della base utenti.
Fai clic su Invia.
Implementazione per località specificate
Se selezioni questa opzione, il progetto di azione verrà rilasciato nei paesi o nelle regioni scelti da te.
Per implementare l'Azione in base alla località:
- Fai clic su Seleziona paesi o regioni e seleziona le caselle corrispondenti alle regioni da scegliere come target per la release.
Fai clic su Invia.
Implementazione per percentuale della base utenti
Questa opzione rilascia l'Azione a una percentuale di utenti selezionati casualmente.
Per implementare l'Azione per una percentuale di utenti:
- Fai clic su Percentuale di utenti.
Seleziona la percentuale di utenti per i quali vuoi rilasciare l'Azione.
Fai clic su Invia.
Implementazione completa
Se selezioni questa opzione, il progetto di azione viene rilasciato a tutti gli utenti in tutti i paesi target.
Per eseguire il deployment dell'azione come implementazione completa, segui questi passaggi:
- Nella console di Actions, fai clic su Esegui il deployment > Release.
Fai clic su Avvia nuova release.
Seleziona Produzione.
Se richiesto, indica di aver completato i passaggi richiesti nell'elenco di controllo Requisiti per la revisione dell'azione.
Se applicabile al tuo progetto, seleziona le lingue per la release.
Seleziona Implementazione completa.
Fai clic su Invia.
Una volta inviata, la versione di produzione viene visualizzata nella sezione Gestisci le versioni.
Modificare o annullare il deployment di una release
Dopo aver inviato l'Azione a un canale di rilascio, puoi comunque apportare modifiche. Puoi testare la versione attuale, ritirare la versione dalla revisione, visualizzare i dettagli della release, gestire i deployment, annullare il deployment ed eseguire l'upgrade delle fasi di implementazione. Qui puoi anche visualizzare i dettagli delle release precedenti.
Visualizzare e modificare una release
Per visualizzare i dettagli della release o apportare modifiche alla release dell'Azione, procedi nel seguente modo:
- In Gestisci le release, seleziona la versione sotto Nome release.
- Scegli Modifica implementazione, Gestisci i deployment o Visualizza altro.
Avanzare nella fase di implementazione di una release
Per avanzare nella fase di implementazione dell'Azione, segui questi passaggi:
- In Gestisci release, seleziona la versione di cui eseguire l'upgrade.
- Fai clic sul pulsante Modifica implementazione.
- Apporta le modifiche all'implementazione. Ad esempio, potresti voler far avanzare la base utenti dal 5% al 20%.
- Fai clic su Invia.
Annulla deployment dalla produzione
- Se devi portare offline l'implementazione graduale, fai clic su Modifica implementazione in Gestisci le release. Puoi cancellare tutte le regioni o selezionare lo 0%, a seconda che l'implementazione sia in base alla località o alla percentuale della base utenti.
- Per annullare il deployment di un'azione completamente implementata (100% della base utenti), fai clic sul pulsante Gestisci deployment in Gestisci le release e seleziona Annulla deployment dalla produzione.