Versioni e ambienti

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

Quando modifichi un agente, Stai modificando l'agente in versione bozza. Puoi salvare in qualsiasi momento l'agente bozza come versione agente, ovvero un'istantanea immutabile dell'agente.

Quando salvi la bozza dell'agente, viene pubblicata nell'ambiente predefinito. Quando crei versioni degli agenti, puoi pubblicarli in ambienti personalizzati. Puoi creare una serie 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 di bozza, 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, perché l'addestramento potrebbe subire un ritardo o richiedere l'esecuzione manuale.

Devi utilizzare sempre le versioni dell'agente per il traffico di produzione. Gli agenti in versione bozza devono essere testati prima di promuoverli nelle versioni di produzione e potrai tornare a una versione precedente se vengono rilevati problemi.

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

Modificando la versione di un agente nell'ambiente di produzione mentre le sessioni sono attive, questo potrebbe causare errori dell'agente per alcune sessioni attive. Questi errori possono verificarsi se la versione precedente e quella nuova non sono coerenti tra loro in modo da interrompere lo stato della sessione. Per questo motivo, dovresti pianificare di cambiare versione tempi di inattività o al di fuori delle ore di punta.

Pubblica una versione in un nuovo ambiente

Per pubblicare la bozza di un agente in una versione: e creerai 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 completamento 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 Tipo di versione per creare una nuova versione dell'agente.
  2. Chiama il metodo create per 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 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 Tipo di ambiente per aggiornare un ambiente. Fornisci al campo agentVersion la versione dell'agente che hai creato in precedenza.

Carica una versione precedente come bozza

Caricamento di una versione precedente come bozza in corso... 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ì, confermo.
  9. Ricarica tutte le schede del browser della console aperte, in modo che vengano aggiornati con i dati degli agenti più recenti.

API

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

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

Esporta una versione

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

Testa l'agente in un ambiente

Puoi utilizzare l'API per testare l'agente in qualsiasi ambiente personalizzato. Chiama il rileva intent ma modificare l'URL dell'endpoint inserendo environments/environment-name/users/-/ tra le ore agent e le ore sessions.

Ad esempio, il seguente endpoint utilizza la classe "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, in modo che l'agente utilizzi le impostazioni dell'ambiente per queste funzionalità.

Per ulteriori informazioni su come i dati vengono applicati ai vari livelli, vedi livelli di applicazione degli agenti.

Assistente Google

Se utilizzi Ambienti di rilascio di Actions on Google vedi i limiti del controllo delle versioni Libreria di completamento 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