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 distribuita 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, prendi in considerazione di cambiare le 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 come 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:
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Fai clic sulla scheda Risorse condivise.
- Fai clic su Versioni.
- Vengono elencati i flussi dell'agente. Selezionane una.
- Le versioni sono elencate per il flusso selezionato.
Per elencare le versioni correnti di un playbook:
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona il playbook
- Fai clic su Cronologia delle versioni.
- Fai clic su Visualizza la cronologia delle versioni.
- 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 flusso di bozza:
- Tieni il puntatore sopra una riga della versione.
- Fai clic sul pulsante dell'opzione more_vert.
- Fai clic sull'opzione Carica nella bozza.
- È disponibile un'opzione per sovrascrivere i dati a livello di agente durante il caricamento.
Per eliminare una versione specifica del flusso:
- Tieni il puntatore sopra una riga della versione.
- Fai clic sul pulsante dell'opzione more_vert.
- 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
- Tieni il puntatore sopra una riga della versione.
- Fai clic sul pulsante dell'opzione more_vert.
- Fai clic sull'opzione Confronta versioni.
- Seleziona un'altra versione del flusso o una bozza del flusso per il confronto.
- 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 dell'agente:
Console
Per elencare gli ambienti attuali di un agente:
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Fai clic sulla scheda Risorse condivise.
- Fai clic su Ambienti.
- 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 history 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 content_copy vicino al lato destro di un ambiente nell'elenco.
Per eliminare un ambiente, fai clic sul pulsante di eliminazione delete 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 del flusso per le chiamate REST detectIntent, streamingDetectIntent,
matchIntent e delle entità sessione, fornisci le versioni del flusso scelte nel campo query_parameters.flow_versions
della richiesta.