Rilascia l'azione

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:

Figura 1. Ciclo di vita di un'azione con ambienti di release.

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.

Nota: puoi rilasciare una sola versione alpha o beta "live" dell'Azione.

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ì

Nota: se utilizzi il controllo delle versioni di Dialogflow, puoi eseguire il deployment di versioni diverse in ambienti di release diversi. Per scoprire di più, consulta Inviare il progetto.

Gestire i test delle versioni alpha o beta

Per configurare i test per le versioni alpha o beta, procedi nel seguente modo:

1. Fai clic su Gestisci alpha tester o Gestisci beta tester.

2. 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.

   Nota :i tester devono avere un Account Google (@gmail.com) o Google Workspace. Non puoi designare più utenti tramite l'alias email di un gruppo Google.

   

3. Copia il link di attivazione per condividerlo con i tester.

4. 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.

Nota: gli utenti non possono valutare la tua Azione nell'app Assistente Google se utilizzano la versione alpha o beta. Fornisci invece ai tester un modo per fornire feedback via email, su un sito web, in un forum per i messaggi o tramite un altro meccanismo adatto.

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:

1. Nella console di Actions, fai clic su Esegui il deployment > Release.

2. Fai clic su Avvia nuova release.

   

3. Seleziona Alpha o Beta e fai clic su Invia.

4. Se richiesto, indica di aver completato i passaggi richiesti nell'elenco di controllo Requisiti per la revisione dell'azione.

5. Se applicabile al tuo progetto, seleziona le lingue per la release.

6. Fai clic su Invia.

Una volta inviata, la versione alpha o beta viene visualizzata nella sezione Gestisci le versioni.

Nota: dopo il deployment, la versione rimarrà in stato Deployment per un massimo di 3 ore prima di essere disponibile per gli utenti. Una volta completato il deployment, le altre versioni attive nell'ambiente di rilascio vengono rimosse.

Nota: se sei uno sviluppatore del progetto, la versione di test è abilitata per impostazione predefinita sul tuo dispositivo. Se vuoi accedere alle versioni alpha e beta, disattiva l'opzione Test sul dispositivo nel simulatore della console di Actions.

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.

Nota: indipendentemente dal fatto che sia stata rilasciata come implementazione completa o graduale, l'Azione è necessaria per superare un processo di revisione prima di eseguirne il deployment in produzione. È necessaria una sola revisione; tuttavia, se l'Azione viene modificata, deve essere esaminata di nuovo. Per poter avviare una revisione, devi inviare una nuova versione dell'Azione in versione beta o in produzione.

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.

Nota: non puoi selezionare una percentuale di utenti all'interno della regione selezionata. Non puoi cambiare il tipo di gestione temporanea (località o percentuale di utenti) quando esegui l'upgrade di una release in corso. Se vuoi modificare il tipo di gestione temporanea, devi annullare la release e avviarne una nuova. Nel canale di implementazione graduale può essere attiva una sola versione.

Per implementare l'Azione come implementazione graduale, segui questi passaggi:

1. In Gestisci le release, seleziona la versione di cui eseguire l'upgrade all'implementazione di produzione.
2. Fai clic su Gestisci deployment.
3. Seleziona Esegui il deployment in produzione.
4. Seleziona Implementazione graduale.
5. Fai clic su Seleziona il tipo di implementazione.

6. 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.

   

7. 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:

1. In Gestisci le release, seleziona la versione di cui eseguire l'upgrade all'implementazione di produzione.

2. Fai clic su Gestisci deployment.

   

3. Seleziona Esegui il deployment in produzione.

4. Seleziona Implementazione completa.

5. 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.

Nota: indipendentemente dal fatto che sia stata rilasciata come implementazione completa o graduale, l'Azione è necessaria per superare un processo di revisione prima di eseguirne il deployment in produzione. È necessaria una sola revisione; tuttavia, se modifichi l'Azione e la rilasci in produzione, questa dovrà essere esaminata di nuovo. Per avviare una revisione, devi inviare una nuova versione dell'Azione in versione beta o in produzione.

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.

Nota: non puoi selezionare una percentuale di utenti all'interno della regione selezionata. Non puoi cambiare il tipo di gestione temporanea (località o percentuale di utenti) quando esegui l'upgrade di una release in corso. Se vuoi modificare il tipo di gestione temporanea, devi annullare la release e avviarne una nuova. Nel canale di implementazione graduale può essere attiva una sola versione.

Per implementare l'Azione come implementazione graduale, segui questi passaggi:

1. Nella console di Actions, fai clic su Esegui il deployment > Release.

2. Fai clic su Avvia nuova release.

   

3. Seleziona Produzione.

4. Se richiesto, indica di aver completato i passaggi richiesti nell'elenco di controllo Requisiti per la revisione dell'azione.

5. Se applicabile al tuo progetto, seleziona le lingue per la release.

6. Seleziona Implementazione graduale.

7. Fai clic su Seleziona il tipo di implementazione.

8. 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.

   

9. 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à:

1. Fai clic su Seleziona paesi o regioni e seleziona le caselle corrispondenti alle regioni da scegliere come target per la release.

2. Fai clic su Invia.

   Nota: sono consentite solo le regioni che hai selezionato nel targeting per località.

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:

1. Fai clic su Percentuale di utenti.

2. Seleziona la percentuale di utenti per i quali vuoi rilasciare l'Azione.

   

3. Fai clic su Invia.

   Nota: puoi ripristinare questo tipo di release impostando la percentuale su 0%.

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:

1. Nella console di Actions, fai clic su Esegui il deployment > Release.

2. Fai clic su Avvia nuova release.

   

3. Seleziona Produzione.

4. Se richiesto, indica di aver completato i passaggi richiesti nell'elenco di controllo Requisiti per la revisione dell'azione.

5. Se applicabile al tuo progetto, seleziona le lingue per la release.

6. Seleziona Implementazione completa.

7. Fai clic su Invia.

Una volta inviata, la versione di produzione viene visualizzata nella sezione Gestisci le versioni.

Nota: dopo il deployment, la versione rimarrà in stato Deployment per un massimo di 3 ore prima di essere disponibile per gli utenti. Una volta completato il deployment, verrà annullato automaticamente il deployment delle altre versioni attive in quell'ambiente di rilascio.

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:

1. In Gestisci le release, seleziona la versione sotto Nome release.
2. 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:

1. In Gestisci release, seleziona la versione di cui eseguire l'upgrade.
2. Fai clic sul pulsante Modifica implementazione.
3. Apporta le modifiche all'implementazione. Ad esempio, potresti voler far avanzare la base utenti dal 5% al 20%.
4. 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.