Versioni e ambienti

Puoi creare più versioni dei flussi, dei playbook e degli strumenti dell'agente e implementarle in ambienti di pubblicazione separati.

Quando modifichi un flusso, un playbook o uno strumento, stai modificando la bozza. In qualsiasi momento, puoi salvare la bozza come versione. Una versione è un'istantanea 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 esempi.

Quando salvi una bozza, viene eseguita 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 ritardi o richiedere l'esecuzione manuale.

Devi sempre utilizzare le versioni per il traffico di produzione. Le risorse 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 apporti aggiornamenti all'agente, spesso devi apportare aggiornamenti interdipendenti al codice webhook. Durante lo sviluppo e il test di queste modifiche, vuoi quanto segue:

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

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

Considera i possibili errori dell'agente durante il cambio di versione

Se modifichi una versione nell'ambiente di produzione mentre le sessioni sono attive, potrebbe causare 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, devi pianificare il cambio di versione durante i tempi di inattività o le ore non di punta.

Caricare una versione come 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 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.

Allo stesso modo, il ripristino di una versione del playbook come 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 attuali 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 cronologia delle versioni.
  7. Le versioni sono elencate per il playbook selezionato.

Per elencare le versioni attuali 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 in cui è stata creata la 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 come bozza.
  4. Viene fornita un'opzione per sovrascrivere i dati a livello di agente durante il caricamento.

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 versione Risorsa versione
RPC Interfaccia delle versioni Interfaccia delle versioni
C++ VersionsClient Non disponibile
C# VersionsClient Non disponibile
Go VersionsClient Non disponibile
Java VersionsClient VersionsClient
Node.js VersionsClient VersionsClient
PHP Non disponibile Non disponibile
Python VersionsClient VersionsClient
Ruby Non disponibile Non disponibile

Confrontare 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 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 un flusso bozza 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 versione Risorsa versione
RPC Interfaccia delle versioni Interfaccia delle versioni
C++ VersionsClient Non disponibile
C# VersionsClient Non disponibile
Go 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 per 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 Ambientazioni.
  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 flusso, 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 Cronologia vicino al lato destro di un ambiente nell'elenco.

Per copiare il nome di una risorsa 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 ambiente Risorsa ambiente
RPC Interfaccia dell'ambiente Interfaccia dell'ambiente
C++ EnvironmentsClient Non disponibile
C# EnvironmentsClient Non disponibile
Go 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, poi seleziona un ambiente.

API

Per specificare un ambiente per le chiamate REST di detectIntent, streamingDetectIntent, matchIntent e delle 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. Non è necessario fare riferimento alle versioni del flusso selezionate in alcun ambiente.

Console

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

API

Per specificare le versioni del flusso per detectIntent, streamingDetectIntent, matchIntent e le chiamate REST delle 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