Puoi creare più versioni dell'agente e pubblicarle in ambienti separati.
Quando modifichi un agente, modifichi la bozza dell'agente. In qualsiasi momento, puoi salvare la bozza dell'agente come versione dell'agente, ovvero uno snapshot immutabile dell'agente.
Quando salvi la bozza dell'agente, questa viene pubblicata nell'ambiente predefinito. Quando crei versioni dell'agente, puoi pubblicarle in ambienti personalizzati. Puoi creare una varietà di ambienti personalizzati per:
- test
- sviluppo
- produzione
- e così via
Traffico di produzione
Usa sempre le versioni dell'agente per il traffico di produzione
Ogni volta che uno sviluppatore del tuo team apporta una modifica, viene aggiornata una bozza di agente. È facile interrompere involontariamente un agente in versione bozza, soprattutto se più persone hanno accesso in scrittura all'agente. Inoltre, una bozza di agente modificata di recente potrebbe non essere coerente con il modello addestrato, perché 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 in versione bozza devono essere testati prima di promuoverli alle versioni di produzione ed è possibile eseguire il rollback a una versione precedente in caso di problemi.
Valuta i possibili errori dell'agente durante il cambio di versione
Se modifichi la versione di un agente nell'ambiente di produzione mentre le sessioni sono attive, l'agente potrebbe causare errori per alcune sessioni attive. Questi errori possono verificarsi se la nuova versione e la precedente sono incoerenti tra loro e questo compromette lo stato della sessione. Per questo motivo, ti consigliamo di pianificare la modifica delle versioni durante i periodi di inattività o al di fuori delle ore di punta.
Pubblicare una versione in un nuovo ambiente
Per pubblicare la bozza di un agente in una versione e creare un ambiente personalizzato:
Console
- Vai alla console Dialogflow ES.
- Seleziona l'agente nella parte superiore del menu della barra laterale sinistra.
- Fai clic sul pulsante delle impostazioni settings accanto al nome dell'agente.
- Fai clic sulla scheda Ambienti.
- Fai clic su Pubblica una versione.
- Aggiungi una descrizione facoltativa e fai clic su Avanti.
Seleziona +Nuovo ambiente.
Inserisci un nome per l'ambiente.
Scegli il metodo di evasione degli ordini per l'ambiente.
Seleziona Impostazioni di sintesi vocale per l'ambiente.
Fai clic su Pubblica.
Le informazioni sull'ambiente sono ora elencate nella sezione Ambienti personalizzati.
API
- Chiama il metodo
create
per il Tipo di versione per creare una nuova versione dell'agente. - Chiama il metodo
create
per il Tipo di ambiente per creare un nuovo ambiente. Fornisci la versione dell'agente appena creata nel campoagentVersion
.
Ripristinare una versione precedente di un ambiente
Puoi ripristinare un ambiente a una versione precedente dell'agente:
Console
- Fai clic su un ambiente nella sezione Ambienti personalizzati.
- Si apre la finestra di dialogo delle impostazioni dell'ambiente.
- Fai clic sul pulsante di opzione more_vert per una versione pubblicata in precedenza nella sezione Cronologia di pubblicazione.
- Fai clic su Ripristina questa versione.
- La cronologia di pubblicazione 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
.
Carica una versione precedente come bozza
Il caricamento di una versione precedente come bozza sovrascrive la bozza dell'agente nell'ambiente predefinito con una versione dell'agente selezionata.
Per caricare una versione precedente come bozza:
Console
- Vai alla console Dialogflow ES.
- Seleziona l'agente nella parte superiore del menu della barra laterale sinistra.
- Fai clic sul pulsante delle impostazioni settings accanto al nome dell'agente.
- Fai clic sulla scheda Ambienti.
- Fai clic su Visualizza tutte le versioni nella sezione Bozza.
- Fai clic sul pulsante di opzione more_vert per una versione da caricare come bozza.
- Fai clic su Carica in bozza.
- Fai clic su Sì.
- Ricarica tutte le schede del browser aperte della console, in modo che vengano aggiornate con i dati degli agenti più recenti.
API
Richiama il metodo patch
/update
per il
tipo di ambiente
con i seguenti input:
- Usa
-
come ID ambiente per specificare l'ambiente predefinito. - Imposta
allowLoadToDraftAndDiscardChanges
su true. - Per il campo
agentVersion
, fornisci la versione dell'agente che sovrascriverà la bozza dell'agente.
Esporta una versione
Per esportare una versione, devi prima caricarla come bozza e poi esportare l'agente.
Testa 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 di "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
Il fulfillment e la sintesi vocale sono configurati dall'ambiente, quindi l'agente utilizzerà le impostazioni dell'ambiente per queste funzionalità.
Per ulteriori informazioni su come i dati vengono applicati ai vari livelli, consulta livelli di applicazione degli agenti.
Assistente Google
Se utilizzi ambienti di rilascio di Actions on Google, consulta le limitazioni del controllo delle versioni per la libreria di fulfillment 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