Versioni e ambienti

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

Quando modifichi un agente, stai modificando 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 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

Una bozza dell'agente viene aggiornata ogni volta che uno sviluppatore del tuo team apporta una modifica. È facile interrompere una bozza dell'agente involontariamente, soprattutto se più persone hanno accesso in scrittura all'agente. Inoltre, una bozza dell'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. Le bozze degli agenti devono essere testate prima di essere promosse a versioni di produzione e puoi eseguire il rollback a una versione precedente se vengono rilevati problemi.

Tieni conto dei possibili errori dell'agente durante la modifica delle versioni

Se modifichi una versione dell'agente nell'ambiente di produzione mentre le sessioni sono attive, potrebbero verificarsi errori dell'agente per alcune sessioni attive. Questi errori possono verificarsi se le versioni precedenti e nuove non sono coerenti tra loro in modo da interrompere lo stato della sessione. Per questo motivo, devi pianificare la modifica delle versioni durante i tempi di inattività o le ore non di punta.

Pubblicare una versione in un nuovo ambiente

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

Console

  1. Vai alla console di Dialogflow ES.
  2. Seleziona l'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 Ambienti.
  5. Fai clic su Pubblica una versione.
  6. Aggiungi una descrizione facoltativa e fai clic su Avanti.

  7. Seleziona +Nuovo ambiente.

  8. Inserisci un nome per l'ambiente.

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

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

  11. Fai clic su Pubblica.

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

API

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

Ripristinare una versione precedente di un ambiente

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

Console

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

API

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

Caricare una versione precedente nella bozza

Il caricamento di una versione precedente nella bozza sovrascrive la bozza dell'agente nell'ambiente predefinito con una versione dell'agente selezionata.

Per caricare una versione precedente nella bozza:

Console

  1. Vai alla console di Dialogflow ES.
  2. Seleziona l'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 Ambienti.
  5. Fai clic su Visualizza tutte le versioni nella sezione Bozza.
  6. Fai clic sul pulsante delle opzioni per una versione che vuoi caricare nella bozza.
  7. Fai clic su Carica nella bozza.
  8. Fai clic su Sì, sono sicuro.
  9. Ricarica le schede del browser della console aperte in modo che vengano aggiornate con i dati dell'agente più recenti.

API

Chiama il metodo patch/update per il tipo Environment 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à la bozza dell'agente.

Esportare una versione

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

Testare l'agente in un ambiente

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

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

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

Impostazioni specifiche dell'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 vengono applicati i dati a vari livelli, consulta Livelli di applicazione dell'agente.

Assistente Google

Se utilizzi gli ambienti di rilascio di Actions on Google, consulta le limitazioni di controllo delle versioni per la libreria di fulfillment di 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
Indietro
Agenti predefiniti
Avanti
Agenti multilingue