Versioni e ambienti

Puoi creare più versioni dei flussi, dei playbook e degli strumenti dell'agente ed eseguirne il deployment in ambienti di distribuzione separati.

Quando modifichi un flusso, un playbook o uno strumento, modifichi la bozza. In qualsiasi momento, puoi salvare la bozza come versione. Una versione è uno snapshot immutabile dei dati del flusso, del playbook o dello strumento e dei dati dell'agente associati. Per i flussi, sono inclusi intent, entità, webhook, pagine e gruppi di route. Per i playbook, sono inclusi solo gli esempi.

Quando salvi una bozza, viene eseguito il deployment nell'ambiente predefinito. Quando crei versioni specifiche, puoi eseguirne il deployment in ambienti personalizzati. Puoi creare una serie di ambienti personalizzati, ad esempio:

  • test
  • sviluppo
  • produzione

Inoltre, puoi creare webhook specifici per l'ambiente, in modo da isolare l'ambiente di produzione dagli ambienti di sviluppo e test.

Best practice per il traffico di produzione

Utilizza sempre le versioni per il traffico di produzione

Una bozza viene aggiornata ogni volta che uno sviluppatore del tuo team apporta una modifica. È possibile interrompere una bozza involontariamente, soprattutto se più persone hanno accesso in scrittura all'agente. Inoltre, una bozza modificata di recente potrebbe non essere coerente con il modello addestrato, perché l'addestramento potrebbe subire un ritardo o richiedere l'esecuzione manuale.

Devi sempre utilizzare le versioni per il traffico di produzione. Le risorse in bozza devono essere testate prima di essere promosse alle versioni di produzione e puoi eseguire il rollback a una versione precedente se vengono rilevati problemi.

Utilizza sempre webhook specifici per l'ambiente

Quando aggiorni l'agente, spesso devi apportare aggiornamenti interdipendenti al codice del webhook. Durante lo sviluppo e il test di queste modifiche, vuoi che:

  • Per testare gli aggiornamenti dell'agente rispetto agli aggiornamenti del codice del webhook.
  • Per evitare di eseguire il deployment del codice del webhook in produzione prima di aver completato i test.

L'utilizzo di webhook specifici per l'ambiente consente di raggiungere entrambi gli obiettivi.

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

Se modifichi una versione 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 precedente e nuova non sono coerenti tra loro in modo da interrompere lo stato della sessione. Per questo motivo, ti consigliamo di pianificare il cambio di versione durante i tempi di inattività o le ore non di punta.

Carica una versione nella bozza

In qualsiasi momento, puoi caricare una versione in bozza, in modo che sia modificabile e utilizzata dall'ambiente predefinito.

Il caricamento di una versione del flusso in bozza può aggiornare più risorse in un agente, incluse le risorse a livello di agente come intent ed entità. Quando carichi una versione in bozza con la console o l'API, puoi scegliere se sovrascrivere le risorse a livello di agente.

Analogamente, il ripristino di una versione del playbook in bozza sovrascriverà il playbook esistente in bozza e i relativi esempi. Il ripristino di uno strumento sovrascriverà lo strumento esistente nella bozza.

Gestisci versioni

Per gestire le versioni:

Console

Per elencare le versioni correnti di un flusso:

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud .
  3. Seleziona l'agente.
  4. Fai clic sulla scheda Risorse condivise.
  5. Fai clic su Versioni.
  6. Vengono elencati i flussi dell'agente. Seleziona un'opzione.
  7. Le versioni sono elencate per il flusso selezionato.

Per elencare le versioni attuali di un playbook:

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud .
  3. Seleziona l'agente.
  4. Seleziona il playbook
  5. Fai clic su Cronologia delle versioni.
  6. Fai clic su Visualizza la cronologia delle versioni.
  7. Le versioni sono elencate per il playbook selezionato.

Per elencare le versioni correnti di uno strumento:

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud .
  3. Seleziona l'agente.
  4. Seleziona lo strumento
  5. Fai clic su Cronologia delle versioni.
  6. Fai clic su Visualizza cronologia delle versioni.
  7. Le versioni sono elencate per lo strumento selezionato.

Per ogni risorsa vengono visualizzate le seguenti informazioni:

  • Nome visualizzato: il nome visualizzato della versione.
  • ID versione: l'ID della versione.
  • Tipo di NLU: il tipo di NLU per la versione del flusso.
  • Timestamp di creazione: la data e l'ora di creazione della versione.
  • Stato: lo stato dell'addestramento. Una versione del flusso non è pronta per l'uso finché lo stato non viene contrassegnato come Pronto.

Per creare una nuova versione, fai clic sul pulsante Crea e fornisci il Nome visualizzato e la Descrizione della versione.

Per caricare una versione specifica del flusso come bozza:

  1. Tieni il puntatore sopra una riga della versione.
  2. Fai clic sul pulsante .
  3. Fai clic sull'opzione Carica nella bozza.
  4. Durante il caricamento, è disponibile un'opzione per sovrascrivere i dati a livello di agente.

Per eliminare una versione specifica del flusso:

  1. Tieni il puntatore sopra una riga della versione.
  2. Fai clic sul pulsante .
  3. Fai clic sull'opzione Elimina versione.

