Versioni e ambienti

Puoi creare più versioni dei flussi agente ed eseguirne il deployment in ambienti di servizio separati.

Quando modifichi un flusso, stai modificando una bozza di flusso. Puoi salvare una bozza del flusso come versione del flusso in qualsiasi momento. Una versione del flusso è un'istantanea immutabile dei dati del flusso e dei dati degli agenti associati come intent, entità, webhook, pagine, gruppi di route e così via.

Quando salvi una bozza del flusso, ne viene eseguito il deployment nell'ambiente predefinito. Quando crei versioni specifiche del flusso, puoi eseguirne il deployment in ambienti personalizzati. Puoi creare una varietà di ambienti personalizzati per:

  • test
  • sviluppo
  • produzione
  • E così via

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

Best practice per il traffico di produzione

Usa sempre le versioni di flusso per il traffico di produzione

Ogni volta che uno sviluppatore del tuo team apporta una modifica, viene aggiornato un flusso di bozza. È facile interrompere involontariamente un flusso di bozza, soprattutto se più persone hanno accesso in scrittura all'agente. Inoltre, un flusso di bozza modificato di recente potrebbe essere incoerente con il modello addestrato, perché l'addestramento potrebbe presentare un ritardo o richiedere l'esecuzione manuale.

Devi sempre utilizzare versioni di flusso per il traffico di produzione. I flussi in bozza devono essere testati prima di promuoverli alle versioni di produzione e puoi eseguire il rollback a una versione precedente in caso di problemi.

Utilizza sempre webhook specifici dell'ambiente

Quando aggiorni l'agente, spesso hai 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 il deployment del codice webhook in produzione fino a quando non hai completato il test.

L'utilizzo di webhook specifici dell'ambiente consente di entrambi questi obiettivi.

Valuta i possibili errori dell'agente durante il cambio delle versioni

Se modifichi una versione del flusso nell'ambiente di produzione mentre le sessioni sono attive, potrebbero verificarsi errori dell'agente per alcune sessioni attive. Questi errori possono verificarsi se la nuova versione e la precedente sono incoerenti tra loro e questo interrompe lo stato della sessione. Per questo motivo, ti consigliamo di cambiare le versioni durante i tempi di inattività o al di fuori delle ore di punta.

Carica una versione del flusso come bozza

In qualsiasi momento puoi caricare una versione del flusso come bozza, quindi è modificabile e utilizzata dall'ambiente predefinito.

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

Gestisci versioni flusso

Per gestire le versioni del flusso:

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 Gestisci.
  5. Fai clic su Versioni.
  6. I flussi dell'agente sono elencati. Seleziona un'opzione.
  7. Le versioni sono elencate per il flusso selezionato.

Per ogni flusso vengono visualizzate le seguenti informazioni:

  • Nome visualizzato: il nome visualizzato della versione.
  • ID versione: l'ID della versione.
  • Tipo NLU: il tipo NLU per la versione flusso.
  • Timestamp creazione: la data e l'ora in cui è stata creata la versione.
  • Stato: lo stato dell'addestramento. Una versione del flusso non è pronta per essere utilizzata finché lo stato non viene contrassegnato come Pronta.

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

Per caricare una versione specifica del flusso come flusso di bozza:

  1. Tieni il puntatore sopra la riga di una versione.
  2. Fai clic sul pulsante di opzione .
  3. Fai clic sull'opzione Carica in 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 la riga di una versione.
  2. Fai clic sul pulsante di opzione .
  3. Fai clic sull'opzione Elimina versione.

API

Vedi i metodi per il tipo Version.

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

Protocollo V3 V3beta1
REST Risorsa della versione Risorsa della versione
RPC Interfaccia della versione Interfaccia della versione
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

Confronta le versioni del flusso

Una volta create le versioni del flusso, puoi utilizzare lo strumento Confronta versioni per confrontare le versioni dei flussi con quelle di bozza. Per confrontare le versioni:

Console

  1. Tieni il puntatore sopra la riga di una versione.
  2. Fai clic sul pulsante di opzione .
  3. Fai clic sull'opzione Confronta le versioni.
  4. Seleziona un'altra versione del flusso o un'altra bozza di flusso per il confronto.
  5. Viene visualizzato un confronto affiancato.

API

Visualizza il metodo compareVersions per il tipo Version.

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

Protocollo V3 V3beta1
REST Risorsa della versione Risorsa della versione
RPC Interfaccia della versione Interfaccia della versione
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 Gestisci.
  5. Fai clic su Ambienti.
  6. Gli ambienti agente sono elencati.

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

Per selezionare le versioni del flusso e configurare un ambiente, fai clic su un ambiente e fornisci le informazioni necessarie.

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

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

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

API

Vedi i metodi per il tipo Environment.

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

Protocollo V3 V3beta1
REST Risorsa di ambiente Risorsa di 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 alle sessioni

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

Console

Quando utilizzi il simulatore della console, seleziona l'opzione Agente di test nell'ambiente, quindi seleziona un ambiente.

API

Per specificare un ambiente per le chiamate REST 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 dei flussi per le chiamate di sessione

Utilizzando il simulatore della console o l'API, puoi specificare un insieme di versioni di flusso quando effettui chiamate a sessioni di runtime. Non è necessario fare riferimento alle versioni del flusso selezionate in nessun 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 di flusso per le chiamate REST detectIntent, streamingDetectIntent, matchIntent e delle entità di sessione, fornisci le versioni di flusso scelte nel campo query_parameters.flow_versions della richiesta.

Indietro
Utilizzo di più progetti
Avanti
Livelli di applicazione dati