Versioni e ambienti

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

  1. Vai alla console 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 evasione degli ordini per l'ambiente.

  10. Seleziona 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 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 una versione precedente di un ambiente

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

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 di opzione per una versione pubblicata in precedenza nella sezione Cronologia di pubblicazione.
  4. Fai clic su Ripristina questa versione.
  5. 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

  1. Vai alla console 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 di opzione per una versione da caricare come bozza.
  7. Fai clic su Carica in bozza.
  8. Fai clic su Sì.
  9. 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
Indietro
Agenti predefiniti
Avanti
Agenti multilingue