Versioni e ambienti

Puoi creare più versioni dell'agente e pubblicarle in ambienti separati.

Quando modifichi un agente, modifichi l'agente di bozza. In qualsiasi momento puoi salvare l'agente di bozza come versione dell'agente, ovvero uno snapshot immutabile dell'agente.

Quando salvi l'agente di bozza, questo viene pubblicato nell'ambiente predefinito. Quando crei le versioni dell'agente, puoi pubblicarle in ambienti personalizzati. Puoi creare una serie di ambienti personalizzati per:

• test
• sviluppo
• produzione
• e così via

Traffico di produzione

Utilizza sempre le versioni dell'agente per il traffico di produzione

Un agente di bozza viene aggiornato ogni volta che uno sviluppatore del tuo team apporta una modifica. È facile danneggiare un agente di bozza involontariamente, soprattutto se più persone hanno accesso in scrittura all'agente. Inoltre, un agente di bozza modificato di recente potrebbe non essere coerente con il modello addestrato, poiché l'addestramento potrebbe avere un ritardo o richiedere l'esecuzione manuale.

Devi sempre utilizzare le versioni dell'agente per il traffico di produzione. Gli agenti di bozza devono essere testati prima di essere promossi a versioni di produzione e puoi eseguire il rollback a una versione precedente se vengono rilevati problemi.

Considera i possibili errori dell'agente durante la modifica delle versioni

Se modifichi una versione dell'agente nell'ambiente di produzione mentre le sessioni sono attive, potresti causare errori dell'agente per alcune sessioni attive. Questi errori possono verificarsi se le versioni precedente e nuova non sono coerenti tra loro in modo da interrompere lo stato della sessione. Per questo motivo, è consigliabile pianificare la modifica delle versioni durante il tempo di riposo o le ore di punta.

Pubblicare una versione in un nuovo ambiente

Per pubblicare una bozza di agente in una versione e creare un ambiente personalizzato:

Console

1. Vai alla console Dialogflow ES.
2. Seleziona il tuo agente nella parte superiore del menu della barra laterale sinistra.
3. Fai clic sul pulsante delle impostazioni accanto al nome dell'agente.
4. Fai clic sulla scheda Ambientazioni.
5. Fai clic su Pubblica una versione.
6. Aggiungi una descrizione facoltativa e fai clic su Avanti.

7. Seleziona +Nuova ambientazione.

   Nota: puoi creare una versione dell'agente senza pubblicarla selezionando Crea versione senza pubblicazione dal menu dell'ambiente.

8. Inserisci un nome per l'ambiente.

9. Scegli il metodo di adempimento per l'ambiente.

10. Seleziona le impostazioni di sintesi vocale per l'ambiente.

11. Fai clic su Pubblica.

12. Le informazioni sull'ambiente ora sono elencate nella sezione Ambienti personalizzati.

API

1. Chiama il metodo create per il tipo di versione per creare una nuova versione dell'agente.
2. Chiama il metodo create per il tipo di ambiente per creare un nuovo ambiente. Fornisci la versione dell'agente appena creata nel campo agentVersion.

Ripristinare un ambiente a una versione precedente

Puoi ripristinare un ambiente a una versione dell'agente precedente:

Console

1. Fai clic su un ambiente nella sezione Ambienti personalizzati.
2. Viene visualizzata la finestra di dialogo delle impostazioni dell'ambiente.
3. Fai clic sul pulsante di opzione per una versione pubblicata in precedenza nella sezione Cronologia delle pubblicazioni.
4. Fai clic su Ripristina questa versione.
5. La cronologia delle pubblicazioni verrà aggiornata.

API

Chiama il metodo patch/update per il tipo di ambiente per aggiornare un ambiente. Fornisci la versione dell'agente creata in precedenza nel campo agentVersion.

Caricare una versione precedente nella bozza

Il caricamento di una versione precedente in bozza sovrascrive l'agente della bozza nell'ambiente predefinito con una versione dell'agente selezionata.

Attenzione: il caricamento di una versione precedente nella bozza annulla tutte le modifiche recenti apportate alla bozza e non può essere annullato. Ti consigliamo di salvare la bozza in una versione prima di svolgere questi passaggi.

Per caricare una versione precedente come bozza:

Console

1. Vai alla console Dialogflow ES.
2. Seleziona il tuo agente nella parte superiore del menu della barra laterale sinistra.
3. Fai clic sul pulsante delle impostazioni accanto al nome dell'agente.
4. Fai clic sulla scheda Ambientazioni.
5. Fai clic su Visualizza tutte le versioni nella sezione Bozza.
6. Fai clic sul pulsante dell'opzione per una versione che vuoi caricare nella bozza.
7. Fai clic su Carica in Bozze.
8. Fai clic su Sì, confermo.
9. Ricarica le schede del browser della console aperte, in modo che vengano aggiornate con i dati più recenti dell'agente.

API

Chiama il metodo patch/update per il tipo di ambiente con i seguenti input:

• Utilizza - come ID ambiente per specificare l'ambiente predefinito.
• Imposta allowLoadToDraftAndDiscardChanges su true.
• Per il campo agentVersion, fornisci la versione dell'agente che sovrascriverà l'agente di bozza.

Esportare una versione

Per esportare una versione, devi prima caricarla in bozza, quindi esportare l'agente.

Testare l'agente in un ambiente

Puoi utilizzare l'API per testare l'agente in uno qualsiasi dei tuoi ambienti personalizzati. Chiama il metodo detect intent, ma modifica l'URL dell'endpoint inserendo environments/environment-name/users/-/ tra agent e sessions.

Ad esempio, il seguente endpoint utilizza l'ambiente "sviluppo" con un utente non specificato:

"https://dialogflow.googleapis.com/v2/projects/my-project-id/agent/environments/development/users/-/sessions/123456789:detectIntent"

Impostazioni specifiche per l'ambiente

L'evasione degli ordini e la conversione di testo in voce sono configurate dall'ambiente, quindi l'agente utilizzerà le impostazioni dell'ambiente per queste funzionalità.

Per ulteriori informazioni su come vengono applicati i dati a vari livelli, consulta Livelli di applicazione degli agenti.

Assistente Google

Se utilizzi gli ambienti di rilascio di Actions on Google, consulta le limitazioni del controllo delle versioni per la libreria di adempimento Dialogflow.

Mega-agente

Scopri come funzionano le versioni e gli ambienti nei mega agenti.

Limitazioni

Si applicano le seguenti limitazioni:

• Numero massimo di ambienti per agente: 10
• Numero massimo di versioni per agente: 1000