Versioni e ambienti

Puoi creare più versioni dei flussi di agenti e dei playbook (noti anche come agenti Vertex AI) e eseguirne il deployment in ambienti di pubblicazione separati.

Quando modifichi un flusso o un playbook, modifichi la bozza. Puoi salvare la bozza come versione in qualsiasi momento. Una versione è un'istantanea immutabile dei dati del flusso o del playbook e dei dati degli agenti 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 la distribuzione 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, poiché l'addestramento potrebbe avere un ritardo o richiedere l'esecuzione manuale.

Devi sempre utilizzare le versioni per il traffico di produzione. Le risorse di 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 hai aggiornamenti interdipendenti al codice webhook. Durante lo sviluppo e il test di queste modifiche, devi:

  • Per testare gli aggiornamenti dell'agente rispetto agli aggiornamenti del codice webhook.
  • Per evitare di eseguire il deployment del codice webhook in produzione fino al completamento dei test.

L'utilizzo di webhook specifici per l'ambiente consente di raggiungere entrambi questi 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, potresti 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, è consigliabile pianificare la modifica delle versioni durante il tempo di riposo o le ore di punta.

Caricare una versione in bozza

In qualsiasi momento, puoi caricare una versione come 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 da mettere in bozza con la console o l'API, puoi scegliere se le risorse a livello di agente devono essere sovrascritte.

Analogamente, il ripristino di una versione di un playbook in bozza sovrascriverà il playbook esistente in bozza e i relativi esempi.

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 il tuo agente.
  4. Fai clic sulla scheda Risorse condivise.
  5. Fai clic su Versioni.
  6. Vengono elencati i flussi dell'agente. Selezionane una.
  7. Le versioni sono elencate per il flusso selezionato.

Per elencare le versioni correnti di un playbook:

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo 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 ogni risorsa 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 del flusso.
  • Timestamp della 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 è 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 dell'opzione .
  3. Fai clic sull'opzione Carica nella bozza.
  4. È disponibile 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 dell'opzione .
  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 della versione Interfaccia della versione
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

Confrontare le versioni del flusso

Dopo aver creato le versioni del flusso, puoi utilizzare lo strumento Confronta versioni per visualizzare un confronto affiancato tra le versioni del flusso o la versione di 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 dell'opzione .
  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 affiancato.

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 della versione Interfaccia della versione
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 il tuo 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 flusso e playbook 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 vicino al 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 di eliminazione 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
Vai EnvironmentsClient Non disponibile
Java EnvironmentsClient EnvironmentsClient
Node.js EnvironmentsClient EnvironmentsClient
PHP Non disponibile Non disponibile
Python EnvironmentsClient EnvironmentsClient
Ruby Non disponibile Non disponibile

Specificare l'ambiente per le chiamate di sessione

Utilizzando il simulatore della console o l'API, puoi specificare un ambiente quando effettui chiamate alla sessione di runtime. Se non viene specificato un ambiente, viene utilizzato quello 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 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 alla sessione di runtime. Non è necessario fare necessariamente riferimento alle versioni dei flussi selezionate in nessun ambiente.

Console

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

API

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

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