API

Consulta i metodi per il tipo Version.

Seleziona un protocollo e una versione per il riferimento alla versione:

Protocollo V3 V3beta1
REST Risorsa Version Risorsa Version
RPC Interfaccia Version Interfaccia Version
C++ VersionsClient Non disponibile
C# VersionsClient Non disponibile
Vai VersionsClient Non disponibile
Java VersionsClient VersionsClient
Node.js VersionsClient VersionsClient
PHP Non disponibile Non disponibile
Python VersionsClient VersionsClient
Ruby Non disponibile Non disponibile

Confronta le versioni del flusso

Dopo aver creato le versioni del flusso, puoi utilizzare lo strumento Confronta versioni per visualizzare un confronto fianco a fianco tra le versioni del flusso o la versione bozza. Questa funzionalità non è disponibile per i playbook. Per confrontare le versioni:

Console

  1. Tieni il puntatore sopra una riga della versione.
  2. Fai clic sul pulsante .
  3. Fai clic sull'opzione Confronta versioni.
  4. Seleziona un'altra versione del flusso o una bozza del flusso per il confronto.
  5. Viene mostrato un confronto fianco a fianco.

API

Consulta il metodo compareVersions per il tipo Version.

Seleziona un protocollo e una versione per il riferimento alla versione:

Protocollo V3 V3beta1
REST Risorsa Version Risorsa Version
RPC Interfaccia Version Interfaccia Version
C++ VersionsClient Non disponibile
C# VersionsClient Non disponibile
Vai VersionsClient Non disponibile
Java VersionsClient VersionsClient
Node.js VersionsClient VersionsClient
PHP Non disponibile Non disponibile
Python VersionsClient VersionsClient
Ruby Non disponibile Non disponibile

Gestisci gli ambienti

Per gestire gli ambienti degli agenti:

Console

Per elencare gli ambienti attuali di un agente:

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud .
  3. Seleziona l'agente.
  4. Fai clic sulla scheda Risorse condivise.
  5. Fai clic su Ambienti.
  6. Vengono elencati gli ambienti dell'agente.

Per creare un nuovo ambiente, fai clic sul pulsante Crea e fornisci le informazioni.

Per selezionare le versioni di flussi, playbook e strumenti e configurare un ambiente, fai clic su un ambiente e fornisci le informazioni.

Per visualizzare la cronologia delle modifiche di un ambiente, fai clic sul pulsante della cronologia sul lato destro di un ambiente nell'elenco.

Per copiare il nome di una risorsa dell'ambiente che include l'ID ambiente, fai clic sul pulsante di copia vicino al lato destro di un ambiente nell'elenco.

Per eliminare un ambiente, fai clic sul pulsante Elimina vicino al lato destro di un ambiente nell'elenco.

API

Consulta i metodi per il tipo Environment.

Seleziona un protocollo e una versione per il riferimento all'ambiente:

Protocollo V3 V3beta1
REST Risorsa Environment Risorsa Environment
RPC Interfaccia dell'ambiente Interfaccia dell'ambiente
C++ EnvironmentsClient Non disponibile
C# EnvironmentsClient Non disponibile
Vai EnvironmentsClient Non disponibile
Java EnvironmentsClient EnvironmentsClient
Node.js EnvironmentsClient EnvironmentsClient
PHP Non disponibile Non disponibile
Python EnvironmentsClient EnvironmentsClient
Ruby Non disponibile Non disponibile

Specifica l'ambiente per le chiamate di sessione

Utilizzando il simulatore della console o l'API, puoi specificare un ambiente quando effettui chiamate di sessione di runtime. Se non viene specificato un ambiente, viene utilizzato l'ambiente predefinito.

Console

Quando utilizzi il simulatore della console, seleziona l'opzione Testa l'agente nell'ambiente, quindi seleziona un ambiente.

API

Per specificare un ambiente per le chiamate REST di detectIntent, streamingDetectIntent, matchIntent ed entità di sessione, modifica l'URL inserendo environments/environment-id tra i parametri di percorso agent e sessions.

Ad esempio, il seguente URL utilizza l'ID ambiente 6db409d7-57ac-41d7-83bd-89b8768e2745:

https://dialogflow.googleapis.com/v3/projects/my-project-id/locations/us/agents/my-agent-id/environments/6db409d7-57ac-41d7-83bd-89b8768e2745/sessions/my-session-id:detectIntent

Specifica le versioni del flusso per le chiamate di sessione

Utilizzando il simulatore della console o l'API, puoi specificare un insieme di versioni del flusso quando effettui chiamate di sessione di runtime. Le versioni del flusso selezionate non devono necessariamente essere richiamate in un ambiente.

Console

Quando utilizzi il simulatore della console, seleziona l'opzione Testa l'agente con versioni di flusso specifiche, quindi seleziona le versioni di flusso.

API

Per specificare le versioni del flusso per le chiamate REST detectIntent, streamingDetectIntent, matchIntent ed entità di sessione, fornisci le versioni del flusso scelte nel campo query_parameters.flow_versions della richiesta.

Indietro
Utilizzo di più progetti
Avanti
Livelli di applicazione dei dati